anchor-x402

anchor-x402-mcp

14 個の anchor-x402 サービスを、Claude Desktop／Cursor／Codex／Continue のエージェントが呼び出せるツールとして公開する MCP サーバーです。Base メインネット上の x402 を通じて、USDC で使った分だけ支払います。API キーもサブスクリプションも不要です。

2 つのトランスポート — ウォレットキーを誰が保持するかに応じて選択

**このパッケージ（stdio）**では、ローカルプロセスに資金の入った EVM 秘密鍵（ANCHOR_WALLET_PRIVATE_KEY）が必要です。呼び出しごとの支払いは、代わりにこのパッケージが行います。便利ですが、ホットキーをプロセスに渡すことになります。

Streamable HTTP — POST https://api.anchor-x402.com/mcp — インストールもキーの引き渡しも不要です。すべての18 個のサービス（このパッケージより 4 個多い roll_random、investigate_wallet、ledger_summary、ledger_report）を公開し、PAYMENT-SIGNATURE ヘッダーで呼び出しごとに支払うため、キーが手元から離れることはありません。

{
  "mcpServers": {
    "anchor-x402": { "url": "https://api.anchor-x402.com/mcp" }
  }
}

リモート MCP にネイティブ対応するクライアントでは、上記の url 形式を使用します。stdio プロセスの起動にしか対応しないクライアントの場合は、ブリッジしてください。

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.anchor-x402.com/mcp"]
    }
  }
}

対応するプロトコルリビジョンは 2026-07-28、2025-11-25、2025-06-18、2025-03-26 です。ステートレス時代と initialize ハンドシェイク時代の両方に、1 つのエンドポイントで対応します。server/discover と tools/list は無料で、tools/call は有料です。

支払いには通常の x402 の手順を使用し、MCP の外側ではなく内側で処理します。未払いの tools/call は JSON-RPC エラーではなく結果を返し、isError: true、structuredContent.accepts にチャレンジ、そして標準の payment-required ヘッダーを含みます。選択肢のいずれかに署名し、同じ呼び出しを PAYMENT-SIGNATURE とともに再試行してください。チャレンジを意図的に結果として返すのは、エージェントがそれを読み取って支払いを行えるようにするためです。JSON-RPC エラーでは、モデルが目にする前にクライアントに握りつぶされてしまいます。

サーバーカード：/.well-known/mcp/server-card.json。標準の x402 fetch ラッパーを MCP の結果形式にブリッジするアダプターを含む、クライアントの実例は examples/agent/mcp-paid-call.mjs にあります。

この README の残りでは、stdio パッケージについて説明します。

エージェントが利用できるもの

14 種類のツール。1 回あたり $0.001〜$0.05 です。

汎用プリミティブ（9 種類、$0.001〜$0.01）：

ツール	価格	機能
anchor_hash	$0.005	任意の 32 バイトハッシュを Base と Solana mainnet に並行してアンカーし、両方のトランザクション URL を返します
screen_wallet	$0.005	ウォレットのリスクを事前確認します。OFAC 制裁対象とアドレスの評判（資産流出／フィッシング／ミキサー）を照合し、許可／要確認／ブロックを判定します
attest_decision	$0.010	決定を証明します。自分で署名するか、トレジャリーに署名させてから、デュアルチェーンにアンカーします。/v1/attest/verify で無料で再検証できます
decode_tx	$0.001	任意の mainnet トランザクション（Base／Ethereum／Solana）を構造化してデコードします
resolve_name	$0.001	クロスチェーンの名前解決（ENS、Bonfida SNS）を行います
token_price	$0.001	シンボルまたはチェーン＋コントラクトで指定した任意のトークンの USD 現物価格を返します
decode_calldata	$0.001	生の EVM calldata の 4byte セレクターと ABI パラメーターをデコードします
parse_datetime	$0.001	自由形式の日時文字列を構造化された ISO 8601 形式に変換します
intel_wallet	$0.005	ウォレットの残高、アクティビティ、ID、制裁情報を 1 回の呼び出しでまとめて取得します

汎用 LLM エンドポイント（5 種類、$0.01〜$0.05）— v0.2 で追加：

