
Circle Agent Stack Mcp
Wraps Circle's Agent Stack so Claude can create USDC wallets, set spending policies, transfer funds, and pay x402 endpoints that bill per call in stablecoin. You get six tools: wallet creation and listing, balance checks, policy management, standard USDC transfers, and x402 payments that return the API response along with the amount paid. Currently shells out to the Circle CLI for auth and operations, with direct SDK support planned for v0.2. Worth looking at if you're building agents that need to handle crypto payments autonomously or consume APIs that charge in USDC instead of requiring API keys. Start with dev wallets and set daily caps before you point it at anything live.
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- May 31, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
circle_wallet_createCreate an agent wallet (dev/hosted/smart)
Create an agent wallet (dev/hosted/smart)
No parameter schema in public metadata yet.
circle_wallet_listList wallets with USDC balances
List wallets with USDC balances
No parameter schema in public metadata yet.
circle_balanceBalance + last 10 txns for a wallet
Balance + last 10 txns for a wallet
No parameter schema in public metadata yet.
circle_policy_setSet daily cap, x402 cap, allow/block lists
Set daily cap, x402 cap, allow/block lists
No parameter schema in public metadata yet.
circle_transfer_usdcSend USDC to an on-chain address
Send USDC to an on-chain address
No parameter schema in public metadata yet.
circle_x402_payPay an x402-priced endpoint and return its response
Pay an x402-priced endpoint and return its response
No parameter schema in public metadata yet.
Sponsors
Configuration
CIRCLE_API_KEY*secretYour Circle API key from developers.circle.com
Readme
circle-agent-stack-mcp
MCP server for Circle's Agent Stack. Create wallets, set spend policies, send USDC, and pay x402-priced endpoints — all from a tool call.
npx circle-agent-stack-mcp
Tools
| Tool | What it does |
|---|---|
circle_wallet_create | Create an agent wallet (dev/hosted/smart) |
circle_wallet_list | List wallets with USDC balances |
circle_balance | Balance + last 10 txns for a wallet |
circle_policy_set | Set daily cap, x402 cap, allow/block lists |
circle_transfer_usdc | Send USDC to an on-chain address |
circle_x402_pay | Pay an x402-priced endpoint and return its response |
Quickstart
You need the Circle CLI installed and authenticated:
npm install -g @circle-fin/circle-cli
circle login
export CIRCLE_API_KEY=your_key_here
Claude Desktop
{
"mcpServers": {
"circle": {
"command": "npx",
"args": ["-y", "circle-agent-stack-mcp"],
"env": {
"CIRCLE_API_KEY": "your_key_here"
}
}
}
}
Claude Code
claude mcp add circle -- npx -y circle-agent-stack-mcp
Example
Details
- Repository
- github.com/kinance/circle-agent-stack-mcp
- Category
- AI & LLM Tools
- Package
circle-agent-stack-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active