Mcp Stone

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for Stone — open banking, payments, Pix, transfers

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

面向 Stone 開放銀行的本機 MCP 伺服器，讓助理查詢餘額、發起轉帳與收款、刷卡與 Pix 付款，並管理應收帳款和終端機。

可以做什麼
讀取帳戶資料：餘額、交易、對帳單、付款、應收帳款、終端機與 webhook，支援篩選和狀態查詢。建立付款、銀行轉帳、對外 Pix 付款、Pix 收款、boleto 帳單和信用卡收款。將信用卡令牌化以便後續扣款。對已結算交易退款，取消已授權但尚未請款的交易。申請應收帳款提前結算並查詢提前結算額度。註冊並列出 Stone 事件的 webhook 端點。
適用情境
適合讓助理操作巴西的 Stone 商家帳戶：查看餘額與對帳單、發起或退款付款、開立 Pix 或 boleto 收款，以及處理應收帳款和 POS 終端機。建議先在 Stone 沙箱環境試用，再改用正式憑證。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-stone 在本機執行，需要 Node.js。需要 Stone OAuth2 憑證：STONE_CLIENT_ID 和 STONE_CLIENT_SECRET，須註冊開發者並建立應用程式取得。可選 STONE_BASE_URL 和 STONE_AUTH_URL 覆寫 API 與權杖位址以連接沙箱。需要連線至 Stone API 的網路。
安裝前請注意
這些憑證可存取真實金融帳戶並調動資金：轉帳、Pix 付款、信用卡收款、退款、取消和提前結算都會實際呼叫 Stone API。請將密鑰放在環境變數中，測試時優先使用沙箱憑證。註冊 webhook 會變更帳戶設定。README 指出 0.2.2 及更早版本使用了不存在的權杖主機，導致所有工具在驗證階段失敗。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Stone，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-stone

MCP server for Stone — acquiring (card / Pix / boleto), anticipations, receivables, terminals, and open banking

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "stone": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stone"],      "env": {        "STONE_CLIENT_ID": "your-client-id",        "STONE_CLIENT_SECRET": "your-client-secret"      }    }  }}

Claude Code

bash
claude mcp add stone -- npx @codespar/mcp-stone

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "stone": {      "command": "npx",      "args": ["-y", "@codespar/mcp-stone"],      "env": {        "STONE_CLIENT_ID": "your-client-id",        "STONE_CLIENT_SECRET": "your-client-secret"      }    }  }}

Tools (21)

ToolPurpose
get_balanceGet account balance
list_transactionsList account transactions
get_statementGet account statement for a period
create_paymentCreate a payment via Stone
get_paymentGet payment details by ID
list_paymentsList payments with optional filters
create_transferCreate a bank transfer (internal or external)
create_pix_paymentCreate a Pix payment (outbound) via Stone
create_pix_chargeCreate a Pix charge (QR Code / cob) to receive a payment
create_boletoCreate a boleto bancário for charging a customer
create_card_chargeCharge a credit or debit card (Stone acquiring)
tokenize_cardTokenize a card to PCI-safe token for later charging
refund_transactionRefund a settled transaction (full or partial)
cancel_transactionCancel an authorized (not-yet-captured) transaction
create_anticipationAnticipate future receivables (Stone's flagship 'antecipação')
get_anticipation_limitsGet current anticipation limits (max / min / available) for a merchant
list_receivablesSearch receivables (future credits from card transactions)
list_terminalsList physical Stone / TON terminals for a merchant
get_terminal_statusGet current status of a specific POS terminal (online / offline / last seen)
register_webhookRegister a webhook endpoint for Stone events
list_webhooksList registered webhook endpoints

Authentication

Stone uses OAuth2 client credentials for authentication. The server automatically manages token refresh.

Sandbox / Testing

Stone provides a sandbox via the developer portal.

Get your credentials

  1. Go to Stone Open Bank Documentation
  2. Register as a developer
  3. Create an application to get OAuth2 credentials
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
STONE_CLIENT_IDYesOAuth2 client ID
STONE_CLIENT_SECRETYesOAuth2 client secret
STONE_BASE_URLNoOverride base URL (default https://api.openbank.stone.com.br/api/v1; sandbox https://sandbox-api.openbank.stone.com.br/api/v1)
STONE_AUTH_URLNoOverride the OAuth2 token URL (default https://accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token; sandbox https://sandbox-accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token). Up to 0.2.2 the token call went to login.openbank.stone.com.br, which does not exist, so every tool failed at authentication.

Roadmap

v0.3 (planned)

  • list_pix_keys — List registered Pix keys for a merchant
  • create_recipient — Marketplace / split recipients
  • create_transfer_batch — Batch transfer processing
  • get_boleto — Fetch boleto details
  • create_scheduled_payment — Schedule future-dated payments
  • list_payouts — List anticipation / settlement payouts

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/payments/stone/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

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

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分