nsgoods-workbench-mcp

nsgoods Workbench MCP

每周 x402 目录扫描结果的只读索引。哪些端点可付费、价格是多少、哪些主机已失效。
无需钱包。无需登录。此服务不处理任何付款。

可以查询什么

一个托管的 Model Context Protocol 服务，基于我们对 x402 目录进行的每周完整扫描：某个端点是否可付费、价格是多少、哪些主机已失效、哪些端点匹配某个关键词，以及 nsgoods 签名响应能否离线验证。

托管端点：https://mcp.nsgoods.org/mcp（Streamable HTTP，无需登录，每个 IP 每天可调用 300 次工具）。首页和文档：https://mcp.nsgoods.org/ · 健康状态：https://mcp.nsgoods.org/health

数据反映最近一次完整扫描时的状态。每条回答都附带 as_of 和扫描 ID。付款前若要实时检查某个端点，请使用中心的付费 /payable 预言机。此服务是索引。

连接

Claude（网页端或桌面端）

1. 依次选择 Settings、Connectors、Add custom connector
2. 名称：nsgoods。URL：https://mcp.nsgoods.org/mcp。无需登录。
3. 开启新对话，然后尝试提问：使用 nsgoods，找出 Base 上用于制裁筛查的最便宜可付费端点

Cursor：添加到 mcp.json

{"mcpServers":{"nsgoods":{"url":"https://mcp.nsgoods.org/mcp"}}}

Smithery：https://smithery.ai/servers/nikosble1926/nsgoods-workbench

任何支持 Streamable HTTP 的 MCP 客户端都可以用同样的方式连接。

工具

工具	可以查询什么
find_endpoints	按主机或关键词搜索目录，查看最新判定和每个端点的观测价格；可选按价格排序
payability_verdict	查询某个确切 URL 的判定、历史记录、修复提示和价格
catalogue_stats	目录规模、各判定的数量、每个网络的可付费端点数、中位价格
host_summary	按主机查看判定分布、首次和最近出现时间，以及失效时间
drift_status	查看不同扫描之间的判定变化
x401_status	当前 x401 发出方数量
verify_signature	根据我们的清单离线验证任何 nsgoods 签名响应
reports	每周可付费性报告的链接

所有工具均为只读且幂等（通过 MCP 工具注释声明）。

判定：PAYABLE、NOT_PAYABLE、MALFORMED_402、CANNOT_PAY_EITHER_VERB、UNREACHABLE、SKIPPED、UNKNOWN。

示例

一次实时的 find_endpoints("erc20-balance", 2) 调用，结果精简为两行：

{
  "query": "erc20-balance",
  "total_matches": 6,
  "returned": 2,
  "endpoints": [
    {
      "resource": "https://api.onesource.io/api/chain/erc20-balance",
      "host": "api.onesource.io",
      "last_verdict": "PAYABLE",
      "host_gone_since": null,
      "price": "0.003 USDC on eip155:8453"
    },
    {
      "resource": "https://app.heinrichstech.com/v1/cdp/chain/erc20-balance",
      "host": "app.heinrichstech.com",
      "last_verdict": "PAYABLE",
      "host_gone_since": null,
      "price": "0.003 USDC on eip155:8453"
    }
  ],
  "as_of": "2026-09-13",
  "index_scan_id": "scan-20260913T050332Z"
}

数据与时效

每次每周完整扫描后都会重建索引（截至 2026 年 9 月 13 日，共有 14,652 个资源、1,971 个主机，其中 13,146 个可付费）。价格来自对 402 个挑战的扫描（10,958 个端点有定价，中位数为 0.01 USDC，扫描日期为 2026 年 9 月 16 日）。每个端点的样本均仅包含 GET 重新探测结果，按行发布，采用 CC BY 4.0 许可：https://x402.nsgoods.org/proof/payability-sample-2026-09-13.json

不再出现在最新完整 CDP Bazaar 扫描中的资源，会在单独的重新探测扫描中每周重新探测：仅包含非 PAYABLE 行，按最早日期优先，每周最多 1,500 行。这些行的 in_latest_scan=false，并带有各自的 last_checked_at 和 verdict_since；最新完整扫描的数字（catalogue_stats、/health）不包含这些行。

