circle-agent-stack-mcp

circle-agent-stack-mcp

适用于 Circle's Agent Stack 的 MCP 服务。创建钱包、设置支出策略、发送 USDC，并支付按 x402 定价的端点——全部通过一次工具调用完成。

npx circle-agent-stack-mcp

工具

工具	功能
circle_wallet_create	创建 Agent 钱包（dev/hosted/smart）
circle_wallet_list	列出钱包及其 USDC 余额
circle_balance	查看钱包余额及最近 10 笔交易
circle_policy_set	设置每日限额、x402 限额以及允许/阻止列表
circle_transfer_usdc	向链上地址发送 USDC
circle_x402_pay	支付按 x402 定价的端点并返回其响应

快速开始

你需要安装并完成身份验证的 Circle CLI：

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

示例

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.

使用 x402 付费墙自托管

http-server.ts 通过 x402 付费墙封装相同的工具——Agent 按次使用 USDC 付费，而不是使用 API 密钥。如果你想将 Circle 工具作为付费服务提供，这会很有用。

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

要在本地测试 x402 流程，请运行 examples/x402-demo-server.mjs 中的简易演示服务。

工作原理

v0.1 会调用 Circle CLI 执行所有操作。这样可以避免在此代码库中处理身份验证，并且在工具接口经过验证之前，无需重新实现 API 客户端。v0.2 将改为通过 @circle-fin/circle-sdk 直接使用 HTTP。

安全

你的 Circle API 密钥拥有支出权限。请务必：

• 在启用自动付款前设置 daily_cap_usdc
• 先使用 type="dev" 钱包，而非主网钱包
• 投入生产环境前检查 allowlist
• 不要提交 CIRCLE_API_KEY

路线图

• circle_nanopayment_stream — 面向按 Token 计费的流式 x402 付款
• circle_skills_list / circle_skills_call — Circle Skills 市场
• 直接 HTTP API 模式（v0.2）— 移除对 CLI 的依赖
• 多链支持 — EURC、CCTP 跨链转账

相关链接

• Circle Agent Stack 文档
• x402 协议
• Model Context Protocol