circle-agent-stack-mcp

circle-agent-stack-mcp

Circle の Agent Stack 用の MCP サーバーです。ウォレットの作成、支出ポリシーの設定、USDC の送金、x402 価格設定のエンドポイントへの支払いを、すべてツール呼び出しから実行できます。

npx circle-agent-stack-mcp

ツール

ツール	機能
circle_wallet_create	エージェントウォレット（dev/hosted/smart）を作成します
circle_wallet_list	USDC 残高とともにウォレットを一覧表示します
circle_balance	ウォレットの残高と直近 10 件のトランザクションを表示します
circle_policy_set	1 日あたりの上限、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 ペイウォールの背後で提供します。エージェントは API キーを使う代わりに、呼び出しごとに USDC で支払います。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 を設定する
• mainnet ではなく、type="dev" のウォレットから始める
• 本番環境に移行する前に allowlist を確認する
• CIRCLE_API_KEY をコミットしない

ロードマップ

• circle_nanopayment_stream — トークンごとの課金に対応したストリーミング x402 支払い
• circle_skills_list / circle_skills_call — Circle Skills マーケットプレイス
• 直接 HTTP API モード（v0.2）— CLI 依存を解消
• マルチチェーン — EURC、CCTP によるクロスチェーン送金

関連リンク

• Circle Agent Stack のドキュメント
• x402 プロトコル
• Model Context Protocol