English Français العربية

io.github.kinance/circle-agent-stack-mcp

Registre officiel Finance et paiements

Circle Agent Stack for AI agents: USDC wallets, spend policies, transfers, and x402 nanopayments.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package circle-agent-stack-mcp
Claude Code 
claude mcp add circle-agent-stack-mcp -e 'CIRCLE_API_KEY=<your circle_api_key>' -- npx -y circle-agent-stack-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "circle-agent-stack-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "circle-agent-stack-mcp@0.1.1"
            ],
            "env": {
                "CIRCLE_API_KEY": "<your circle_api_key>"
            }
        }
    }
}

Variables d'environnement

  • CIRCLE_API_KEY obligatoire secret Your Circle API key from developers.circle.com

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. circle-agent-stack-mcp
  2. Tools
  3. Quickstart
  4. Example
  5. Self-hosting with x402 paywall
  6. How it works
  7. Security
  8. Roadmap
  9. Related

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

You: Create a dev wallet called eva-treasury, set a $5 daily cap and $0.10 x402 cap,
     then fetch today's BTC signal from the x402 endpoint at https://signals.example.co/btc

Claude:
→ circle_wallet_create("eva-treasury", type="dev")
  { wallet_id: "wal_abc123", address: "0x..." }

→ circle_policy_set("wal_abc123", daily_cap_usdc=5, x402_cap_usdc=0.10)
  { status: "applied" }

→ circle_x402_pay("wal_abc123", "https://signals.example.co/btc", max_price_usdc=0.10)
  { signal: "LONG", confidence: 0.72, price_paid_usdc: 0.05 }

Today's BTC signal: LONG (72% confidence). Paid $0.05.

Self-hosting with x402 paywall

http-server.ts wraps the same tools behind an x402 paywall — agents pay per call in USDC rather than using an API key. Useful if you want to expose Circle tooling as a paid service.

CIRCLE_PAYOUT_ADDRESS=0x... npm run start:http

To test the x402 flow locally, run the toy demo server in examples/x402-demo-server.mjs.

How it works

v0.1 shells out to the Circle CLI for all operations. This keeps auth handling out of this repo and avoids reimplementing the API client before the tool surface is validated. v0.2 will switch to direct HTTP via @circle-fin/circle-sdk.

Security

Your Circle API key has spend authority. Always:

  • Set daily_cap_usdc before enabling automated payments
  • Start on type="dev" wallets, not mainnet
  • Review the allowlist before moving to production
  • Don't commit CIRCLE_API_KEY

Roadmap

  • [ ] circle_nanopayment_stream — streaming x402 payments for per-token billing
  • [ ] circle_skills_list / circle_skills_call — Circle Skills marketplace
  • [ ] Direct HTTP API mode (v0.2) — remove CLI dependency
  • [ ] Multi-chain — EURC, CCTP cross-chain transfers

Questions fréquentes

Qu'est-ce que io.github.kinance/circle-agent-stack-mcp ?

Circle Agent Stack for AI agents: USDC wallets, spend policies, transfers, and x402 nanopayments.

Comment installer io.github.kinance/circle-agent-stack-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add circle-agent-stack-mcp -e 'CIRCLE_API_KEY=<your circle_api_key>' -- npx -y circle-agent-stack-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.kinance/circle-agent-stack-mcp ?

Oui. Il attend CIRCLE_API_KEY, à renseigner dans sa configuration.

io.github.kinance/circle-agent-stack-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.kinance/circle-agent-stack-mcp ?

Il est publié par kinance. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.