kinance avatar

Circle Agent Stack Mcp

kinance/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 tools

Public 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*secret

Your 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

ToolWhat it does
circle_wallet_createCreate an agent wallet (dev/hosted/smart)
circle_wallet_listList wallets with USDC balances
circle_balanceBalance + last 10 txns for a wallet
circle_policy_setSet daily cap, x402 cap, allow/block lists
circle_transfer_usdcSend USDC to an on-chain address
circle_x402_payPay 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


View the full README on GitHub

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

Related AI & LLM Tools MCP servers

View all
1kten-agent avatarX402 Mcp Serverkten-agent/x402-mcp-serverMCP server for Hermes Asia x402 CN/JP market intelligence via USDC on Base. 8 endpoints.0stars
2lihaoshall avatarSeller Agent — Chinese Book Review Cataloglihaoshall/seller-agentDiscover original Chinese book reviews via MCP. Buy full articles for 0.95 USDC on Base.0stars
3lulzasaur9192 avatarAgent Arcade Mcplulzasaur9192/agent-arcade-mcpPlay Chess, Go, Trading & more against AI agents on Agent Arcade with Elo rankings0stars
4mogacode-ma avatarElementor Mcp Agentmogacode-ma/elementor-mcp-agentAgency-grade MCP for WordPress Elementor — multi-site, safe edits, templates, versions.0stars
5thefraudfather avatarAgent Transaction Controlthefraudfather/flint-pluginIssue Agent Passports and verify agent authority before value moves. Signed verification records.0stars
6nicofains1 avatarAgentic Adsnicofains1/agentic-adsAd network for AI agents — monetize MCP servers with contextual ads. 70% revenue share.0stars