mcp-x402

@codespar/mcp-x402

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に 2 つのパブリック DNS リゾルバー（8.8.8.8 と 1.1.1.1）を使って測定したところ、このサーバーが呼び出す唯一のホスト api.x402.org は DNS で名前解決できません。x402 に中央 API はありません。これは HTTP 402 プロトコルであり、支払いを検証するファシリテーターは販売者が選択します。このサーバーのツールはどれもサービスに接続できません。このパッケージは npm で非推奨となっており、参考用としてこのリポジトリに残されています。利用可能なエンドポイントがある場合は、X402_BASE_URL を指定してサーバーの接続先を変更してください。パッケージを再度利用可能にするには、プロバイダーの公式ドキュメントに記載されたベース URL を添えて、mcp-dev-latam で issue を作成してください。

Coinbase による x402 用 MCP サーバー — HTTP ネイティブのマイクロペイメントプロトコル（Base／Solana 上の USDC）

x402 とは？

x402 は、HTTP レイヤーでのマシン間マイクロペイメントを可能にするオープンプロトコルです。AI エージェントがリソースをリクエストして HTTP 402 Payment Required を受け取ると、オンチェーンで USDC を自動的に支払い、リクエストを再試行します。チェックアウト UI も加盟店との統合も不要で、純粋な HTTP で動作します。

これは、エージェント型コマースのために特化して構築された決済基盤です。

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-x402"],
      "env": {
        "X402_API_KEY": "your-key",
        "X402_WALLET_ADDRESS": "your-wallet-address"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-x402"],
      "env": {
        "X402_API_KEY": "your-key",
        "X402_WALLET_ADDRESS": "your-wallet-address"
      }
    }
  }
}

ツール（10）

ツール	用途
pay_request	402 で保護されたリソースへの支払いを行います。
verify_payment	x402 の支払いが受領され、オンチェーンで決済されたかを検証します
create_paywall	エンドポイント用の x402 ペイウォール設定を作成します。
get_paywall	特定の URL のペイウォール設定を取得します
list_paywalls	設定済みのすべての x402 ペイウォールを一覧表示します
delete_paywall	エンドポイントから x402 ペイウォールを削除します
get_balance	x402 の支払いに利用できる USDC 残高を取得します
list_payments	任意のフィルターを指定して x402 の支払い履歴を一覧表示します
get_payment	特定の x402 支払いの詳細を取得します
get_supported_networks	x402 の支払いに対応するブロックチェーンネットワーク、トークン、ファシリテーターを一覧表示します

認証

x402 は、登録済みのファシリテーターが発行する Bearer API キーを使用します。

認証情報の取得

1. x402 のドキュメントにアクセスします
2. ファシリテーターを設定するか、Coinbase のホスト型ファシリテーターを使用します
3. API キーを生成します
4. ウォレットアドレス（Base または Solana）を取得します
5. 環境変数を設定します

環境変数

変数	必須	説明
X402_API_KEY	はい	x402 ファシリテーターの API キー
X402_WALLET_ADDRESS	はい	支払いの送受信に使うウォレットアドレス
X402_NETWORK	いいえ	ブロックチェーンネットワーク：base（デフォルト）または solana

ユースケース

• エージェントによるプレミアム API へのアクセス — AI エージェントがデータフィード、LLM API、プレミアムコンテンツに対してリクエストごとに支払います
• マイクロペイメントによる収益化 — 1 セント未満のペイウォールで API エンドポイントを保護します
• マシン間コマース — エージェントがコンピューティングリソース、データ、サービスを自律的に購入します

ロードマップ

v0.2（予定）

• create_subscription — エンドポイント向けの定期的なマイクロペイメントを設定します
• estimate_cost — リソースへの支払い前に費用を見積もります
• batch_pay — 1 回のトランザクションで複数のリソースに支払います

v0.3（予定）

• 複数トークンへの対応（USDC に加えて ETH、SOL）
• 長時間実行されるエージェントタスク向けのストリーミング決済

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

リンク

• x402 プロトコル（Coinbase）
• x402 仕様
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT