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 分