mcp-circle

@codespar/mcp-circle

Circle 向け MCP サーバー — USDC ステーブルコインの決済、出金、送金、ウォレット

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-circle"],
      "env": {
        "CIRCLE_API_KEY": "your-key"
      }
    }
  }
}

Claude Code

claude mcp add circle -- npx @codespar/mcp-circle

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-circle"],
      "env": {
        "CIRCLE_API_KEY": "your-key"
      }
    }
  }
}

ツール（23）

ツール	用途
create_wallet	新しい Circle ビジネスアカウントのウォレットを作成
get_wallet	ID でウォレットの詳細を取得
list_wallets	Circle のすべてのウォレットを一覧表示
create_payment	Circle 経由で USDC の決済を受け付ける
get_payment	ID で決済の詳細を取得
create_payout	Circle から出金を作成（USDC から法定通貨）
get_payout	ID で出金の詳細を取得
list_payouts	オプションのフィルターを指定して出金を一覧表示
create_transfer	Circle のウォレット間（またはブロックチェーンアドレス宛て）で USDC 送金を作成
get_transfer	ID で送金の詳細を取得
list_transfers	オプションのフィルターを指定して送金を一覧表示
create_card	オンランプ決済用のカードデータを登録
get_card	ID でカードの詳細を取得
list_cards	登録済みカードを一覧表示
list_settlements	精算（カード決済バッチ）を一覧表示
get_settlement	ID で精算の詳細を取得
list_chargebacks	チャージバックを一覧表示
get_chargeback	ID でチャージバックの詳細を取得
create_subscription	通知サブスクリプション（Webhook）を登録
list_subscriptions	通知サブスクリプション（Webhook）を一覧表示
delete_subscription	通知サブスクリプションを削除
get_balance	ビジネスアカウントの残高を取得
list_transactions	オプションのフィルターを指定して取引を一覧表示

認証

Circle は認証に Bearer API キーを使用します。

サンドボックス／テスト

Circle は api-sandbox.circle.com にサンドボックスを提供しています。テストにはサンドボックス API キーを使用してください。

認証情報を取得する

1. Circle Developer Portal にアクセスします
2. 開発者アカウントを作成します
3. サンドボックス API キーを生成します
4. CIRCLE_API_KEY 環境変数を設定します

環境変数

変数	必須	説明
CIRCLE_API_KEY	はい	Circle の API キー

ロードマップ

v0.2（予定）

• create_card_payment — カード決済を作成
• create_wire_payment — 電信送金の決済を作成
• create_ach_payment — ACH 決済を作成
• get_settlement — 精算の詳細を取得
• list_settlements — フィルターを指定して精算を一覧表示

v0.3（予定）

• smart_contract_calls — スマートコントラクトの呼び出しを実行
• cross_chain_transfers — ブロックチェーン間で資産を送金

貢献したいですか？PR を作成するか、ツールをリクエストしてください。

リンク

• Circle のウェブサイト
• Circle API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT