@codespar/mcp-stone
MCP server for Stone — acquiring (card / Pix / boleto), anticipations, receivables, terminals, and open banking
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.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
claude mcp add stone -- npx @codespar/mcp-stone
Cursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"stone": {
"command": "npx",
"args": ["-y", "@codespar/mcp-stone"],
"env": {
"STONE_CLIENT_ID": "your-client-id",
"STONE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
| Tool | Purpose |
|---|
get_balance | Get account balance |
list_transactions | List account transactions |
get_statement | Get account statement for a period |
create_payment | Create a payment via Stone |
get_payment | Get payment details by ID |
list_payments | List payments with optional filters |
create_transfer | Create a bank transfer (internal or external) |
create_pix_payment | Create a Pix payment (outbound) via Stone |
create_pix_charge | Create a Pix charge (QR Code / cob) to receive a payment |
create_boleto | Create a boleto bancário for charging a customer |
create_card_charge | Charge a credit or debit card (Stone acquiring) |
tokenize_card | Tokenize a card to PCI-safe token for later charging |
refund_transaction | Refund a settled transaction (full or partial) |
cancel_transaction | Cancel an authorized (not-yet-captured) transaction |
create_anticipation | Anticipate future receivables (Stone's flagship 'antecipação') |
get_anticipation_limits | Get current anticipation limits (max / min / available) for a merchant |
list_receivables | Search receivables (future credits from card transactions) |
list_terminals | List physical Stone / TON terminals for a merchant |
get_terminal_status | Get current status of a specific POS terminal (online / offline / last seen) |
register_webhook | Register a webhook endpoint for Stone events |
list_webhooks | List 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
- Go to Stone Open Bank Documentation
- Register as a developer
- Create an application to get OAuth2 credentials
- Set the environment variables
Environment Variables
| Variable | Required | Description |
|---|
STONE_CLIENT_ID | Yes | OAuth2 client ID |
STONE_CLIENT_SECRET | Yes | OAuth2 client secret |
STONE_BASE_URL | No | Override base URL (default https://api.openbank.stone.com.br/api/v1) |
Roadmap
v0.3 (planned)
list_pix_keys — List registered Pix keys for a merchantcreate_recipient — Marketplace / split recipientscreate_transfer_batch — Batch transfer processingget_boleto — Fetch boleto detailscreate_scheduled_payment — Schedule future-dated paymentslist_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