Factline X402 Health

@pipeworx/factline-x402-health

x402 卖家和 Facilitator 的健康状况：Factline 每晚探测卖家、每小时探测 Facilitator，并在每次请求时代理实时数据。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1858+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• x402_facilitator_health(facilitator?) -- 所有受追踪的 x402 Facilitator 的当前状态（正常/异常/未知）、7 天正常运行时间、延迟和支持的网络；也可按 ID、名称或 URL 查询单个 Facilitator。每小时刷新。
• x402_seller_health(query?, tag?, network?, limit?) -- 按 30 天付款人数排名的 x402 卖家列表，每个卖家附有夜间探测的健康状况（健康/降级/不健康/数据不足/未探测）。每次调用最多返回 100 个；使用 query、tag 或 network 缩小范围以查看其余结果。
• x402_seller_lookup(origin) -- 按 origin、host 或 URL 查询单个卖家：每日探测历史、正常运行时间、已列出的 payTo 钱包及健康状况。向卖家付款前请先使用此工具。

每条响应都包含 source、cite_as、cadence、data_as_of 和 warnings。

身份验证

无需密钥。Factline 免费提供这些数据源，供 Agent 使用。

数据源

• Factline，x402 Seller Health Index——每晚探测公开 x402 目录中列出的卖家。
• Factline，x402 Facilitator Health——每小时探测 x402 Facilitator。

引用格式为“Source: Factline (factline.dev)”。更新频率：卖家为每晚，Facilitator 为每小时；data_as_of 表示最近一次探测的时间，当数据比更新频率所示时间更旧时，会出现 warnings 条目。

解读结果

• 未找到不代表健康。found:false 或 count:0 表示未知或未匹配，绝不表示“正常”。此工具包会在载荷中说明这一点。
• 卖家数据源每次请求最多列出 100 个卖家，且不支持分页（约追踪 1,000 个）；coverage_note 会说明覆盖范围。
• health 和 status_now 是此工具包根据 Factline 的数据得出的判断（规则见 health_basis / status_basis），并非 Factline 自己的结论。需要 API 密钥的 Facilitator 仅会在 /supported 上接受探测（verify_tested: false）。
• 卖家探测会检查样本端点能否回应有效的支付质询；不会进行付款，也不代表卖家所售内容的质量。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "factline-x402-health": {
      "url": "https://gateway.pipeworx.io/factline-x402-health/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/factline-x402-health/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关级别的其他工具。因此，你看到的工具数量会多于此表：目前，单工具包端点除了工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是特定日期范围的权威信息。

这是有意如此，并非意外的多路复用。元工具让受限连接能够回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请连接一次完整网关，而不要连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一网关和同一批 1858+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/x402_facilitator_health \
  -H 'Content-Type: application/json' \
  -d '{"facilitator":"payai"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/x402_facilitator_health。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

从 npm 运行

@pipeworx/mcp-factline-x402-health 是连接到 Pipeworx 网关的本地 stdio 桥接程序：MCP 客户端通过 npx 启动它，它会将每次调用转发到上文所示的同一 https://gateway.pipeworx.io/factline-x402-health/mcp 端点。它需要网络连接； 不支持离线模式。

{
  "mcpServers": {
    "factline-x402-health": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-factline-x402-health"]
    }
  }
}

不使用密钥时，它会以匿名方式调用，每天最多 50 次。注册免费账户后， 每天的调用上限会提高到 200 次：前往 https://pipeworx.io/signup 获取密钥，并在服务条目中添加 "env": { "PIPEWORX_API_KEY": "<your key>" }。 密钥会以 Bearer 令牌的形式发送，与托管连接的发送方式相同， 因此调用会按与托管连接完全相同的方式计量和计费。

默认情况下，它只列出此工具包中的工具。设置 PIPEWORX_META_TOOLS=1 后， 还会列出 ask_pipeworx 和其他网关级工具。

使用 HTTPS 代理时：Node 内置的 fetch 默认不会读取 HTTPS_PROXY。较新的 Node 版本在设置 NODE_USE_ENV_PROXY=1 后会遵循该变量；请查阅你的 Node 版本文档。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具 — 这在上文的工具包端点和完整网关上均适用：

ask_pipeworx({ question: "your question about Factline X402 Health data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT