HPP x402 MCP Bridge

@hpp-io/x402-mcp-bridge

HPP のエージェント向け決済レールです。stdio MCP ブリッジと hpp-x402 CLI により、Claude Desktop ／ Claude Code ／ Cursor ／ Windsurf ／ OpenClaw から、x402 を通じて HPP USDC.e で自律的に支払いできます。有料サービスを見つけ、利用ごとに支払い、支出上限の範囲内で利用できます。API キーも手動署名も不要です。

📖 詳細ドキュメント

hpp-io/x402-tools — 完全なマニュアルです。仕組み、すべてのコマンド、購入者と販売者それぞれのフロー、決済スキーム（exact ／ upto）、ウォレットモード、トラブルシューティングを掲載しています。この README はクイックリファレンスです。

インストール

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.ps1 | iex
# …or npm
npm install -g @hpp-io/x402-mcp-bridge

Node 20 以降が必要です。ヘッドレス環境（OS のキーチェーンがない環境）では setup --print-key を使用してください。詳しくはマニュアルをご覧ください。

クイックスタート

hpp-x402 setup --install claude-code   # create a wallet + register into your host
hpp-x402 fund                          # where to send USDC.e (gasless, no native gas)
hpp-x402 status                        # confirm it's wired

ホストを再起動すると、エージェントがサービスを見つけて支払えるようになります。ターミナルからサービスを探して支払うこともできます。

hpp-x402 discover "price prediction"               # semantic search; your network only
hpp-x402 describe <id>                             # input args (schema + example) — no payment
hpp-x402 call <url-or-id> --body '{"hi":"there"}'  # pay + call — a URL, or an id from discover

HPP Smart Wallet から支払う

エージェントのキーに資金を入れる代わりに、設定した支出上限の範囲内で、エージェントがHPP Smart Walletから支払うようにできます。ウォレットで Agents → New を開き、エージェントのアドレス（hpp-x402 wallet address）を貼り付けて委任を発行し、ウォレットに表示されたコマンドを実行してください。値を入力すると、次のコマンドになります。

hpp-x402 install claude-code -n eip155:190415 --delegation 0x…

エージェントのキーが保存されているマシンで実行してください。値は書き込まれる前にそのキーとネットワークに照らして検証され、ブリッジの起動時にも毎回検証されます。この値は、そのキーだけが、期限が切れるまで、設定された上限内で使用できます。ただしシェルの履歴には残るため、利用上限のあるカード情報と同様に慎重に扱ってください。エージェントを停止するには、ウォレットで委任を取り消してください。

コマンドの完全なリファレンス、販売（serve）、スキーム、Safe モードについては、**マニュアル**をご覧ください。

MCP ホストから使用する

ホストは stdio 経由でブリッジを起動します。設定なしの基本的なエントリでは、HPP Sepolia 上でキーチェーンウォレットが自動作成され、起動します。

{ "mcpServers": { "hpp-x402": {
  "command": "npx", "args": ["-y", "@hpp-io/x402-mcp-bridge"]
} } }

hpp-x402 install <host> を実行すると、この設定が書き込まれます。注意：npx @hpp-io/x402-mcp-bridge をそのまま実行すると MCP サーバー（ホストが必要とするもの）が起動します。CLI を使用する場合は npx -y -p @hpp-io/x402-mcp-bridge hpp-x402 <command> を実行してください。

ホスト向けツール

ツール	説明
wallet_address	ウォレットアドレスを表示します（資金の入金用）
hpp_discover	厳選された HPP ディレクトリを一覧表示／検索します（読み取り専用）
hpp_describe	1 つのサービスの入力引数をスキーマと例で表示します（読み取り専用）
hpp_call	見つけたサービスを呼び出します（HTTP／MCP／A2A）。ウォレット経由で支払います
x402_http_call	任意の x402 HTTP エンドポイントに支払って呼び出します
pay_a2a_agent	別の A2A エージェントに支払ってメッセージを送信します

有料の呼び出しはすべて支出上限の範囲内に収まります。サービスの検索で資金が保持されたり、キーが参照されたりすることはありません。

主要な環境変数（すべて任意）

変数	説明
DELEGATE_PRIVATE_KEY	未設定の場合、OS のキーチェーンに自動作成されます
HPP_NETWORK	eip155:181228 Sepolia（デフォルト）／eip155:190415 Mainnet
RESOURCE_SERVER_URL	上流の MCP サーバーを 1 つプロキシします（省略するとローカルツールのみ）
SAFE_ADDRESS + ALLOWANCE_MODULE_ADDRESS	両方を設定すると Safe（ガバナンス）モードになります
HPP_PAYMENT_DELEGATION	このキーに対してウォレットが付与した ERC-7710 決済委任です。オンチェーンの上限の範囲内で、ユーザーのスマートアカウントからの erc7710 受け付けの支払いに使用されます。このキーに USDC.e は不要です。hpp-x402 install <host> --delegation <value> で書き込めます。インストール時と起動時にキーとネットワークを照合して検証されます（別のネットワークで発行された値、取り消された値、または期限切れの値の場合、理由とともにブリッジが停止します）。この値がない場合、そのような受け付けはスキップされます

環境変数の完全なリファレンスと Safe／ガバナンスの設定については、 マニュアルをご覧ください。

関連情報

エージェント／SDK 統合（LangChain、OpenAI の関数呼び出し、AgentKit、 A2A）を構築していますか？実行可能なサンプル集 → hpp-io/hpp-x402-agent-sampleをご覧ください。

ライセンス

Apache-2.0