true402

@true402.dev/mcp-server

true402 のマシンネイティブなマーケットプレイス向け MCP サーバーです。x402 を通じて、AI 推論やウェブツールをエージェントが呼び出すたびに支払って利用できるようにします（Base 上の USDC による HTTP 402 マイクロペイメント）。

アカウントも API キーも不要です。エージェントのウォレットがそのアイデンティティです。有料ツールが HTTP 402 チャレンジを返すと、サーバーが EIP-3009 USDC 承認に署名し、呼び出しがオンチェーンで決済されます。資金を入れたウォレットを設定して自動支払いするか、ウォレットなしで実行してください。ウォレットなしの場合、有料ツールは失敗する代わりに、必要な支払い条件をそのまま提示します。

ツール

ツールは起動時にライブカタログから自動検出されるため、新しいマーケットプレイスの出品があっても、このパッケージを更新する必要はありません。現在、カタログには次のツールがあります。

グループ	ツール	価格
トークンの安全性（Base）	token_report（回避／注意／問題なしの総合判定。取引前のゲート）、token_safety、honeypot、address_safety、address_risk、deployer_check	$0.005–0.008
Base の履歴と資金フロー	liquidity_history（観測されたすべての流動性引き出しと、同時に資金を抜かれたトークン）、liquidity_pulls、new_pairs、whale_swaps	$0.003–0.005
署名する前に	tx_preflight — 未署名の Base トランザクションを検証します。リバートするか、無制限の承認を付与するか、取引相手が流動性を抜いているかを確認します。キーも署名も不要です	$0.008
詳細レポート	token_dossier — デプロイヤーと流動性の履歴に基づく判定と理由、および確認できなかった事項	$0.10
その他のチェーン	Ethereum と BSC でのトークン安全性、トークンレポート、アドレス安全性（Ethereum ではデプロイヤーの確認も可能）。Solana でのトークン安全性	$0.005–0.008
ウェブ	web_extract、link_preview、screenshot、robots_check（AI クローラーのポリシーと llms.txt）、headers_check	$0.003–0.005
SEO と検索	seo_audit（ページごとの SEO + GEO 監査）、serp、backlinks、keyword_volume（1 回の呼び出しにつき最大 200 キーワード）、ranked_keywords、keyword_ideas	$0.02–0.15
市場と金融	prediction_markets、defi_yields、quant	$0.003–0.005
LLM	chat（OpenAI 互換、トークンごとの料金 + 3%）、list_models（無料）	—

価格は目安です。実際の 402 チャレンジが正式な価格であり、サーバーは呼び出しごとの上限を超える署名を拒否します。正確なツール一覧は list_models を呼び出すか、https://true402.dev/api/openapi.json をご覧ください。

インストール

Node.js ≥ 20 が必要です。stdio 経由で実行します。npx を使って、任意の MCP クライアントから接続できます。

Claude Desktop / Claude Code

MCP 設定（Claude Desktop の場合は claude_desktop_config.json、Claude Code の場合は .mcp.json）に次の内容を追加してください。

{
  "mcpServers": {
    "true402": {
      "command": "npx",
      "args": ["-y", "@true402.dev/mcp-server"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY"
      }
    }
  }
}

Cursor / Cline / その他の MCP クライアント

同様に、コマンドに npx、引数に ["-y", "@true402.dev/mcp-server"] を指定し、WALLET_PRIVATE_KEY 環境変数を設定してください。

設定

環境変数	デフォルト	説明
SERVER_URL	https://true402.dev/api	true402 API のベース URL です。セルフホストインスタンスを指定する場合は上書きしてください。
WALLET_PRIVATE_KEY	(なし)	x402 決済の署名に使用する、残高のある Base ウォレットの秘密鍵です。USDC が必要です（ガス代はファシリテーターが負担するため、ETH は不要です）。設定されていない場合、有料ツールは決済せずに 402 の要件を返します。
MAX_PAYMENT_USDC	0.25	1 回の呼び出しあたりの支出上限です。このサーバーは、マーケットプレイスで告知されている有料の stall をすべて自動検出するため（固定リストではなく、稼働中の OpenAPI 仕様を走査します）、新しい stall や価格改定された stall が、いつでもデフォルト値を超えて登場する可能性があります。上限を超える呼び出しは拒否されます（決済もクラッシュも発生しません）。拒否時には価格と上限が示されます。検出されたツールの説明に記載された価格が、設定値に近い場合や超えている場合は、上限を引き上げてください。1 つの stall（seo_audit）はページ単位の料金で、大きなページでは一般的な上限を超えることがあります。
X402_ALLOW_NETWORKS	(なし)	決済の署名対象は Base mainnet（eip155:8453）のみです。別のチェーンを指定する 402 は拒否されます。Base Sepolia または Ethereum mainnet でも決済するには、eip155:84532,eip155:1 のように CAIP-2 ID をカンマ区切りで指定してください。サポートされていない項目は無視されます。

セキュリティ： 秘密鍵は環境変数からのみ読み込まれ、ログ出力、エコー、返却はされません。残高の少ない専用ウォレットを使用し、支出する予定の金額だけを入金してください。

決済の仕組み

1. ツールは決済なしで true402 エンドポイントを呼び出します。
2. サーバーは、利用可能な決済オプション（Base 上の USDC）とともに 402 を返します。
3. この MCP サーバーは、ウォレットを使って EIP-3009 transferWithAuthorization に署名します。
4. 署名済みの決済を PAYMENT-SIGNATURE ヘッダー（x402 v2）に含めて再試行します。サービスが検証し、応答します。
5. 決済はオンチェーンで行われます。ウォレットが支払うのは USDC のみで、ガス代はファシリテーターが負担します。

このサーバーの新しいリリースがある場合、セッション中の最初のツール結果に、インストールコマンドを含む追加の 1 行が表示されます。処理がブロックされることはなく、プロセスごとに 1 回だけ表示されます。

リンク

• マーケットプレイス：https://true402.dev
• 無料の Telegram ラグチェックボット（ウォレット不要）：https://t.me/True402bot
• ライブツールカタログ：https://true402.dev/api/v1/services
• x402 プロトコル：https://x402.org

ガイド

• x402 プロトコルの解説
• x402 ファシリテーター：役割と選び方
• x402 用の Base ウォレットに入金する（USDC のみ、ETH 不要）

以下でも利用可能

MCP（Claude Code / Desktop、Cursor、Hermes） · Hermes Agent · OpenClaw · ElizaOS · LangChain · CrewAI · Vercel AI SDK · Coinbase AgentKit · Virtuals GAME · CLI — 同じオンチェーンチェックを、それぞれ 1 つのインストールコマンドで利用できます： true402.dev/integrations

正確な支払い

以下のルールはこのパッケージではなくサービスのものです。使用するクライアントを問わず適用されるため、独自の支払い処理を実装する際に見落としやすい点です。

• 402で提示された金額を正確に支払ってください。 金額が不足すると拒否されます。超過した金額の支払いは402で拒否され、クレジットされません。決済では署名済みの金額が送信され、返金の手段もないため、余剰分はそのまま回収されます。金額が一致することで、認可が提示対象のリソースに対して行われたことも保証されます。
• 1回の認可で購入できるレスポンスは1つだけです。 リプレイは拒否され、二重請求にはなりません。
• 請求が発生するのは成功時のみです。 決済が送信されるのはエンドポイントが2xxを返した場合だけです。エラーまたはタイムアウトが発生した場合、署名済みの認可は送信されないため、返金するものもありません。
• エンドポイントによっては、ウォレットなしで、クライアントIPごとに1日数回まで無料で呼び出せます。どの操作が対象かは、OpenAPI仕様の操作ごとの説明をご覧ください。

すべてのルール：true402.dev/terms · ログに記録・保持される内容： true402.dev/privacy

ライセンス

MIT