mcp-circle — Circle MCP server for Claude Code: features and setup
Give an agent Circle tools for USDC payments, wallets, payouts and transfers. A Circle API key is required.
claude mcp add mcp-circle -e CIRCLE_API_KEY=<CIRCLE_API_KEY> -- npx -y @codespar/mcp-circleWhat mcp-circle does
mcp-circle connects an agent to Circle over MCP. Its tools can create and inspect business wallets, payments, payouts and transfers; they also cover balances, transactions, settlements and chargebacks. The server provides 23 tools.
Set CIRCLE_API_KEY to authenticate. Circle’s sandbox runs at api-sandbox.circle.com, and testing requires a sandbox API key. Without the key, the server cannot make Circle API requests. For Claude Code, use either of the setup commands below.
What it helps with
- create a Circle business wallet
- look up a payment or payout by ID
- send USDC between Circle wallets or to a blockchain address
- check a business-account balance
- list transactions or transfers with filters
Example prompts for the agent
- Create a Circle business wallet and show me its details.
- Look up the Circle payout with ID
...and report its status. - List Circle transactions matching these filters.
How to install mcp-circle
Platform CLI
claude mcp add mcp-circle -e CIRCLE_API_KEY=<CIRCLE_API_KEY> -- npx -y @codespar/mcp-circleReplace <…> with your own values
Platform CLI
codex mcp add circle --env CIRCLE_API_KEY=<CIRCLE_API_KEY> -- npx -y @codespar/mcp-circleReplace <…> with your own values
Config file
{
"mcpServers": {
"circle": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-circle"
],
"env": {
"CIRCLE_API_KEY": "<CIRCLE_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"circle": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-circle"
],
"env": {
"CIRCLE_API_KEY": "<CIRCLE_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e CIRCLE_API_KEY=<CIRCLE_API_KEY> circle npx -y @codespar/mcp-circleReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-circle
How do I install mcp-circle in Claude Code?
Run claude mcp add mcp-circle -e CIRCLE_API_KEY=<CIRCLE_API_KEY> -- npx -y @codespar/mcp-circle. Alternatively, use the stdio command: claude mcp add --env CIRCLE_API_KEY=<CIRCLE_API_KEY> --transport stdio circle -- npx -y @codespar/mcp-circle.
What does mcp-circle do?
It gives an agent MCP tools for Circle wallets, USDC payments, payouts and transfers. The tools also cover balances and transaction lookups.
Can I test mcp-circle without using live payments?
Yes. Circle has a sandbox at api-sandbox.circle.com. Set CIRCLE_API_KEY to a sandbox API key for testing.
