Stone MCP Server

Stone uses OAuth2 client credentials for authentication. Its 21 documented tools cover payment, pix, charge, card.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Stone

before you install - you'll need

Set STONE_CLIENT_ID, STONE_CLIENT_SECRET before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-stone

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-stone"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-stone - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Stone can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get account balance, list account transactions, get account statement for a period, and create a payment via Stone.

Capability map

Tools grouped from the project's README - what Stone lets an agent do.

read & search

8 tools - e.g. Get account balance; List account transactions; Get account statement for a period

get_balance · list_transactions · get_statement · list_payments · list_receivables · list_terminals…

Payment

3 tools - e.g. Create a payment via Stone; Get payment details by ID; Create a Pix payment (outbound) via Stone

create_payment · get_payment · create_pix_payment

create & write

3 tools - e.g. Create a bank transfer (internal or external); Create a boleto bancário for charging a customer; Charge a credit or debit card (Stone acquiring)

create_transfer · create_boleto · create_card_charge

Anticipation

2 tools - e.g. Anticipate future receivables (Stone's flagship 'antecipação'); Get current anticipation limits (max / min / available) for a merchant

create_anticipation · get_anticipation_limits

Pix

1 tool - e.g. Create a Pix charge (QR Code / cob) to receive a payment

create_pix_charge

auth & access

1 tool - e.g. Tokenize a card to PCI-safe token for later charging

tokenize_card

Refund

1 tool - e.g. Refund a settled transaction (full or partial)

refund_transaction

delete

1 tool - e.g. Cancel an authorized (not-yet-captured) transaction

cancel_transaction

04 · Who maintains Stone

mcp-stone is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-stone (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-stone

06 · Stone FAQ

Is Stone still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Stone do?

With this server connected, an agent can get account balance, list account transactions, get account statement for a period, and create a payment via Stone.

How do I install Stone?

Run `npx -y @codespar/mcp-stone`. The README documents 2 environment variables (STONE_CLIENT_ID, STONE_CLIENT_SECRET) to set first. Set STONE_CLIENT_ID, STONE_CLIENT_SECRET before connecting. You can also paste the ready-made client config above.

Does Stone run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Stone

Alternatives to Stone

Maintained finance servers if Stone isn't the fit.

Pairs well with

Servers that cover what Stone doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Stripe · Stripe Acp · Vindi · Zoop · Mrmarket AI

More JavaScript MCP servers · Transbank · Ucp · see all