x402 Conformance

Name: x402 Conformance
Author: atsp-protocol

本地服务

github.com开发工具11 天前更新

代码仓库访问官网

关于 x402 Conformance

x402 Conformance 为开发者和 Agent 提供 x402 支付检查，用于测试支持支付的服务端。它与测试套件的 CLI 和 CI 集成共用检查与报告，且不会付款、签名或访问主网。

主要功能

01验证未付款时的 402 响应
02探测服务端结算安全性
03运行内置演示检查
04说明检查项与失败原因
05准备匿名失败案例

适用场景

01检查付费端点的 402 响应
02验证结算前不会提供内容
03用演示服务端复现检查

MCP 相关

MCP 服务将 x402 一致性检查和相关功能作为工具提供。结算协调器模拟器和资源服务端探测工具仅在 MCP 中提供；服务不会付款或签名。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "atsp-protocol-x402-conformance": {
      "command": "npx",
      "args": [
        "-y",
        "x402-conformance-mcp"
      ]
    }
  }
}

启动命令npx -y x402-conformance-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402-conformance-mcp1.6.0stdio

ocighcr.io/atsp-protocol/x402-conformance:1.6.0stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
url	string	是	付费 URL，http 或 https

详细介绍

x402-conformance-mcp

将 x402 一致性与安全检查作为工具提供，供 MCP 客户端（Claude、Cursor、VS Code、Windsurf 等）、Vercel AI SDK 和 LangChain 使用。这是进入开源 x402-conformance 测试套件的轻量入口：它与命令行工具、GitHub Action 和测试匹配器使用相同的检查、检查 ID 和报告。它绝不会付款、签名或触及主网。

MCP

{ "mcpServers": { "x402-conformance": { "command": "npx", "args": ["-y", "x402-conformance-mcp"] } } }

工具	功能
`x402_check_payment_required`	向付费 URL 发送一次未付款的 GET 请求；检查其 402 响应（P1-P7）
`x402_demo`	使用内置演示服务运行完整测试套件，无需钱包或设置；`fault: serve_on_any_settle` 会展示一次失败
`x402_start_facilitator_double`	在回环地址上启动 facilitator double；将你的服务指向其 URL
`x402_probe_resource_server`	在回环地址上针对你的服务运行 R0-R10 检查：超时、响应异常、`settlement_pending`、失败或重复时不返回内容
`x402_stop_facilitator_double`	停止 double
`x402_explain_check`	说明检查的测试内容，以及如何修复失败
`x402_share_case`	提供一个匿名化语料库案例和预填好的问题链接；不会发送任何内容，由用户决定

可以尝试询问：“运行 x402 演示”“检查 http://127.0.0.1:4020/paid 的 402 响应”，或“启动 facilitator double，我会让我的服务指向它，然后探测 http://127.0.0.1:4020/paid”。

Vercel AI SDK

import { generateText } from "ai";
import { x402ConformanceTools } from "x402-conformance-mcp/ai-sdk";

await generateText({ model, tools: x402ConformanceTools(), prompt: "Is the 402 answer at https://api.example.com/paid valid x402?" });

LangChain 和 LangGraph

import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { x402ConformanceTools } from "x402-conformance-mcp/langchain";

const agent = createReactAgent({ llm, tools: x402ConformanceTools() });

AI SDK 和 LangChain 适配器为 Agent 提供四个只读工具（检查、演示、说明、分享）。double 和探测工具保留在 MCP 中，由人来操作。

语料库

失败报告可以转化为匿名化案例，加入公开的 x402 真实故障语料库。 x402_share_case 会准备案例并返回链接；用户可以查看并提交，也可以不提交。每份报告都会在报告和 User-Agent 中注明生成该报告的入口（via: mcp、ai-sdk 或 langchain）；没有其他标识符，也没有遥测数据。

Apache-2.0。Ryan Gillespie，Optitransfer。

支持 Markdown

登录后评论