Circle

v0.2.0API Key

USDC infrastructure: programmable wallets, payouts, and cross-border transfers. Your agent moves stablecoins with instant settlement.

23 tools1 env vars🌐 GLOBALstable on npm

Install

terminal

$ npm install @codespar/mcp-circle

Quickstart

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

claude_desktop_config.json

{
  "mcpServers": {
    "circle": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-circle"
      ],
      "env": {
        "CIRCLE_API_KEY": "<your_circle_api_key>"
      }
    }
  }
}

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

Environment variables · 1

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

CIRCLE_API_KEY

requiredsecret

API key for circle

Available tools · 23

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

WRITEcreate_wallet

Create a new Circle business-account wallet

READget_wallet

Get wallet details by ID

READlist_wallets

List all Circle wallets

WRITEcreate_payment

Accept a USDC payment via Circle

WRITEget_payment

Get payment details by ID

WRITEcreate_payout

Create a payout from Circle (USDC to fiat)

WRITEget_payout

Get payout details by ID

WRITElist_payouts

List payouts with optional filters

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.