trustverdict

trustverdict

在连接 Agent、代码仓库、软件包或 MCP 服务之前，先问问它是否值得信任。trustverdict 会将 这个问题提交给信任验证服务，并返回其签名答复：可据此采取行动的决策、导致该决策的唯一原因、0–100 的信任评分，以及背后的发现。八个只读工具覆盖了所有场景，而且都无需账号或 API 密钥——每次调用都是匿名的。

扫描结果会原样返回，与服务给出的结果完全一致。不会在本地重新评分、重命名或概括，因为结果是一份签名证明：其价值在于它就是服务自身的输出，可离线重新计算。

配置

一个环境变量即可控制客户端：

• AGENTAVOW_URL（可选）——服务的基础 URL。 默认为 https://agentavow.com。

无需 API 密钥，也无需认证标头。

工具

• scan_repo——扫描公开的 GitHub 仓库，格式为 owner/name。答复首先给出决策、带签名的 0–100 信任评分，以及采纳评分。
• scan_package——按名称扫描软件包；可选的 ecosystem 用于指定其所属的注册表（npm、 PyPI、crates、Docker 或 Hugging Face）。
• scan_mcp_server——提供正在运行的 MCP 服务的 url；系统会检查其工具定义是否存在投毒和提示词注入。
• verify_trust——解析 agent 身份并获取其当前信任评分。
• check_interaction_safety——询问与某个 agent 进行特定 interaction（例如委派工作或交易）是否安全。
• lookup_identity——解析 DID（did:web:… 或 did:key:…），或通过一个 query 按名称搜索 Agent。
• get_trust_badge——获取某个 agent 的 Shields 风格徽章：SVG URL 以及可直接粘贴到 README 的 Markdown。
• about_agentavow——介绍服务如何作出判定以及如何解读判定。此工具在本地响应，不会发出请求。

解读判定

每次扫描都会首先给出 decision——safe、review 或 do_not_connect——以及触发该决策的 decision_reason，随后是 summary、带签名的 trust_score（范围为 0 到 100）、tier、主体是否 certified、adoption 评分以及各项发现。另有一个二元 verdict（safe 或 needs_review），并附带其自身的 verdict_reason： clean、blocking_findings、thin_coverage 或 low_signals。扫描证明采用 Ed25519 签名 （JWS），可离线重新计算。

验证与错误

所有请求发出前都会先进行验证。参数为空或缺失时，会报错 <arg> must be a non-empty string；此外， scan_repo 还要求参数符合 owner/name 格式，不符合时会报错 repo must look like owner/name。 上游返回非 2xx 响应时会报错 agentavow error: HTTP <status>；服务不可访问时会报错 agentavow unreachable。

端点来源

下列每个请求路径都是标注为重构的路径：文档说明了服务的工具接口、基础 URL 和判定词汇，但没有指定各工具的实际请求路径，因此这些路径是依据文档中说明的基础 URL 和 REST 惯例重构得出的。

• POST /api/scan/repo——重构（scan_repo）
• POST /api/scan/package——重构 （scan_package）
• POST /api/scan/mcp-server——重构 （scan_mcp_server）
• GET /api/agents/<agent>/trust——重构 （verify_trust）
• POST /api/interaction-safety——重构 （check_interaction_safety）
• GET /api/identity?q=<query>——重构 （lookup_identity）
• GET /api/agents/<agent>/badge——重构 （get_trust_badge）

两个 GET 路径中的 agent 片段以及 q= 值都会进行 URL 编码。about_agentavow 完全不会发出网络请求。

命令行

每个工具都是一个子命令，接收一个 JSON 参数 字符串：

npx @reneturcios/trustverdict scan_repo '{"repo":"octocat/hello-world"}'
npx @reneturcios/trustverdict scan_package '{"package":"express","ecosystem":"npm"}'
npx @reneturcios/trustverdict scan_mcp_server '{"url":"https://example.com/mcp"}'
npx @reneturcios/trustverdict verify_trust '{"agent":"did:web:example.com"}'
npx @reneturcios/trustverdict check_interaction_safety '{"agent":"did:web:example.com","interaction":"delegate"}'
npx @reneturcios/trustverdict lookup_identity '{"query":"did:web:example.com"}'
npx @reneturcios/trustverdict get_trust_badge '{"agent":"did:web:example.com"}'
npx @reneturcios/trustverdict about_agentavow '{}'
npx @reneturcios/trustverdict --version

输出为工具的结果文本（成功时为上游 JSON）。退出码：成功时为 0，运行时错误（包括验证或上游失败）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/trustverdict mcp

MCP 客户端配置：

{
  "mcpServers": {
    "trustverdict": {
      "command": "npx",
      "args": ["-y", "@reneturcios/trustverdict", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/trustverdict
docker run --rm ghcr.io/cloudcorprecords/trustverdict scan_repo '{"repo":"octocat/hello-world"}'

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios