x402engine
公式50以上のペイ・パー・コールAPIを、HTTP 402暗号マイクロペイメント経由でAIエージェントに提供。1コールあたり0.001~0.12ドルで、USDCとUSDmに対応。
x402engine MCPで何ができますか?
- 有料APIを見つける — アシスタントに
discover_servicesで利用可能な従量課金サービスを一覧表示させ、service_healthでステータスを確認してもらいましょう。 - 画像生成とコード実行 —
generate_imageで画像作成、execute_codeでコード実行をリクエスト。BaseまたはSolana上でUSDCによる自動支払いが行われます。 - 暗号資産とウォレットデータの照会 —
get_crypto_priceやget_wallet_balancesなどのツールを使って、価格、市場トレンド、ウォレット残高、取引、トークンメタデータを取得できます。 - 音声処理とIPFS —
transcribe_audioで音声ファイルを文字起こし、pin_to_ipfsとget_from_ipfsでIPFSへのコンテンツのピン留めや取得が可能です。 - 旅行オプションの検索 —
search_flightsやsearch_hotelsなどのツールで、フライト、ホテル、場所、最安旅行日を見つけられます。
ドキュメント
x402engine-mcp
エージェント向けのMCPサーバーで、x402engineに対応しています。エージェントがHTTP 402を通じて従量課金制APIを発見・呼び出しでき、BaseまたはSolana上でのUSDC自動支払いに対応します。
ライブゲートウェイは、LLM、画像・動画生成、ウェブ検索・スクレイピング、コード実行、暗号資産・ウォレットデータ、トランザクションシミュレーション、音声、旅行、IPFSをカバーしています。このMCPは、厳選されたツールセットと全カタログのライブディスカバリを公開します。
クイックスタート
専用の低残高の支払いウォレットを使用してください。MCPはx402支払いをローカルで署名し、秘密鍵をx402engineに送信することはありません。
Base
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.1"],
"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", "x402engine-mcp@1.1.1"],
"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 x402engine-mcp@1.1.1
Hermesエージェント
x402engineスキルをインストールし、このサーバーをアクティブなHermesプロファイルのconfig.yamlに統合します:
mcp_servers:
x402engine:
command: npx
args: ["-y", "x402engine-mcp@1.1.1"]
env:
X402_BASE_URL: "https://x402engine.app"
X402_PAYMENT_NETWORK: "auto"
X402_MAX_PAYMENT_USD: "0.10"
新しいセッションを開始し、discover_servicesまたはservice_healthを呼び出します。どちらも無料です。ウォレットが設定されるまで、ネットワークはautoのままにしてください。Base支払いの場合は、X402_EVM_PRIVATE_KEYをプロファイルのローカル.envに保存し、X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}"をサーバーのenvに追加し、ネットワークを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
リンク
- ウェブサイト: x402engine.app
- npm: x402engine-mcp
- GitHub: agentc22/x402engine-mcp
- プロトコル: x402.org