stillos-notary-mcp

stillos-notary-mcp

面向 Agent 经济的验证基础设施。Agent 提交一项声明；公证服务会返回经 Ed25519 签名、由哈希链串联的裁决，并依据真实的外部事实进行结算，而非依据模型输出。免费层，无需账户或信用卡。

此软件包中的每次工具调用都会通过 HTTPS 与在线公共公证服务（stillosdigitalholdings.com/notary）进行结算。不存在本地或仅供内部使用的代码路径——无论运行时如何，行为都相同。

安装

npx stillos-notary-mcp mcp

或添加到 MCP 客户端配置：

{
  "mcpServers": {
    "stillos-notary": { "command": "npx", "args": ["-y", "stillos-notary-mcp", "mcp"] }
  }
}

工具

claim_verdict

提交一项声明和解析器规范。返回 CONFIRMED、REFUTED 或 ERROR——绝不强行猜测——结果经签名并由哈希链串联。

支持的解析器类型：github_pr、onchain_tx、url_json、http_status、 kalshi_market。

stillos-notary-mcp claim "your-agent" "example.com returns 200" \
  '{"type":"http_status","url":"https://example.com","expect_code":200}'

verify_receipt

通过哈希独立验证任意收据：确认哈希链完整且签名有效。

stillos-notary-mcp verify <receipt_hash>

file_dispute

针对裁决收据提交附带保证金的争议。系统会立即依据生成该裁决时使用的相同解析器规范重新解析争议裁决——这是独立重跑，而非重新投票，也不是提交给人工申诉队列。若争议成立，裁决将被推翻，并会针对公证服务链上的正确性保证金（$10 USDC，Base）排队一笔可罚没的赔付。争议窗口：自原始收据的时间戳起 48 小时。

为付费工具付款（1.3.0）

在 1.2.2 及之前的版本中，此软件包只能报告付费墙：每个付费工具都会返回 { payment_required: true }，然后调用就此结束。软件包中没有任何方式可以附加付款并重试——CLI 会提示你“附加付款并重试”，但实际上并不存在这种机制。1.3.0 实现了这一功能。

提供凭证后，系统会自动完成 402 流程——一次 402、一次付款、一次重试，然后返回付费结果：

const { callTool } = require('stillos-notary-mcp');

// 1. Preferred: your own payment-capable fetch. We never see a key.
const r = await callTool('screen_entity', { agent: 'me', entity: 'Acme Corp' },
                         { fetch: myX402Fetch });

// 2. Or a viem account / signer object.
await callTool('screen_entity', args, { account: myViemAccount });

// 3. Or, as a documented fallback, a raw key in the environment.
//    export STILLOS_NOTARY_WALLET_KEY=0x...
await callTool('screen_entity', args);

不提供凭证时，你会收到可执行的要求，而不是无路可走：

{
  "ok": false, "paid": false, "code": "PAYMENT_REQUIRED",
  "payment": { "amount_usd": 0.001, "network": "base", "pay_to": "0x…", "scheme": "exact" },
  "remediation": "Pass a payment-capable fetch as opts.fetch, a viem account as opts.account, or set STILLOS_NOTARY_WALLET_KEY, then call again."
}

不会支付的情况。 402 属于不可信输入。客户端不会为其不期望的网络或方案签名（仅支持 base / exact），不会支付缺少 payTo 或金额的格式错误要求，也不会超过每次调用的上限（默认为 $1.50，可通过 STILLOS_NOTARY_MAX_USD 或 opts.maxUsd 修改）。重试次数绝不会超过一次——第二次 402 会直接停止，而不是进入退避循环，因此被拒绝的付款绝不会被重新签名并造成双重支付。不提供凭证绝不会产生任何支出。密钥不会被接收、记录、持久化，也不会出现在错误消息中。

由 test/payment-continuation.test.cjs 覆盖（17 个案例，使用本地模拟，不进行真实结算）。

付费：1.00 USDC（Base），通过 x402 付款——无免费层。 未附带 x402 付款的调用会返回付款要求（价格、payTo、资产），而不是裁决。此软件包不持有钱包，也不会自行执行付款；调用方 Agent 自己的客户端负责提供此能力。

stillos-notary-mcp dispute "your-agent" <receipt_hash>

screen_entity

OFAC SDN 制裁名单姓名筛查，带有 source_as_of 新鲜度时间戳，并经 Ed25519 签名。

每个 Agent 每天最多免费筛查 5 次，之后每次收费 0.001 USDC（Base），通过 x402 付款。

stillos-notary-mcp screen "your-agent" "Acme Corp"

distress_score

针对单只股票代码的资产负债表企业困境评级工具： 基于实时 SEC XBRL 文件计算 Altman Z-score，在 178 份真实 Chapter 11 申报样本和 71 份日期匹配的对照样本上，留出集 AUC 为 0.769。基准率为 2% 时，精确率约为 3%：这是用于排列审核队列的排序指标，不是针对单一公司的警报。此前的“71% 敏感度 / 100% 特异度”说法（n=14）已撤回。经 Ed25519 签名。

每个 Agent 每天最多免费使用 3 次，之后每次收费 0.15 USDC（Base），通过 x402 付款。

stillos-notary-mcp distress "your-agent" AAPL

为什么

大多数验证都是让一个模型检查另一个模型的输出——仍然存在相同的失败模式，并未引入独立性。这种架构会根据双方都无法控制的来源裁定每项主张，无论结果如何都对其签名，并将已确认和已驳回的裁决发布到同一账本。默认拒绝：无法判定的主张会返回 ERROR，而不是听起来合理的猜测。

实时文档：https://stillosdigitalholdings.com/notary/docs