x402 Seller

x402-seller-mcp

x402-seller の有料エンドポイント（暗号資産価格、DeFi データ、オンチェーンデータの読み取り、ウェブの閲覧、Claude を活用したテキストタスク）をすべて、エージェント（Claude Desktop、Cursor、または任意の MCP クライアント）が呼び出せるツールに変換する MCP サーバーです。

ツールは手動で一覧化するのではなく、サーバー自身の /.well-known/x402.json ディスカバリードキュメントから起動時に生成されるため、ツール一覧は常にオリジンで実際に稼働中の内容と一致します。

2 つのモード

• ウォレット未設定（デフォルト） — ツールを呼び出すとエンドポイントにリクエストし、実際の 402 Payment Required チャレンジを取得して、実際のデータの代わりに平易な説明（価格、ネットワーク、支払いを有効にする方法）を返します。セットアップ不要で安全に試せます。
• ウォレット設定済み（BUYER_PRIVATE_KEY を設定）— @x402/fetch を介して x402 で呼び出し料金を自動的に支払い、実際の結果と決済レシート（支払者アドレス、トランザクションハッシュ）を返します。

インストール

npx x402-seller-mcp

これだけでインストールは完了です。説明のみのモードで試す場合は、クローン、ビルド、設定は不要です。

Claude Desktop

claude_desktop_config.json に以下を追加してください（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "x402-seller": {
      "command": "npx",
      "args": ["-y", "x402-seller-mcp"]
    }
  }
}

自動支払いを有効にするには、env ブロックを追加してください（下記の支払いを有効にするを参照）：

{
  "mcpServers": {
    "x402-seller": {
      "command": "npx",
      "args": ["-y", "x402-seller-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x..."
      }
    }
  }
}

設定を編集したら、Claude Desktop を再起動してください。

Cursor

Cursor も同じ mcpServers 形式を使用します。同じブロックを ~/.cursor/mcp.json （またはプロジェクトの .cursor/mcp.json）に追加し、Settings → MCP から MCP サーバーを再読み込みしてください。

支払いを有効にする

⚠️ 重要な資金を保有するウォレットは使わず、使い捨てのウォレットを使用してください。 ここで設定する秘密鍵は、ツール呼び出しごとの料金の範囲内で Base 上の USDC 送金に署名できます（このサーバーの全エンドポイントの料金は、呼び出しごとに $0.005～$0.02 です）。ただし、鍵を環境変数に持つプロセスであれば、原則としてどれでも使用できます。この MCP サーバー専用の新しいウォレットを生成し、Base 上の USDC を数ドル分だけ入金してください。それ以上は入金しないでください。

1. ウォレットを生成します（任意の EVM ウォレットを使用できます。たとえば、viem を使う場合は次のコマンドを実行します：node -e "const {generatePrivateKey,privateKeyToAccount}=require('viem/accounts');const k=generatePrivateKey();console.log(k, privateKeyToAccount(k).address)"。MetaMask などのウォレットアプリからエクスポートする方法もあります）。
2. そのウォレットのアドレスに、Base 上の USDC を少額送金します（このサーバーが決済に使用するネットワークです）。この料金なら、数ドルで数百回の呼び出しをまかなえます。
3. ウォレットの秘密鍵（0x... で始まる 16 進数文字列）を BUYER_PRIVATE_KEY に設定します。MCP クライアントの設定（上記の例を参照）に追加するか、サーバーを直接実行する場合はシェル環境変数に設定してください。
4. MCP サーバー（または MCP クライアント）を再起動します。これ以降、ツール呼び出しでは料金が自動的に支払われ、実際の結果が返されます。

設定

環境変数	必須	デフォルト	用途
BUYER_PRIVATE_KEY	いいえ	(未設定)	ツール呼び出しの支払いに使用する EVM 秘密鍵です。未設定の場合は説明のみのモードになります。
X402_ORIGIN	いいえ	https://x402-seller-0ay3.onrender.com	ツールとして公開する x402 サーバーです。必要に応じて、別の x402 互換サーバー（またはローカルの開発用インスタンス）を指定できます。

ツール

オリジンのディスカバリードキュメントにある有料リソースごとに 1 つのツールが用意され、<method>_<path> という名前が付けられます（例：get_api_gas_base、post_api_web_read）。現在の全ツール一覧と各ツールの入力スキーマは、サーバーを実行して tools/list を呼び出すか、 /.well-known/x402.json を直接確認してください。稼働中のオリジンとの差異が生じないよう、ここでは意図的に重複して掲載していません。

関連

エンドポイントごとに1つのツールを使うのではなく、日常的に使う少数のツール（ファクトチェック、市場データ、ガス価格、手軽な AI タスク）を求める汎用エージェントについては、 @dm2233/agent-data-mcp （npm）をご覧ください。同じ33エンドポイントのカタログを、5つのグループ化されたツールとして提供します。

開発

git clone https://github.com/entreprisedaney33-rgb/x402-seller.git
cd x402-seller/mcp
npm install
node server.js          # runs on stdio, waits for a client

test/manual-test.mjs は、MCP クライアントと同じ方法（StdioClientTransport 経由）でサーバーを起動し、公式の Client クラスを使って操作するスタンドアロンのテストハーネスです。まず listTools() を実行し、続いて両方のモードで callTool() を実行します。npm install の後、node test/manual-test.mjs で直接実行してください（有料パスもテストできるよう、親リポジトリの .env があれば、そこから BUYER_PRIVATE_KEY を読み込みます）。

ライセンス

MIT