运行你自己的扫描

python -m venv venv && venv/bin/pip install -r requirements.txt

将你自己的 scans.jsonl（每次探测一行 JSON，字段见 build_index.py）放在脚本旁边，然后：

venv/bin/python build_index.py
venv/bin/python server.py   # listens on 127.0.0.1:4036, path /mcp

Docker：

docker build -t nsgoods-workbench-mcp . && docker run -p 4036:4036 nsgoods-workbench-mcp

Docker 镜像未经测试（在没有 Docker 主机的情况下构建）。在容器内设置 WORKBENCH_HOST=0.0.0.0。欢迎反馈。

环境变量：

var	默认值	含义
WORKBENCH_DIR	.	索引和数据文件的基础目录
WORKBENCH_DATA_DIR	WORKBENCH_DIR	scans.jsonl 和监视状态目录
WORKBENCH_HOST	127.0.0.1	绑定地址

如果首次运行时没有索引，服务会创建一个空索引，因此在加载任何数据之前，tools/list 就可以正常工作。

隐私与日志记录

此服务无需钱包，也无需登录。它会保留最少量的工具使用记录，以便我们运营服务并限制调用速率。

• 每次工具调用都会存储：时间戳、工具名称、参数名称和长度，以及 ip_h（调用方 IP 的每日密钥哈希）。我们不会存储参数值，也不会存储原始 IP 或 MCP 会话 ID。
• 客户端连接时，我们会存储：时间戳、ip_h、用户代理、客户端报告的名称和版本，以及客户端请求的协议版本。当对 /mcp 的请求失败时，我们会存储：时间戳、ip_h、用户代理、HTTP 方法和状态、JSON-RPC 方法名称、是否发送了会话 ID、MCP-Protocol-Version、Accept 和 Content-Type 标头，以及错误信息的前 160 个字符。绝不存储 params 或参数。
• ip_h 是 HMAC-SHA256(daily_secret, ip)，截取前 16 个十六进制字符。密钥为随机值，仅保存在内存中，每次 UTC 日期变更时替换，且从不写入磁盘，因此日期结束后无法将哈希关联回 IP。
• 同一个 ip_h 用于执行每位调用方每天 300 次工具调用的免费额度限制。如果服务在 UTC 日期内重启，会生成新密钥，因此当天剩余时间内所有人的计数都会重置。
• 记录将在 30 天后删除。2026 年 9 月 26 日之前写入的记录采用更完整的格式（调用方 IP、会话 ID 和每个参数的前 80 个字符）；这些记录也会按相同的计划删除，最晚于 2026 年 10 月 26 日全部删除。

当前字段列表和保留期限也会通过 GET /health 中的 tool_log 和 client_log 实时报告。

验证

已签名的 nsgoods 响应使用 EIP-191 对规范化 JSON 进行签名（键已排序，分隔符紧凑，ASCII 字符已转义，哈希前移除 signature 和 signed_by）。verify_signature 工具会将恢复出的地址与 https://x402.nsgoods.org/proof/index.json 中的签名者进行核对。

验证实际运行的内容。python3 scripts/pin_verify_signature.py server.py 会输出 verify_signature 函数体的行范围、字节范围和 sha256（从 def 到函数体末尾，不含装饰器，使用 LF 换行，不带尾随换行），以及整个文件的 sha256。哈希匹配只能作为代码库证据：它表明发布的源代码就是所描述的代码。这并不能证明部署内容。验证服务器实际运行内容的更有力证据来自行为：调用在线工具，并检查结果是否与此源代码产生的结果一致。

Links

Landing https://mcp.nsgoods.org/ · Hub https://x402.nsgoods.org · MCP section https://x402.nsgoods.org/#mcp Weekly report https://x402.nsgoods.org/proof/payability-report-2026-09-13.html Methodology https://x402.nsgoods.org/ata-audit/payability_index.json (method field)

MIT license.