Tensorfeed X402 Base Mcp

@tensorfeed/x402-base-mcp

Base メインネット上の x402 USDC 決済を検証する読み取り専用 MCP サーバーです。MCP 互換のエージェント（Claude Desktop、Claude Code、Cursor、ChatGPT）に追加すると、x402 の決済レシートをオンチェーンで独立して監査し、パブリッシャーの .well-known/x402 マニフェストを解析し、AFTA のフェデレーションステータスを確認できます。秘密鍵も署名もブロードキャストも必要ありません。

npm install -g @tensorfeed/x402-base-mcp

Coinbase Base MCP との関係

Coinbase は Base MCP（公式の mcp.base.org サーバー。2026 年 5 月に公開）を、決済側の MCP としてリリースしました。エージェントを Base Account に接続し、ユーザーがウォレット内で承認するスワップ、送金、x402 決済をエージェントが提案できるようにします。

このパッケージ @tensorfeed/x402-base-mcp は、検証側の MCP です。x402 決済（Base MCP、サーバー側の @coinbase/x402 ミドルウェア、またはその他の x402 クライアントによるもの）が行われた後、このサーバーを使うと、呼び出し元のエージェントがオンチェーンの決済を独立して確認し、パブリッシャーの /.well-known/x402 マニフェストを解析し、レシートを監査できます。ウォレットを使わず、読み取り専用でチェーンを確認できます。

この 2 つは競合するものではなく、相互に補完するものです。支払いには Base MCP を、検証にはこの MCP を使ってください。

検証用 MCP を別に用意する理由

x402 は、エージェントが Base 上で USDC を使って有料 API レスポンスの料金をマーチャントに支払う決済プロトコルです。エージェントが決済レシートを受け取ったとき、そのレシートの主張どおりに決済が実際に行われたことを確認する方法は 2 つあります。

1. マーチャントを信頼する
2. Transfer イベントをオンチェーンで直接読み取る

既存の EVM MCP サーバーの多くは、秘密鍵を必要とします（その場合、エージェントはトランザクションも送信できるため、運用上のリスクがあり、検証には不要です）。または、x402 に対応していない汎用のマルチチェーンリーダーです。このサーバーは、読み取り専用で x402 に対応した選択肢です。Claude Desktop または Claude Code のセッションに追加すれば、エージェントはウォレットを操作せずに x402 決済を検証できます。

TensorFeed 固有のツール（verify_afta_federation、tf_payment_lookup）は、TF の標準サーフェスに対して同じプリミティブを組み合わせ、パターンを示します。これらのツールを使っても、使わなくてもかまいません。汎用ツールだけでも問題なく動作します。

インストール

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "tensorfeed-x402-base": {
      "command": "npx",
      "args": ["-y", "@tensorfeed/x402-base-mcp"]
    }
  }
}

Claude Code

claude mcp add tensorfeed-x402-base -- npx -y @tensorfeed/x402-base-mcp

オプション：独自の RPC を使用する

サーバーはデフォルトで公開 Base RPC（https://mainnet.base.org）を使用します。通常の用途にはこれで十分です。負荷の高い用途では、TENSORFEED_RPC_URL を使って Alchemy または Infura の URL を設定してください。URL は src/rpc/allowlist.ts の許可リストに一致する必要があります。それ以外の URL は公開エンドポイントにフォールバックし、stderr に警告が記録されます。

export TENSORFEED_RPC_URL="https://base-mainnet.g.alchemy.com/v2/YOUR_KEY"

まだアカウントをお持ちでない場合のアフィリエイトリンク：

• Alchemy：https://www.alchemy.com/
• Infura：https://www.infura.io/

ツール

Base の汎用読み取り

ツール	説明
balance	アドレスのネイティブ ETH 残高
usdc_balance	アドレスの USDC（Circle のネイティブブリッジ版）残高
block_number	Base の最新ブロック番号
get_tx_receipt	ステータス、ガス、ログの概要を含む完全なトランザクションレシート
call	読み取り専用のコントラクト呼び出し（eth_call。ブロードキャストは行いません）
recent_transfers	N ブロック間にアドレスが関与した USDC Transfer イベント

x402 ネイティブの検証

ツール	説明
verify_x402_settlement	トランザクションハッシュ、想定される受取人、想定される USDC 額を指定すると、オンチェーンの Transfer イベントが一致するかどうかの構造化された判定を返します。
parse_x402_manifest	https://{domain}/.well-known/x402.json を取得し、構造化されたマニフェストを返します。
usdc_recent_payments_to	N ブロック間にアドレス宛てに行われた USDC 送金。マーチャント側からの表示です。
probe_x402_endpoint	任意の https URL をプローブし、accepts[] を含む標準的な x402 有料 402 レスポンスを返すかどうかを報告します。
decode_x402_payment_payload	base64 形式の X-PAYMENT ヘッダー（Coinbase x402 V2）をオフラインでデコードし、スキーム、ネットワーク、バージョン、EIP-3009 認証、署名を返します。

TensorFeed フレーバー

ツール	説明
verify_afta_federation	TensorFeed の AFTA 認証エンドポイントをドメインに対して呼び出し、スコア付きチェックリストを返します。
tf_payment_lookup	tx ハッシュが Base 上の TensorFeed の正規ウォレットへの USDC 支払いかどうかを確認します。
x402_publisher_health	TensorFeed の毎時 x402 ステータスプローブが監視するドメインについて、現在の結果、過去 24 時間／7 日間の稼働率、最近の推移を返します。
afta_federation_members	確認済み AFTA フェデレーションメンバーの正規の厳選リスト（TF の起点およびフェデレーションメンバー）を返します。

使用例

x402 決済を確認する（TensorFeed 初の正規 V2 決済で動作します）：

verify_x402_settlement({
  tx_hash: "0xe20c57d8aa6df63f75ce7a4e4c0cab492eb7fa672a23cd8fd59967eb6b66bd67",
  expected_recipient: "0x549c82e6bFC54bdaE9A2073744CBC2AF5D1FC6D1",
  expected_amount_usdc: "0.02"
})
// returns { ok: true, verified: true, matches: [...] }

パブリッシャーの x402 マニフェストを調べる：

parse_x402_manifest({ domain: "tensorfeed.ai" })

AFTA 認証を確認する：

verify_afta_federation({ domain: "tensorfeed.ai" })

脅威モデル

読み取り専用のチェーン可視化 MCP です。詳細は SECURITY.md をご覧ください。概要は以下のとおりです。

• 秘密鍵は使用せず、署名もブロードキャストも行いません。サーバーが資金を動かすことはできません。
• 各ツールの入力バリデーターが、不正なチェックサムや不正な形式のハッシュ、URL 形式のドメイン、プライベート／ループバックのホスト名などの入力を拒否します。
• 出力のサニタイズにより、呼び出し元のエージェントに返すすべての文字列から C0／C1 制御文字と、ゼロ幅文字／方向上書きマークを除去します。
• 外部文字列には _origin: "external" マーカーが付くため、呼び出し元のエージェントは値が第三者に由来することを把握できます。
• シリアライズされたツール出力には50 KB の応答上限があり、上限を超える応答は構造化スタブに置き換えられます。
• RPC 許可リストにより、セルフホスト環境で既知のエンドポイントのみを使用できます。任意の URL は拒否され、公開 Base RPC にフォールバックします。
• テレメトリー、ホームへの通信、分析機能はありません。
• 来歴：npm リリースは、暗号学的な来歴証明を付与して GitHub Actions OIDC 経由で公開されます。npm audit signatures で検証できます。

セキュリティ上の問題は [email protected] までご報告ください。修正されていない脆弱性について、公開 issue や CVE を登録しないでください。

ライセンス

MIT

関連項目

• Coinbase Base MCP - Base の公式な決済側 MCP です。このパッケージと組み合わせることで、決済から検証までの一連の流れを実現できます。Base MCP が x402 決済に署名し、このパッケージがオンチェーンで決済を独立して確認します。
• @tensorfeed/mcp-server - TensorFeed データ MCP（ニュース、ステータス、モデル、ベンチマーク、プレミアムエンドポイント）のコンパニオンパッケージです。役割は補完的です。このサーバーは x402 決済をオンチェーンで検証し、mcp-server は TF データ API を MCP ツールとして提供します。
• TensorFeed - AI エコシステムのデータレイヤー
• TensorFeed 開発者向け - AI エージェント向けの無料およびプレミアム API
• Agent Fair-Trade Agreement (AFTA) - 公正なエージェント間取引のためのオープン標準
• x402 spec - この MCP が検証する決済プロトコル