x402-mcp-server

x402-mcp-server

x402 のマイクロペイメントを利用して、Base Mainnet 上の x402 による課金対象 HTTP ツールを集めた、小規模で拡充中のカタログです。API キーも登録も不要で、呼び出しごとに USDC で支払います。

この MCP サーバーは、このカタログをネイティブ MCP ツールとして公開します。ツールの呼び出しごとに自動で支払いが行われます。サーバーはリクエストを POST し、実際の x402 v2 402 PAYMENT-REQUIRED チャレンジを検出すると、ローカルウォレットを使って viem で EIP-3009 TransferWithAuthorization に署名し、PAYMENT-SIGNATURE ヘッダーを付けて再送信します。呼び出し時に人間による署名確認は不要です。エージェントはツールを呼び出すだけです。

ツール

ツール	料金（USDC）	説明	主な入力パラメーター
markdown-extractor	0.01	公開 URL を取得し、トークン効率に優れたクリーンな Markdown を返します。Base Mainnet 上で x402 v2 プロトコルにより課金されます。自律型 AI エージェントが直接呼び出すよう設計されており、API キーも登録も不要で、呼び出しごとに USDC で支払います。	url（文字列、必須）
spa-dom-to-md	0.03	Cloudflare Browser Rendering を介して、JavaScript を多用する SPA ページを実際のヘッドレス Chromium で描画します。ネットワークのアイドル状態またはセレクターの準備完了まで待機し、ナビゲーション、フッター、スクリプトの不要要素を除去したうえで、完全に描画された DOM を LLM 向けのクリーンな Markdown にシリアライズします。	url（文字列、必須）
burn-once-secret-vault	0.01	WebCrypto AES-256-GCM で暗号化したシークレット（API キー、Webhook ペイロード、署名付き URL）を保存し、シークレットを一度だけ取得できるクレーム URL を共有します。Durable Object が読み取りを直列化するため、1 回限りの配信で競合は発生せず、使用のたびに Ed25519 署名付きの証明が返されます。Vault の作成には x402 による支払いが必要ですが、受信者によるクレーム読み取り（GET /v/:vault_id）は無料です。	secret（文字列、必須）
svg-bar-chart-renderer	0.015	LLM エージェント向けの、描画ごとに課金される決定論的な SVG 棒グラフ生成ツールです。ラベル付きのスカラー値データとレイアウトオプションを受け取り、正確な幾何計算（最小値／最大値の正規化、適切な間隔の Y 軸目盛り、ラベル間隔、棒幅の配分）を実行して、スキーマに準拠し、適切にエスケープされた SVG を返します。同一の入力には常にバイト単位で同一の出力が生成されます。	data（配列、必須）
wasm-geotiff-transcoder	0.03	GeoTIFF／COG（https URL またはインライン base64）をデコードし、ウィンドウ化された概要読み取りを使って選択された RGB バンドを読み込み、トーンマップ伸張を適用して、PNG／WebP と地理参照メタデータ（CRS、境界、ピクセルスケール）、およびソース統計を返します。制限：ソースは 20 MB、出力幅は 2048 px です。試行ごとに課金されます。支払いは構造検証後、デコード前に確定するため、デコード時のエラー（ソースに存在しない bands_rgb バンドの指定など）も課金対象です。	source または or_base64_body のいずれか一方のみ（必須）

すべてのツールは Base Mainnet（eip155:8453）で動作します。決済はサーバー側で、順序付きのファシリテーター連鎖を通じて行われます。まず Coinbase CDP、次に PayAI、利用できない場合は Primer が使われます。お客様側で必要な操作は変わりません。どのファシリテーターを使う場合も、同じ EIP-3009 認証に署名します。また、すべてのツールは CDP と PayAI の x402 Bazaar 検索カタログにも掲載されています。各ツールの正確なリクエストボディのフィールドは、実行時に <tool-url>/openapi.json からも確認できます。

クイックスタート

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server_by_milza"],
      "env": {
        "BASE_PRIVATE_KEY": "0xyour_base_mainnet_private_key"
      }
    }
  }
}

⚠️ 資金に関する警告： BASE_PRIVATE_KEY には、少額の実際の USDC を入金した Base Mainnet ウォレットの秘密鍵を指定してください（この料金なら、たとえば $0.50 で数十回呼び出せます）。ツールの呼び出しごとに、このウォレットから実際に資金が支払われます。このサーバー経由での支出を許容できない資金を保有する鍵は使用しないでください。また、この鍵をソース管理にコミットしないでください。

設定後、Claude Desktop を再起動すると、上記のツールが追加設定、ダッシュボード、API キーの登録なしで自動的にアシスタントから利用できるようになります。

決済の仕組み

BASE_PRIVATE_KEY はご自身のウォレットです。このサーバーをインストールするユーザーがそれぞれ自分のキーを設定し、自分の呼び出しに対する料金を支払います。呼び出しごとの決済はツールプロバイダーのウォレットに直接行われ、ご自身のキーが他人の資金に触れることはなく、他人のキーがご自身の資金に触れることもありません。設定方法は次のとおりです。

1. 少額の支出に使ってもよい Base Mainnet の EVM ウォレットを使用するか、新しく作成します。
2. Base 上の USDC を少額（例：$0.50）入金します。
3. その秘密鍵をエクスポートし、前述のとおり MCP クライアントの設定で BASE_PRIVATE_KEY に設定します。

セキュリティ

• BASE_PRIVATE_KEY がご自身のマシンから外部に送信されることはありません。ローカル環境から一度だけ読み込まれ、viem を使用して EIP-712 の型付きデータ（EIP-3009 TransferWithAuthorization）による決済承認への署名をローカルで行う目的にのみ使用されます。
• 生の秘密鍵、シードフレーズ、署名がネットワーク経由で送信されることはありません。送信されるのは、実行対象の特定のリクエストの決済に必要な x402 プロトコルの要件を満たす、署名済みの承認情報のみです。
• 受取人、金額、ネットワーク、アセットコントラクト、有効期限といった決済条件は、リソースサーバーから返される最新の 402 チャレンジごとに取得されます。ローカルキャッシュの情報を信頼しないため、古くなったカタログや改ざんされたカタログによって資金の送金先が変えられることはありません。
• 支出上限：最新の 402 チャレンジは署名に関する仕組み（ドメイン、ナンスの有効期間、アセット）については信頼されますが、金額については信頼されません。各呼び出しでは、チャレンジで要求された金額を、このカタログに記載されたそのツールの既知の価格と照合し、それを超える署名は拒否します。そのため、乗っ取られた、侵害された、または不具合のあるエンドポイントが、要求額を増やすだけで無制限の署名を得ることはできません。
• このパッケージが開発元へ通信したり、テレメトリーを収集したり、ディスク上のどこかにキーを保存したりすることはありません。

必要条件

• Node.js 18+
• 少額の USDC を入金済みで、秘密鍵をご自身が管理する Base Mainnet の EVM ウォレット

ライセンス

MIT

リンク

• npm パッケージ
• ソース／問題報告