Stone Vendas

io.github.mcp-dir由 GitHub 账号 mcp-dir 发布v0.1.1更新于 Nov 2, 2026

Stone acquirer (card machine) sales via the Conciliação API, read-only. Lists transactions for a per

已验证Streamable HTTP可网页运行金融数据与分析商业与电商

概览

AI 生成的概览

以只读方式访问 Stone 收单(刷卡机)销售数据:交易明细、汇总、退单、应收、结算与 Pix,可按期间查询。

可以做什么
  • 列出本安装中已连接的 Stone 商户(StoneCode)及其 id 与别名
  • 按期间列出已捕获交易,含日期时间、毛额与净额、支付方式、卡组织、捕获类型、分期与状态
  • 获取按支付方式、卡组织、日期、状态、捕获类型或终端分组的汇总合计
  • 查询取消、退单与退单再提交,以及应收日程和已入账结算
  • 查询刷卡机 Pix 销售,并获取单日完整对账文件(已由 XML 转为 JSON)
  • 强制 Stone 重新生成某期间的对账文件,并查看平台版本、连接状态、工具包状态与市场目录
适用场景
适合让助手回答关于 Stone 刷卡机销售的问题,例如按支付方式看月度汇总、按卡组织看销售、预计应收、退单或 Pix 金额,无需手工导出报表。由于是只读,适合报表与对账,而不是修改账户数据。
运行要求
远程 HTTP MCP 端点,无需本地安装包。认证使用账户持有人在 Stone 门户的认证密钥中创建的密钥,每个 StoneCode 为单独连接。需要支持 MCP over HTTP 的客户端(Claude、ChatGPT、Cursor、VS Code 等)。
安装前请注意
Stone 认证密钥是访问账户销售数据的凭据。返回的数据(含截断卡号与 Pix 付款人信息)会发送给你所选的 LLM 托管方,README 将其列为不受提供方控制的次级处理者。清除缓存工具会丢弃 Stone 缓存的对账报表并消耗同样的请求配额。价格另行说明,使用前请先确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Stone Vendas,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.mcp-dir%2Fstone_vendas-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "stone-vendas": {
      "type": "http",
      "url": "https://api.mcp.ai/p_stone_vendas"
    }
  }
}

README

Stone Vendas

Stone Vendas for Claude, ChatGPT and AI agents

Stone acquirer (card machine) sales via the Conciliação API, read-only. Lists transactions for a period with date and time, gross and net amounts, payment method, card brand, capture type, installments and status, and consolidates totals by payment method, brand or day. Also covers cancellations, chargebacks, the receivables schedule and the settlements deposited into the account. Each StoneCode is one connection, and the same key works for every StoneCode under the same tax id. Auth uses the key the account holder creates in the Stone portal, under authentication keys. Complements Stone Pagamentos, which reads the bank account through Open Finance.

  • 📊 9 tools
  • 🔒 Read-only
  • 💬 Works with any MCP client: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Magic-link login (no password)

Versão em português · Full docs (PT-BR) · Agent skill


One-click install

Claude (Web and Desktop)

Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):

➕ Open in Claude and connect

Manual (if the deeplink does not open): claude.ai/customize/connectors → + → Add custom connector → paste Name Stone Vendas and URL https://api.mcp.ai/p_stone_vendas.

Cursor

➕ Install Stone Vendas in Cursor

VS Code (Copilot Chat)

➕ Install Stone Vendas in VS Code

ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks MCP over HTTP. The server URL is always:

https://api.mcp.ai/p_stone_vendas

Per-client details: INSTALL.md.


Example prompts

What was the Stone sales summary last month by payment method?List last week's Stone sales by card brandHow much am I due to receive from Stone in the coming days?Were there any chargebacks or cancellations on Stone this month?How much came in through Pix on the Stone card machine last week?

9 tools available

ToolDescription
stone_vendas_contasLista os StoneCodes (estabelecimentos) Stone conectados neste install, com id e apelido.
stone_vendas_listarLista as vendas do adquirente Stone no período, uma linha por transação capturada, com data e hora, valor bruto e líquido, forma de pagamento (crédito, débito, pré-pago, voucher, boleto), bandeira, cartão truncado, ti…
stone_vendas_resumoTotais consolidados das vendas Stone no período, o equivalente ao Resumo de vendas do painel.
stone_vendas_cancelamentosCancelamentos, chargebacks e reapresentações de chargeback da conta Stone no período, com o NSU da venda de origem, valor, datas e motivo.
stone_vendas_recebiveisAgenda de recebíveis Stone: as parcelas ainda não pagas com a data prevista de pagamento, detalhadas e totalizadas por data.
stone_vendas_liquidacoesLiquidações da Stone no período, o que foi efetivamente depositado, com valor total e a conta bancária favorecida.
stone_vendas_pixVendas por Pix na maquininha Stone no período, com data e hora, valor, taxa, status (paga ou cancelada), terminal, chave Pix, e2e id e dados do pagador.
stone_vendas_limpar_cacheForça a Stone a regerar o arquivo de conciliação do período, descartando o extrato que ela mantém em cache.
stone_vendas_arquivoArquivo de conciliação completo de um único dia, já convertido de XML para JSON, com todos os blocos (vendas, liquidações na conta, agenda prevista, eventos financeiros, pagamentos e posição de carteira).

