Circle MCP Server

Circle uses a Bearer API key for authentication. com. Use a sandbox API key for testing. Its 23 documented tools cover wallet, payment, payout, transfer.

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 Circle

before you install - you'll need

CIRCLE_API_KEY

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-crypto-c -- npx -y @codespar/mcp-circle

Claude Desktop / Cursor / VS Code - add to config

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

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-circle - published under the repo owner's npm scope (@codespar)

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

03 · What Circle 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 create a new Circle business-account wallet, get wallet details by ID, list all Circle wallets, and get payment details by ID.

Capability map

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

read & search

11 tools - e.g. List all Circle wallets; List payouts with optional filters; List transfers with optional filters

list_wallets · list_payouts · list_transfers · list_cards · list_settlements · get_settlement…

Wallet

2 tools - e.g. Create a new Circle business-account wallet; Get wallet details by ID

create_wallet · get_wallet

Payment

2 tools - e.g. Accept a USDC payment via Circle; Get payment details by ID

create_payment · get_payment

Payout

2 tools - e.g. Create a payout from Circle (USDC to fiat); Get payout details by ID

create_payout · get_payout

Transfer

2 tools - e.g. Create a USDC transfer between Circle wallets (or to blockchain address); Get transfer details by ID

create_transfer · get_transfer

Card

2 tools - e.g. Register card data for on-ramp payments; Get card details by ID

create_card · get_card

Subscription

2 tools - e.g. Register a notification subscription (webhook); Delete a notification subscription

create_subscription · delete_subscription

04 · Who maintains Circle

mcp-circle 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.

  1. mcp-asaas MCP server for Asaas - billing automation, Pix, boleto, credit card, subscriptions ★ 269
  2. mcp-omie MCP server for Omie - ERP, customers, products, orders, invoices, financials ★ 269
  3. mcp-sendgrid MCP server for SendGrid - global transactional + marketing email (Twilio-owned) ★ 269
  4. mcp-evolution-api MCP server for Evolution API - WhatsApp messaging, instances, contacts ★ 269
  5. mcp-stripe-acp Stripe ACP - AI agent checkout, payment delegation, products, invoices ★ 269
  6. mcp-mercado-bitcoin MCP server for Mercado Bitcoin - Brazilian crypto exchange, trading, orderbook, withdrawals ★ 269

05 · Facts

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

06 · Circle FAQ

Is Circle still maintained?

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

What can Circle do?

With this server connected, an agent can create a new Circle business-account wallet, get wallet details by ID, list all Circle wallets, and get payment details by ID.

How do I install Circle?

Run `npx -y @codespar/mcp-circle`. The README documents one environment variable (CIRCLE_API_KEY) to set first. You can also paste the ready-made client config above.

Does Circle 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 Circle

More finance MCP servers · Coinbase Cdp · Coinbase Commerce · Foxbit · Mercado Bitcoin · Moonpay