402MCP.org — HTTP 402 & Agent Payment Registry

402MCP.org

HTTP 402 エージェント決済のための MCP サーバーとオープンレジストリです。

AI エージェントが 402 Payment Required を受け取ると、402MCP はサーバーがどの方式（L402、x402、MPP）に対応しているか、何が要求されているか、支払い方法と再試行方法を正確に伝えます。エージェントの支払い方法や、API がエージェントに課金する方法を開発者が選ぶ際は、明示された要件に基づいて決済レールを推奨します。いずれの場合も、その基盤となるのは、出典情報付きで評価された決済ソリューションのオープンレジストリです。

• サイト： https://402mcp.org
• リモート MCP エンドポイント： https://402mcp.org/api/v1/mcp（ストリーム可能な HTTP）
• npm： @402mcp/mcp（stdio）
• インストールガイド： https://402mcp.org/docs#install

インストール

Claude Code：

claude mcp add --transport http 402mcp https://402mcp.org/api/v1/mcp

任意の stdio MCP クライアント（Claude Desktop、Cursor、Windsurf など）：

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

MCP サーバー

トランスポートに依存しない単一のコア（lib/mcp/）がホスト型エンドポイントと stdio パッケージの両方を提供するため、どちらも同じツール、リソース、プロンプトを公開します。

ツール	目的
decode_402_challenge	402 レスポンス（L402 macaroon と BOLT 11 invoice、x402 v1/v2、MPP）を解析し、次の手順と再試行ヘッダーを正確に示します
recommend_payment_rail	役割、資産、カストディ、インフラストラクチャ、ネットワーク、方式、MCP 対応状況、成熟度で絞り込み、評価基準の重みを調整し、各除外理由を説明します
search_402_solutions	フィルターを使ってレジストリを検索します
get_solution	出典情報とコードサンプルを含む、1 つのエントリーの全情報を取得します
get_scheme_reference	L402、x402、MPP のワイヤーフォーマットを取得します
probe_402_support	公開 URL に GET を 1 回送信し、402 に対応しているかを確認します。支払いは行いません
get_best_payment_solution	合成スコアが最も高いエントリーを取得します

リソース：402mcp://registry、402mcp://methodology、 402mcp://solutions/{id}、402mcp://schemes/{scheme}。プロンプト： choose_payment_rail、handle_402_response。すべてのツールに readOnlyHint が注釈されています。

安全性。 402 レスポンス内のすべての情報はサーバーによって制御されるため、デコーダーはそれらのフィールドを untrusted_fields に列挙し、そのテキストを指示として再掲することはありません。有効期限切れのチャレンジや、invoice とは異なる支払いハッシュを確定する macaroon にフラグを立てます。プローブは、プライベート、ループバック、リンクローカル、メタデータの各アドレス（これらのアドレスに解決されるホスト名を含む）およびウェブ用以外のポートへのアクセスを拒否し、ホスト型エンドポイントはクライアントごとにレート制限を適用します。金銭を支払うツールはありません。

マシンインターフェース

エンドポイント	目的
POST /api/v1/mcp	MCP（JSON-RPC 2.0、ストリーム可能な HTTP）
POST /api/v1/decode	402 レスポンスを解析します
GET /api/v1/recommend	要件に基づいて決済レールを推奨します
GET /api/v1/probe?url=	URL が 402 に対応しているかを確認します（レート制限あり）
GET /api/v1/solutions	バージョン管理された一覧（?q=、?id=、?view=full）
GET /api/v1/registry	ETag / 304 対応の正規フィード
GET /api/v1/schemes/{scheme}	L402、x402、MPP のワイヤーフォーマット
GET /api/v1/status	すべてのエントリーのドキュメントとウェブサイトの毎日の稼働状況
GET /api/v1/changelog · /changelog.xml · /changelog	変更と訂正
/schema/v1/registry.json · /schema/v1/solution.json	JSON スキーマ（draft 2020-12）
/openapi.json	OpenAPI 3.1
/llms.txt · /llms-full.txt	プレーンテキストのインデックス
/.well-known/402.json · api-catalog · mcp/server-card.json · agent-skills/	ディスカバリー

Accept: text/markdown を指定してリクエストすると、どのページも Markdown を返します。

方法論

各エントリは、カストディと主権、運用上の手間、エージェントネイティブなサポート、決済手段と資産、決済速度と手数料、開発者エクスペリエンスの6つの基準について、それぞれ同じ重みで1〜10のスコアを付けています。スコアは単純平均で、順位は平均値の順です。同点の場合はアルファベット順で順位を決めます。各エントリには、情報源、主張を最後に確認した日付、ベンダーまたはリリース履歴に基づく成熟度ラベルが記載されています。

最新のランキングは https://402mcp.org および /api/v1/registry で確認できます。方法論の全文は https://402mcp.org/docs#methodology にあります。

402MCP.org は、掲載しているいずれのベンダーとも提携、支援、報酬の受領をしておらず、掲載順位を購入することもできません。情報に誤りや古い情報がある場合は、修正に応じてデータを更新し、ランキングにも反映したうえで、変更を変更履歴に記録します。

開発

Node 18.18 以降が必要です。

npm install
npm run dev            # http://localhost:3000

コマンド	内容
npm run test:unit	BOLT 11 仕様、MPP ドラフト、参照用に発行されたマカロン、x402 の形式に基づくベクトルを使ったデコーダーテスト
npm run verify:agents -- [url]	すべてのマシン向けエンドポイントを検証します：形式、コントラクト、JSON-RPC の動作、スキーマ検証、データセットの不変条件
npm run verify:seo -- [url]	クローラー向けディレクティブ、メタデータ、構造化データ、アイコン、ディスカバリードキュメント、フィード、ヘッダー
npm run build:package	stdio パッケージとデスクトップ拡張機能 .mcpb をビルドします
npm run verify:stdio -- [registryUrl]	ビルド済み stdio パッケージをエンドツーエンドで検証します
npm run lint · npm run typecheck	ESLint と TypeScript

検証スイートの既定の接続先は http://localhost:3000 です。デプロイ環境に対して実行するには URL を渡してください。

Cloudflare へのデプロイ

このサイトは OpenNext アダプターを介して Cloudflare Worker として動作します。wrangler.example.jsonc を wrangler.jsonc にコピーし、指定されている KV 名前空間を作成して、独自の値を入力してください。次に、以下を実行します。

npm run cf:build
npm run cf:deploy

プロジェクトの構成

data/solutions.ts     The registry dataset; scores and ranks are computed here
data/changelog.ts     Additions and corrections, with reasons
lib/decode/           bech32, BOLT 11, macaroons, RFC 9110 challenges, x402, MPP
lib/mcp/              Transport-agnostic MCP server: tools, resources, prompts
lib/recommend.ts      Requirement-driven recommendation
lib/probe.ts          URL probe with SSRF guards
lib/schemes.ts        Wire-format reference for each scheme
lib/liveness.ts       Daily docs and website checks
app/                  Next.js App Router pages and route handlers
worker.ts             Worker entry: OpenNext handler plus the scheduled liveness job
packages/402mcp/      The @402mcp/mcp stdio package
server.json           Official MCP Registry entry
tests/ · scripts/     Unit tests, verification suites and the package build

ライセンス

コード：MIT（LICENSE を参照）。レジストリデータ：CC BY 4.0。