Details for each tool: docs/ferramentas.md (PT-BR)


Pricing

See docs/precos.md (PT-BR).


Privacy & data protection

  • Read-only, no tool changes data at the source.
  • Sub-processors: Stone, the LLM host you choose (Claude, ChatGPT, Cursor, your own agent). Full list in docs/privacidade-lgpd.md.
  • Data returned by the tools is sent to the LLM host you choose, a sub-processor outside our control. We recommend plans with training opt-out.

FAQ

Is the server open source? The server is proprietary (hosted). This repository is the public wrapper with manifests, docs and skills, all MIT.

Can I use it with my own agent (not Claude/Cursor)? Yes, any client that speaks MCP over HTTP. URL: https://api.mcp.ai/p_stone_vendas.


Support


License

MIT — see LICENSE. The MCP server at api.mcp.ai/p_stone_vendas is proprietary (hosted); this repo (manifests, docs, skills) is MIT.

来源:README.md,提交 45ea1b4

工具

15

stone_vendas_contas

Lista os StoneCodes (estabelecimentos) Stone conectados neste install, com id e apelido.

输入参数account

stone_vendas_listar

Lista as vendas do adquirente Stone no período, uma linha por transação capturada, com data e hora, valor bruto e líquido, forma de pagamento (crédito, débito, pré-pago, voucher, boleto), bandeira, cartão truncado, tipo de captura (POS, e-commerce, TEF), parcelas e status (aprovada, cancelada, contestada, liquidada). A Stone fecha um arquivo por dia e o do dia só fica pronto depois das 5h do dia seguinte, então o padrão vai até ontem. Máximo de 92 dias por chamada.

输入参数limitestatusaccountbandeiradata_fimdata_inicioforma_pagamento

stone_vendas_resumo

Totais consolidados das vendas Stone no período, o equivalente ao Resumo de vendas do painel. Agrupa por forma de pagamento, bandeira, dia, status, tipo de captura ou terminal, e devolve quantidade, valor bruto, valor líquido, cancelado e chargebacks de cada grupo. Inclui crédito, débito, pré-pago, voucher, boleto e também o Pix na maquininha. A Stone fecha um arquivo por dia e o do dia só fica pronto depois das 5h do dia seguinte, então o padrão vai até ontem. Máximo de 92 dias por chamada.

输入参数accountdata_fimagrupar_pordata_inicioincluir_pix

stone_vendas_cancelamentos

Cancelamentos, chargebacks e reapresentações de chargeback da conta Stone no período, com o NSU da venda de origem, valor, datas e motivo. A Stone fecha um arquivo por dia e o do dia só fica pronto depois das 5h do dia seguinte, então o padrão vai até ontem. Máximo de 92 dias por chamada.

输入参数accountdata_fimdata_inicio

stone_vendas_recebiveis

Agenda de recebíveis Stone: as parcelas ainda não pagas com a data prevista de pagamento, detalhadas e totalizadas por data. A Stone fecha um arquivo por dia e o do dia só fica pronto depois das 5h do dia seguinte, então o padrão vai até ontem. Máximo de 92 dias por chamada.

输入参数accountdata_fimdata_inicio

stone_vendas_liquidacoes

Liquidações da Stone no período, o que foi efetivamente depositado, com valor total e a conta bancária favorecida. É a ponta que fecha com o extrato bancário. A Stone fecha um arquivo por dia e o do dia só fica pronto depois das 5h do dia seguinte, então o padrão vai até ontem. Máximo de 92 dias por chamada.

输入参数accountdata_fimdata_inicio

stone_vendas_pix

Vendas por Pix na maquininha Stone no período, com data e hora, valor, taxa, status (paga ou cancelada), terminal, chave Pix, e2e id e dados do pagador. A Stone entrega o Pix num arquivo separado e assíncrono, por CNPJ, então esta tool pede os arquivos que faltam e devolve os que já ficaram prontos, listando em dias_pendentes o que ainda está processando (pode levar até 30 minutos). Se houver dias pendentes, chame de novo mais tarde para completar o período. Exige o campo Documento preenchido na conexão. Máximo de 31 dias por chamada.

输入参数limitestatusaccountdata_fimdata_inicioapenas_maquininha

stone_vendas_limpar_cache

Força a Stone a regerar o arquivo de conciliação do período, descartando o extrato que ela mantém em cache. Use quando os números não baterem com o painel da Stone. Não altera nada da conta, não move dinheiro e não mexe em venda, só descarta o cache de um relatório. Consome a mesma cota de 7 requisições por hora por dia, então não repita em sequência.

输入参数accountdata_fimdata_inicio

stone_vendas_arquivo

Arquivo de conciliação completo de um único dia, já convertido de XML para JSON, com todos os blocos (vendas, liquidações na conta, agenda prevista, eventos financeiros, pagamentos e posição de carteira). Use quando as tools de período não cobrirem o campo que você precisa.

输入参数data必填account

show_version

Show Version

Show the current MCP platform and adapter versions.

无需输入参数。

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

输入参数contextmessage必填conversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

无需输入参数。

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

无需输入参数。

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

输入参数limitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool另有 11 个

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

输入参数token

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分