x402engine-mcp

x402engine-mcp

x402engine 用のエージェント向け MCP サーバーです。HTTP 402 を通じて、エージェントがリクエストごとに課金される API を検出して呼び出せるようにし、Base または Solana での USDC 決済を自動で行います。

稼働中のゲートウェイでは、LLM、画像・動画生成、ウェブ検索・スクレイピング、コード実行、暗号資産・ウォレットデータ、トランザクションシミュレーション、音声、旅行、IPFS に対応しています。この MCP は、厳選されたツールセットと、カタログ全体のライブ検出機能を提供します。

クイックスタート

専用の、残高を少額に抑えた支払い用ウォレットを使用してください。MCP は x402 の支払いにローカルで署名し、秘密鍵を x402engine に送信することはありません。

Base

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

ウォレットに Base 上の USDC を入金してください。x402 ファシリテーターがトランザクションのガス代を支払い、ウォレットは EIP-3009 の USDC 承認に署名します。

Solana

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

ウォレットに Solana 上の USDC と、トランザクション手数料に十分な SOL を入金してください。

ウォレットなしでの検出

サーバーはウォレットなしで起動でき、discover_services や service_health などの無料ツールも引き続き利用できます。ウォレットが設定されるまで、有料ツールは x402 の支払い要件を返します。

claude mcp add x402engine -- npx -y [email protected]

Hermes Agent

x402engine スキルをインストールし、アクティブな Hermes プロファイルの config.yaml にこのサーバーをマージしてください。

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "[email protected]"]
    env:
      X402_BASE_URL: "https://x402engine.app"
      X402_PAYMENT_NETWORK: "auto"
      X402_MAX_PAYMENT_USD: "0.10"

新しいセッションを開始し、discover_services または service_health を呼び出してください。どちらも無料です。ウォレットを設定するまでは、ネットワークを auto のままにしてください。Base で支払う場合は、プロファイルのローカル .env に X402_EVM_PRIVATE_KEY を保存し、サーバーの env に X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" を追加して、ネットワークを base に変更してください。ウォレットのキーをチャットに記載しないでください。上限はリクエストごとに適用されます。タスクごとに別途、合計予算を設定してください。

Hermes の完全なセットアップガイド · インストール可能なスキル

支払い制御

変数	デフォルト	説明
X402_EVM_PRIVATE_KEY	未設定	Base の USDC 用の専用支払いキー
X402_SOLANA_PRIVATE_KEY	未設定	Solana の USDC 用の Base58 または JSON 形式の支払いキー
X402_PAYMENT_NETWORK	auto	auto、base、または solana
X402_MAX_PAYMENT_USD	1.00	リクエストごとの厳格な支出上限
X402_BASE_URL	本番ゲートウェイ	ゲートウェイ URL の上書き
X402_PAYMENT_HEADER	未設定	旧形式の署名済み x402 ヘッダー
X402_DEV_BYPASS	未設定	開発用バイパスシークレット

auto モードでは、両方のキーが設定されている場合は Base が優先されます。自動支払いで受け付けるのは、Base および Solana 上の正規の USDC コントラクトのみです。署名する前に、不明な資産、未対応のネットワーク、設定した上限を超える金額を拒否します。

独自の互換性のある支払いヘッダーを指定するクライアントは、引き続き MegaETH を利用できます。

MCP ツール

カテゴリ	ツール
検出	discover_services、service_health
画像・コード	generate_image、execute_code
音声	transcribe_audio
暗号資産	get_crypto_price、get_crypto_markets、get_crypto_history、get_trending_crypto、search_crypto、get_crypto_categories
ウォレット・トークン	get_wallet_balances、get_wallet_transactions、get_wallet_pnl、get_token_prices、get_token_metadata
IPFS	pin_to_ipfs、get_from_ipfs
旅行	search_flights、search_locations、search_hotels、search_cheapest_dates

各ツールの説明とライブ検出には価格が含まれます。ゲートウェイのカタログは、このパッケージとは独立して変更される場合があります。

検出

• ゲートウェイの検出情報：/.well-known/x402.json
• エージェントカード：/.well-known/agent.json
• エンドポイントマニフェスト：/.well-known/agent-manifest.v1.json
• サービス API：/api/services
• パッケージメタデータ：server.json

開発

npm install
npm test
npm run build

Links

• Website: x402engine.app
• npm: x402engine-mcp
• GitHub: agentc22/x402engine-mcp
• Protocol: x402.org