Stone

v0.2.0OAuth2

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

21 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-stone

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "stone": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-stone"
      ],
      "env": {
        "STONE_CLIENT_SECRET": "<your_stone_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 21 tools below — try get_balance first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

STONE_CLIENT_SECRET

requiredsecret

API key for stone

Available tools · 21

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READget_balance

Get account balance

READlist_transactions

List account transactions

READget_statement

Get account statement for a period

WRITEcreate_payment

Create a payment via Stone

WRITEget_payment

Get payment details by ID

WRITElist_payments

List payments with optional filters

WRITEcreate_transfer

Create a bank transfer (internal or external)

WRITEcreate_pix_payment

Create a Pix payment (outbound) via Stone

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.