402MCP.org — HTTP 402 & Agent Payment Registry

402MCP.org

面向 HTTP 402 Agent 支付的 MCP 服务和开放注册表。

当 AI Agent 收到 402 Payment Required 时，402MCP 会告知它服务使用哪种方案（L402、x402 或 MPP）、请求支付什么内容，以及如何准确付款并重试。当开发者在选择 Agent 应采用的支付方式，或 API 应如何向 Agent 收费时，它会根据已声明的需求推荐支付通道。这两项功能背后，都是一个收录有来源、经过评分的支付解决方案开放注册表。

• 网站： 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 账单、x402 v1/v2、MPP）解码为准确的后续步骤和重试标头
recommend_payment_rail	按角色、资产、托管方式、基础设施、网络、方案、MCP 支持情况和成熟度进行筛选；重新调整各项标准的权重；说明每一项排除原因
search_402_solutions	使用筛选条件搜索注册表
get_solution	获取一项完整条目，包含来源和代码示例
get_scheme_reference	获取 L402、x402 或 MPP 的线路格式
probe_402_support	向公共 URL 发送一次 GET 请求，查看其是否支持 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 中列出这些字段，且绝不会将其文本作为指令重复输出。它会标记已过期的质询，以及承诺的支付哈希与账单中的支付哈希不同的 macaroons。探测工具会拒绝私有、环回、链路本地和元数据地址（包括解析到这些地址的主机名）以及非 Web 端口，托管端点还会按客户端对其进行速率限制。没有任何工具可以花费资金。

机器接口

端点	用途
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 Schema（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。

方法论

每个条目都按六项同等权重的标准打分，范围为 1–10：托管与主权、运营阻力、Agent 原生支持、支付渠道与资产、结算速度与费用，以及开发者体验。总分为未加权平均值，排名按平均分排序；若分数完全相同，则按字母顺序排序。每个条目都会列出来源、相关声明最近一次核实的日期，以及根据供应商信息或其发布历史确定的成熟度标签。

当前排名可在 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 草案、参考实现 mint 的 macaroon 和 x402 格式的测试向量进行解码器测试
npm run verify:agents -- [url]	验证所有机器端点：格式、契约、JSON-RPC 行为、架构校验、数据集不变量
npm run verify:seo -- [url]	验证爬虫指令、元数据、结构化数据、图标、发现文档、Feed、标头
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。