Skip to main content
S

Stone

@codespar/mcp-stone · v0.2.3

🇧🇷 BrazilPaymentsAuth · OAuth2live21 tools4 env vars

Open banking, Pix, and card acquiring. TON integration, partner tags, and real-time settlement for Brazilian commerce.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • The package manifest does not declare 3 of the 4 variables the code reads.
  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-stone
Version
0.2.3
npm dist-tag
latest
Category
Payments
Auth
OAuth2
Country
🇧🇷 Brazil
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables4 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 21 tools. Try get_balance first.
terminal
# Claude Code claude mcp add stone -e STONE_AUTH_URL=… -e STONE_BASE_URL=… -e STONE_CLIENT_ID=… -e STONE_CLIENT_SECRET=… -- npx -y @codespar/mcp-stone@0.2.3 # then: /mcp to confirm the server is connected
Environment variables4 variables
STONE_AUTH_URLRead by the code; the package manifest does not declare it.
STONE_BASE_URLRead by the code; the package manifest does not declare it.
STONE_CLIENT_IDRead by the code; the package manifest does not declare it.
STONE_CLIENT_SECRETAPI key for stonerequiredsecret

Names read from the package code (@codespar/mcp-stone@0.2.3). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demoget_balance

"Get account balance"

tools/callget_balanceresult returned

Tools

What your agent can call.

21 tools, as the package's tools/list returns them.

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

Names and descriptions come from the package's tools/list (@codespar/mcp-stone@0.2.3). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Stone MCP server?

Run npx -y @codespar/mcp-stone@0.2.3 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Stone?

Stone exposes 21 tools for payments. Your agent calls them directly; the full list is above.

How does Stone authenticate, and how are credentials stored?

Stone uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Stone handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.3, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Stone open source? How do I report a bug?

Yes. Stone is MIT-licensed and published on npm as @codespar/mcp-stone, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Stone — MCP server · 21 tools | CodeSpar