Sentinel Payment Boundary Tools

Sentinel Payment Boundary Tools

只读 stdio MCP 服务，提供两个用于公开支付元数据的确定性免费预检工具、一个用于本地准备公开报价请求草稿的工具，以及 Sentinel Recovery 的公开服务目录和报价请求规范。

源版本 0.4.1 强化了公开报价草稿 URL 验证和服务目录防护，同时保留 prepare_agent_payment_boundary_quote_request 和固定的 x402 v2 exact-EVM EIP-3009 安全配置文件。 带校验和的版本化 MCPB 构件发布在 GitHub Releases 页面。 此项目未发布到 npm。官方 MCP Registry 名称为 io.github.TerminallyLazy/sentinel-recovery-services；依赖已发布版本前，请先核验当前的 mcp/server.json、发布校验和及 Registry 记录。GitHub Pages 网站是静态网站，不是远程 MCP 端点。

工具

• preflight_agent_payment_boundary 分析一到两份内联公开 JSON、Markdown 或文本文档，合计上限为 100 KiB。
• 它执行 11 项固定检查，涵盖请求与支付的授权关系、付款方策略、入站与出站钱包授权、托管／签名／支出、规范支付元组、报价过期时间、重放处理、收据状态、敏感钱包输入、捐赠隔离和元数据完整性。
• 检查结果是确定性的 clear、ambiguous 或 missing，并附带有界定位符、规范化证据标记、风险及修正建议。用户提供的文本不会被复制到模型可见输出中。
• 它不会获取由请求方控制的 URL、执行文档内容、提交请求、连接钱包或转移资金。
• clear 表示存在必需的、可识别的结构化声明，且未观察到未建模的所提供内容；它不代表认证，也不验证实现行为。对于可判定为 clear 的检查，若存在未知字段或不在允许列表中的自由格式值，系统会保守地将声明降级为 ambiguous，而不是猜测其是否安全。外部摘要 URL 仍会被判定为 ambiguous，因为离线预检不会获取或信任这些 URL；完整审查可单独核验所提供的完整性证据。
• preflight_x402_v2_payment_required 使用九项固定检查，分析且仅分析一个已解码的内联 JSON x402 v2 PaymentRequired 对象。它仅接受固定的封闭世界 Sentinel 配置文件：exact、规范的 eip155:<chain-id>、EIP-3009 转账元数据、1–64 个唯一且完整的选项、正的 uint256 原子金额，以及 1–86,400 秒的超时。
• x402 配置文件有意比 x402 核心规范更严格。结构上判定为 clear 并不能证明链确实存在、代币行为符合声明、EIP-712 域正确、接收方控制某个地址、付款方策略授权了支付、签名有效、已完成结算或存在收据。Permit2、ERC-7710、非空扩展和其他未建模内容会被报告为不受支持或 ambiguous，不会被默默接受。
• prepare_agent_payment_boundary_quote_request 接受一到两个唯一的公开 HTTPS 文档 URL（不得包含凭据、查询字符串、片段或非公开主机），以及可选的公开请求详情，并为固定范围的 Agent Payment Boundary Review 准备一份完整但尚未提交的公开 GitHub issue 草稿。
• 此工具会在本地整理请求内容。它不会获取或验证所提供的 URL、发起网络请求、使用凭据、提交 issue、授权支付、包含支付指引或创建服务权益。

资源

• sentinel://services/catalog 读取并验证实时的 services.json。
• sentinel://services/quote-request-contract 读取并验证实时的 service-request.json。

读取资源、预检或准备请求草稿都不会转移资金。草稿准备工具会返回完整的公开 GitHub 请求包，但不会提交任何内容、授权任何付款，也不会创建任何服务权益。请求者仍可根据自身委托的通信政策，自行决定是否提交。Sentinel 人员仍负责出具完整的书面报价，后续的任何付款仍由付款方自己的政策控制。服务端绝不会索要凭据、密钥、签名、钱包连接、托管权限或钱包控制权。可选的 $49 审查服务会先提供报价；使用免费工具不会产生付款义务。

安装和验证

在仓库根目录中运行：

npm ci --prefix mcp --ignore-scripts
npm test --prefix mcp
npm audit --prefix mcp --audit-level=high
npm run pack:check --prefix mcp

客户端配置

将示例路径替换为已验证检出目录的绝对路径：

{
  "mcpServers": {
    "sentinel-recovery-services": {
      "command": "node",
      "args": ["/absolute/path/to/sentinel-recovery-support/mcp/server.mjs"]
    }
  }
}

客户端通过 stdio 启动 node mcp/server.mjs。服务端只会向 stdout 写入 MCP 协议消息；启动失败信息会写入 stderr。

网络和验证边界

• 仅会获取两个硬编码的规范 HTTPS URL。
• 两个预检工具都只接受内联内容，不会发起网络请求。
• 请求草稿准备工具接受调用方提供的公开 HTTPS URL，但不接受带查询字符串、片段、凭据或非公开主机的 URL；它不会获取这些 URL、验证其可用性、使用凭据、发起网络请求，也不会提交生成的公开 GitHub 问题草稿。
• 含有重复对象键的 JSON 会在求值前被拒绝；已识别字段和容器必须符合限定的类型和值域。
• 请求使用 GET，超时时间为 10 秒，响应大小上限为 256 KiB。
• 响应必须是符合预期最小契约结构的 JSON 对象。
• 上游失败时，会返回包含规范 URL 且可据以采取措施的 MCP 错误。
• 无需环境变量、API 密钥、安装脚本或钱包访问权限。

该软件包采用 UNLICENSED，因为此仓库目前未发布通用代码许可证。安装或运行源代码不会授予任何财务权限。