@codespar/mcp-circle
v0.1.0
Published
MCP server for Circle — USDC payments, wallets, payouts, transfers
Maintainers
Readme
@codespar/mcp-circle
MCP server for Circle — USDC stablecoin payments, payouts, transfers, and wallets
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"circle": {
"command": "npx",
"args": ["-y", "@codespar/mcp-circle"],
"env": {
"CIRCLE_API_KEY": "your-key"
}
}
}
}Claude Code
claude mcp add circle -- npx @codespar/mcp-circleCursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"circle": {
"command": "npx",
"args": ["-y", "@codespar/mcp-circle"],
"env": {
"CIRCLE_API_KEY": "your-key"
}
}
}
}Tools
| Tool | Description |
|------|-------------|
| create_wallet | Create a new Circle wallet |
| get_wallet | Get wallet details by ID |
| create_payment | Accept a USDC payment via Circle |
| get_payment | Get payment details by ID |
| create_payout | Create a payout from Circle (USDC to fiat) |
| get_payout | Get payout details by ID |
| create_transfer | Create a USDC transfer between Circle wallets |
| get_transfer | Get transfer details by ID |
| get_balance | Get account balance |
| list_transactions | List transactions with optional filters |
Authentication
Circle uses a Bearer API key for authentication.
Sandbox / Testing
Circle provides a sandbox at api-sandbox.circle.com. Use a sandbox API key for testing.
Get your credentials
- Go to Circle Developer Portal
- Create a developer account
- Generate a sandbox API key
- Set the
CIRCLE_API_KEYenvironment variable
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| CIRCLE_API_KEY | Yes | API key from Circle |
Roadmap
v0.2 (planned)
create_card_payment— Create a card paymentcreate_wire_payment— Create a wire transfer paymentcreate_ach_payment— Create an ACH paymentget_settlement— Get settlement detailslist_settlements— List settlements with filters
v0.3 (planned)
smart_contract_calls— Execute smart contract callscross_chain_transfers— Transfer assets across blockchains
Want to contribute? Open a PR or request a tool.
Links
License
MIT
