x402-list 是一个收录接受 x402（HTTP 402 稳定币）支付服务的目录，它会监控已收录服务的在线率、响应时间和状态，并在链上衡量 facilitator 的结算量。x402-list-mcp 是该目录的 MCP 服务器封装，让 AI 代理可以通过 Model Context Protocol 访问这些信息。
用途 该包用于发现 x402 支付 API、检查在线率与定价，并通过 MCP 按 facilitator 查看经链上验证的结算量。它是公共 x402-list HTTP JSON API 的轻量包装：不持有密钥、不接触数据库、不向目录写入任何内容。
主要能力 它通过 MCP 向 AI 代理暴露七个工具：其中六个免费且只读，第七个 x402_assess_services 是唯一付费工具，属于透传，中继你在客户端自行签名的 x402 支付挑战；该包本身从不持有密钥、从不签名、从不结算。关于评分，x402_find_best_service 会在 ranking_version 中返回评分世代，分数只能在同世代内比较。Generation 2 在观察到某服务至少一条 EVM 路由缺少标准 x402 客户端签名支付所需的 EIP-712 域参数（extra.name、extra.version）时，将合规项封顶为 0.6，即 C 档下限；这是关于线上信封的事实，不是对服务本身价值的评判。Generation 3 在牵引力项上新增反刷量规则：30 天结算量绝对下限为 10 美元，低于下限该项计 0，因为低于下限的量与尘埃无法区分，不应影响排名；当单一买家贡献全部结算量时，对集中支付给予折扣，最高可减半牵引力项，因为一个买家只是一段关系，不是该项意在奖励的广泛需求；未发布可映射 payTo 的服务现在该项计 0，而不是把权重归一化掉，因此隐藏收款地址不再优于有可测量地址。所有金额均为十进制美元并原样传递，没有任何分单位换算。每端点 pricing[].price 字段是原始原子链上代币金额（uint256 字符串），不是美元；只有 price_usd 是美元数字。请勿混淆两种链上交易量信号：facilitator 交易量（x402_facilitator_volumes）是生态头条，按 facilitator 汇总；每服务牵引力（每个服务上的 traction 块，在 x402_find_best_service 中权重约 10%）是通过被认可的结算者对服务自身 payTo 测量的结算量，属于刻意保守的低估而非估计：未归属的结算被排除，从不放大。当 payTo 被多个服务共享（shared_payout: true）时，只有结算量按比例归属——该地址上的运营者级交易量在共享该地址的服务间分摊，这是声明性约定而非单独观测的度量，而交易笔数和唯一买家保持完整的运营者级整数；某服务所在网络尚未被测量，或共享收款成员探测持续失败，则完全不带牵引力项，其余权重在其上重新归一化。切勿把共享、按比例或未测量的交易量读作单个服务的收入。要问“哪些 facilitator 有真实链上交易量”，请使用 x402_facilitator_volumes 并读取 verification 标志。
使用方式 使用 Streamable HTTP 连接托管服务器 https://mcp.x402-list.com/mcp，或本地通过 stdio 运行 npm 包。本地使用需要 Node.js 20 或更高版本及 npm；托管连接无需本地安装 Node.js。选择一种传输方式。托管服务器可加入 Cursor：安装链接对应的配置与 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）中的手动条目相同。VS Code：将相应条目加入项目中的 .vscode/mcp.json，然后在编辑器启动服务器并在 Copilot 代理模式中使用。Codex：用 Codex CLI 添加托管服务器，或将条目加入 ~/.codex/config.toml；CLI 与 IDE 扩展共享此配置。Claude Desktop 及其他本地 stdio 客户端：将条目加入 claude_desktop_config.json 或等价的 stdio 客户端配置，然后重启客户端；客户端会启动与你在终端运行的相同命令。自托管 Streamable HTTP：在 POSIX shell 中运行自己的 HTTP 实例，客户端连接 http://localhost:3000/mcp，健康探针 http://localhost:3000/healthz 返回 {"status":"ok"}。
适用场景 适合需要让 AI 代理查询 x402 支付服务目录、比较服务价格与在线率、检查 facilitator 结算量的开发者和代理构建者。
限制 免费工具只读；付费工具仅透传由客户端签名的支付挑战，包不持有密钥、不签名、不结算。本地运行需要 Node.js 20+ 和 npm。具体环境变量、配置命令原文以及各类配置文件的完整示例，资料中仅以占位形式提及，具体内容暂未提供。