ツール	価格	機能
roast	$0.05	ウォレット、ツイート、コード、アイデアなど、あらゆる対象をウィットに富んだ 3〜5 段落でこき下ろします
oracle	$0.05	Yes／No のオラクルです。YES／NO／MAYBE と理由、およびデュアルチェーンにアンカーされた (question | answer | timestamp) ハッシュを返します。質問した時刻の暗号学的な証明です。
tldr	$0.01	URL（最大 500KB を取得）または貼り付けたテキストを、簡潔な 3〜5 個の箇条書きに要約します
aura	$0.01	色、ティア（S/A/B/C/D/F）、スコア（0〜9999）、そしてオーラを簡潔に読み解く 2〜3 文を返します
grade	$0.01	赤ペンによる欄外コメントと 1 段落の要約を添えて、学術的な評価（A+〜F）を返します

調査ツール（/v1/investigate、$1.77、非同期）とホスト型チャットボット chat.anchor-x402.com は MCP に含まれていません。それぞれ HTTP API とブラウザーから直接利用します。

MCP サーバーの利用料はウォレットから自動的に差し引かれるため、サーバー自身で費用を賄えます。事前入金、API キー、アカウントは不要です。

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "anchor-x402-mcp"],
      "env": {
        "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Claude Desktop を再起動します。*「ハッシュ 7646dda1564bde0ef3f3971f4c002962df64246da4aa1d8c47247e7632494710 を mainnet にアンカーして」*と尋ねると、anchor_hash が呼び出され、ウォレットから $0.005 USDC が支払われます。

Claude Code

プロジェクトの .mcp.json に追加します。

{
  "anchor-x402": {
    "command": "npx",
    "args": ["-y", "anchor-x402-mcp"],
    "env": {
      "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
    }
  }
}

Codex CLI（OpenAI）

~/.codex/config.toml を編集します。

[mcp_servers.anchor-x402]
command = "npx"
args = ["-y", "anchor-x402-mcp"]

[mcp_servers.anchor-x402.env]
ANCHOR_WALLET_PRIVATE_KEY = "0xYOUR_BASE_WALLET_PRIVATE_KEY"

codex を再起動します。/mcp と入力して、読み込まれたサーバーの一覧に anchor-x402 が表示されることを確認します。

ChatGPT Desktop

設定 → インテグレーション → MCP サーバー → サーバーを追加を選び、次の内容を貼り付けます。

{
  "command": "npx",
  "args": ["-y", "anchor-x402-mcp"],
  "env": {
    "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
  }
}

保存して再起動すると、ツール使用が有効なすべてのチャットで 14 種類のツールが利用できるようになります。

Cursor

~/.cursor/mcp.json（グローバル）または <project>/.cursor/mcp.json（プロジェクト単位）を編集します。

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "anchor-x402-mcp"],
      "env": {
        "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

OpenAI Agents SDK（プログラムから利用）

from openai_agents import Agent, MCPServerStdio

mcp = MCPServerStdio(
    command="npx",
    args=["-y", "anchor-x402-mcp"],
    env={"ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"},
)
agent = Agent(name="researcher", model="gpt-4o", mcp_servers=[mcp])

同じパッケージ、同じ環境変数で、設定ファイルではなくプログラムから利用できます。

Continue／Smithery／汎用 MCP クライアント

同じ形式です。command: npx、args: [-y, anchor-x402-mcp] を指定し、env にウォレットキーを設定します。トランスポートは MCP SDK が処理します。

または、Smithery のワンライナーでインストールできます。

npx -y @smithery/cli install anchor-x402-mcp --client claude

（--client claude を cursor、codex、windsurf などに置き換えてください。）

単独で実行

ANCHOR_WALLET_PRIVATE_KEY=0xYOUR_KEY npx anchor-x402-mcp

stdio 経由で MCP 通信を行います。任意の MCP 対応クライアントにパイプで渡せます。

ウォレットへの入金

ANCHOR_WALLET_PRIVATE_KEY に設定したウォレットには、Base メインネット上の USDC が必要です。金額はいくらでも構いません。1 ドルでも、アンカー呼び出しを 100 回、またはコモディティティアの呼び出しを 1000 回行えます。ウォレットの Base アドレスに USDC を送金してください。

• Base 上の USDC コントラクト：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• bridge.base.org 経由で Ethereum メインネットからブリッジ
• Coinbase で直接購入し、Base に出金

MCP サーバーは x402（Coinbase のオープンな HTTP ネイティブのマイクロペイメントプロトコル）を介して支払いに署名します。各リクエストの流れは次のとおりです。

1. anchor-x402 エンドポイントにアクセスします
2. 支払い要件を含む 402 が返されます
3. サーバーが秘密鍵を使って USDC の送金承認に署名します
4. 署名済みの支払いとともにリクエストを再試行し、API が Coinbase のファシリテーターを介して決済します

レスポンスを受け取ると、ウォレットの USDC 残高が呼び出し料金分だけ減ります。1 秒未満で完了し、台帳もアカウントも必要ありません。

環境変数

変数	必須？	用途
ANCHOR_WALLET_PRIVATE_KEY	有料の呼び出しでは必須	EVM 秘密鍵です。x402 の呼び出し料金をこのウォレットで支払います。
ANCHOR_API_URL	いいえ	API のベース URL を上書きします。デフォルト：https://api.anchor-x402.com。セルフホストしたフォークを使った開発に便利です。

ANCHOR_WALLET_PRIVATE_KEY が設定されていない場合、有料ツール呼び出しでは設定方法を説明するわかりやすい 402 メッセージが返されます。/health と /openapi.json（ツールとして公開されていませんが、curl で直接アクセスできます）は、支払いなしで利用できます。

セキュリティに関する注意事項

• 秘密鍵は MCP クライアントの設定ファイルに保存されます。ホットウォレットとして扱い、自動的な支出を許容できる金額だけを入金してください。
• 推奨事項：エージェント専用の新しいウォレットを作成してください。定期的に入金し、多額の資金を保有するウォレットは再利用しないでください。
• MCP サーバーが署名するのは、anchor-x402 の既知の財務アドレス（402 レスポンスに表示）宛ての USDC 支払い承認のみです。任意のアドレスにウォレット内の資金を引き出すことはできません。
• ソースコードは github.com/hypeprinter007-stack/anchor-x402-mcp で完全に公開されています。インストールする前に監査してください。

アンカーのレシートを検証する

anchor_hash と attest_decision の呼び出しはすべて、Base と Solana のトランザクション URL を返します。これらは公開ブロックエクスプローラーで個別に検証できるため、エージェントは再度支払いをしなくてもアンカーの存在を確認できます。

• Base：https://basescan.org/tx/<base.tx> — Input Data フィールドに Merkle ルートが含まれます
• Solana：https://solscan.io/tx/<solana.tx> — Memo プログラムのデータに同じ 16 進数値が含まれます

オンチェーンのバイト列がレシートであり、API レスポンスはその内容を使いやすく提供するためのラッパーにすぎません。検証手順の全容はオンチェーン検証の入門ガイドをご覧ください。

トラブルシューティング

「Payment required (402). Set ANCHOR_WALLET_PRIVATE_KEY...」 ウォレットが設定されていません。MCP の設定に環境変数を追加し、Claude Desktop を再起動してください。

「Payment failed (402). The wallet may be out of USDC...」 ウォレットの残高が不足しています。サーバーの起動ログに表示されるウォレットアドレスに、Base 上の USDC を送金してください（標準エラー出力に payer=0x… と記録されます）。

「anchor-x402 request failed: ...」 ネットワークまたは DNS の問題です。https://api.anchor-x402.com/health が 200 を返すことを確認してください。返さない場合は、ステータスページをご覧ください。

リンク

• ライブ API： https://api.anchor-x402.com
• HTTP 経由の MCP： https://api.anchor-x402.com/mcp — 全 18 ツール、キーの受け渡し不要
• MCP サーバーカード： https://anchor-x402.com/.well-known/mcp/server-card.json
• サイト／信頼ポータル： https://anchor-x402.com
• ステータス： https://anchor-x402.betteruptime.com
• サーバーのソース： https://github.com/hypeprinter007-stack/anchor-x402
• MCP サーバーのソース（このリポジトリ）： https://github.com/hypeprinter007-stack/anchor-x402-mcp
• x402 プロトコル： https://github.com/coinbase/x402
• MCP 仕様： https://modelcontextprotocol.io

ライセンス

MIT