English Français العربية

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

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • CIRCLE_API_KEY إلزامي سري Your Circle API key from developers.circle.com

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.kinance/circle-agent-stack-mcp؟

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

كيف أثبّت io.github.kinance/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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.kinance/circle-agent-stack-mcp إلى مفتاح API؟

نعم. يتطلب CIRCLE_API_KEY، وتضبطها في إعداداته.

هل io.github.kinance/circle-agent-stack-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.kinance/circle-agent-stack-mcp؟

ينشره kinance. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.