trustverdict

trustverdict

エージェント、リポジトリ、パッケージ、またはMCP サーバーを接続する前に、信頼に値するかを確認しましょう。trustverdictは、その問いを信頼性検証サービスに投げかけ、署名付きの回答を返します。判断の根拠となる理由が1つ添えられた、行動に移せる判定、0～100の信頼スコア、そしてその根拠となる検出結果が得られます。対象範囲全体をカバーする読み取り専用ツールが8つあり、アカウントもAPIキーも不要です。すべての呼び出しは匿名で行われます。

スキャン結果は、サービスが発行したとおりに返されます。結果は署名付き証明書であり、サービス自身が出力したものであることに価値があり、オフラインで再計算できるため、ローカルでスコアを再計算したり、名前を変更したり、要約したりすることはありません。

設定

クライアントは1つの環境変数で制御します。

• AGENTAVOW_URL（任意） — サービスのベースURLです。 既定値はhttps://agentavow.comです。

APIキーも認証ヘッダーもありません。

ツール

• scan_repo — owner/name形式で指定した公開GitHubリポジトリをスキャンします。回答の先頭には判定、署名付きの0～100の信頼スコア、採用スコアが表示されます。
• scan_package — 名前でパッケージをスキャンします。任意のecosystemで、登録先のレジストリ（npm、 PyPI、crates、Docker、またはHugging Face）を指定できます。
• scan_mcp_server — 稼働中のMCPサーバーの urlを指定します。ツール定義に対するポイズニングとプロンプトインジェクションを検査します。
• verify_trust — agentのIDを解決し、現在の信頼スコアを取得します。
• check_interaction_safety — 作業の委任や取引など、特定のinteractionをagentと行うことが安全かを確認します。
• lookup_identity — DID（did:web:…または did:key:…）を解決するか、1つのqueryで名前からエージェントを検索します。
• get_trust_badge — agentのShields風バッジを取得します。SVG URLと、すぐに貼り付けられるREADME用Markdownが含まれます。
• about_agentavow — サービスがどのように判定を下すか、判定の読み方を説明します。このツールはローカルで回答し、リクエストを送信しません。

判定の読み方

すべてのスキャン結果の先頭にはdecision（safe、review、または do_not_connect）と、それを引き起こしたdecision_reasonが表示されます。続いてsummary、0～100の署名付きtrust_score、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）

2つのGETパスのagentセグメントとq=の値はURLエンコードされます。about_agentavowにはワイヤーパスがありません。

CLI

各ツールは、JSON引数文字列を1つ受け取るサブコマンドです。

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