trustscoreagent

TrustScoreAgent

AI マイクロサービス向けの無料でオープンな評判レジストリです。エージェントはサービスを呼び出す前に、信頼スコアを確認します。

ステータス：フェーズ 1（初期段階）。 API、スコアリング（Beta ＋ EigenTrust）、レシート検証、 Merkle 監査証跡、MCP サーバーは実装およびテスト済みですが、公開データセットは まだ小規模です（公開 API と x402 エンドポイントを透明性のある方法で調査して登録しています）。設計の一部 （x402 による支払い、エージェント署名の必須化）はフェーズ 2 の予定です。私たちが意図的に 早期からオープンに公開しているのは、エージェント経済の信頼レイヤーは、重要なものになる 前に存在し、監査可能で、採用できる状態であるべきだからです。SECURITY.md の信頼モデルをご覧ください。

これは何ですか？

AI エージェントは、有料のマイクロサービスへの依存をますます強めています。TrustScoreAgent を使うと、あらゆるエージェントが次のことを行えます。

• サービスを呼び出す前に、その評判を確認する
• サービスを呼び出した後に、そのサービスを評価する
• 信頼できるサービスを見つける

アカウントは不要です。API キーも不要です。URL、ドメイン、または DID でサービスを識別します。

クイックスタート

# Check a service's trust score (any format works)
curl "https://api.trustscoreagent.com/v1/score?service=api.example.com"
curl "https://api.trustscoreagent.com/v1/score?service=https://api.example.com/v1/translate"

# Unknown services return a neutral score (0.5), no errors
curl "https://api.trustscoreagent.com/v1/score?service=never-seen-before.com"

# Rate a service after calling it
curl -X POST "https://api.trustscoreagent.com/v1/rate" \
  -H "Content-Type: application/json" \
  -H "X-Agent-DID: my-agent.example.com" \
  -d '{
    "service": "api.example.com",
    "metrics": {
      "status_code": 200,
      "latency_ms": 143,
      "schema_valid": true
    }
  }'

# List top-rated services
curl "https://api.trustscoreagent.com/v1/services?sort_by=score&min_ratings=10"

ローカル開発

# Start PostgreSQL and Redis
docker compose up -d

# Run the API
dotnet run --project src/TrustScore.Api

# Run tests
dotnet test

# Swagger UI
open http://localhost:5000/swagger

アーキテクチャ

• C# / .NET 8：ASP.NET Core Minimal API
• PostgreSQL：評価とサービススコア
• Redis：スコアのキャッシュ、レート制限、ノンスの追跡
• Beta Reputation System：ベイズスコアリング（次元別：可用性、レイテンシー、仕様適合性）
• EigenTrust：Sybil 攻撃に耐性のあるエージェント信頼スコアリング
• Merkle Tree：包含証明と一貫性証明を備えた監査ログ（RFC 6962 ツリー。各リーフには、評価で報告された内容がコミットされます）
• Ed25519 Receipt Verification：サービスとのやり取りを暗号学的に証明
• MCP サーバー：Claude、Cursor、MCP 互換エージェントとの統合

API リファレンス

コア（無料、常時利用可能）

エンドポイント	説明
GET /v1/score?service=	サービスの信頼スコア（不明なサービスは中立値の 0.5）
POST /v1/rate	サービスを呼び出した後に評価を送信
GET /v1/services	評価済みサービスの一覧（ページネーション、並べ替え、フィルタリング）
GET /v1/agent/trust?did=	エージェントの信頼スコアを確認
GET /v1/audit/root	最新の Merkle ツリーのルート
GET /v1/audit/proof/{id}	評価の包含証明と、コミットされたフィールド
GET /v1/audit/anchors	アンカーされたルートの履歴
GET /v1/audit/consistency?from=&to=	後のルートが以前のルートを拡張していることを示す証明
GET /v1/audit/anchors/{id}/ots	ルートが Bitcoin にコミットされたことを示す OpenTimestamps 証明
GET /v1/stats?days=	レジストリの利用状況（集計件数）

プレミアム（現在は無料、今後 x402 マイクロペイメントを導入予定）

エンドポイント	説明
GET /v1/score/history?service=	日ごとに集計したスコア履歴
GET /v1/score/detailed?service=	レイテンシーのパーセンタイル、品質の分布
POST /v1/scores/bulk	1 回のリクエストで最大 100 件のスコアを取得

サービスの識別

すべてのエンドポイントは、任意の形式でサービスを受け付けます（内部で正規化されます）。

• api.example.com（ドメイン）
• https://api.example.com/v1/translate（URL）
• did:web:api.example.com（DID）

この 3 つはすべて同じサービスとして解決されます。

MCP サーバー

TrustScoreAgent は、Claude、Cursor、その他のエージェント向けの MCP サーバーとして利用できます。

# Add to Claude Code
claude mcp add trustscoreagent -- npx -y @trustscoreagent/mcp-server

x402 エンドポイントに支払う前に、受け取った 402 の pay_to を指定して check_reputation を実行すると、その支払先がレジストリで確認済みかどうかがわかります。詳しいセットアップ手順は docs/mcp.md をご覧ください。また、公式 MCP Registry （io.github.trustscoreagent/mcp-server）、npm、 Smithery、Glama にも掲載されています。各 GitHub リリースには、Claude Desktop 用の .mcpb バンドルが添付されています。

x402 プラグイン

@trustscoreagent/x402 は、x402 クライアント SDK（@x402/core。@x402/fetch と @x402/axios で使用）に組み込めます。各支払いの前に、支払先がそのエンドポイントでレジストリが確認したものと一致するかをチェックし、不一致の場合は何も署名される前に支払いを停止します。

const guard = trustScoreGuard();
guard.attach(client, http);
const fetchWithPayment = wrapFetchWithPayment(guard.wrapFetch(fetch), http);

minScore を設定しない限り、スコアだけで支払いがブロックされることはありません。failClosed を設定しない限り、レジストリに接続できなくてもブロックされません。また、支払い後の評価はオプトインです（rate: true）。これはエージェント内で動作し、リクエストが TrustScoreAgent を経由することはありません。x402-plugin/README.md をご覧ください。

フレームワーク連携

エージェントフレームワークにそのまま組み込めるツールです（アカウントや API キーは不要です）。

• LangChain：from trustscoreagent_langchain import get_trustscoreagent_tools
• CrewAI：from trustscoreagent_crewai import get_trustscoreagent_tools

それぞれ、trustscore_check_reputation、trustscore_submit_rating、trustscore_list_services を利用できます。integrations/ をご覧ください。

ドキュメント

• API リファレンス
• 使用例とレシピ
• レシート標準
• MCP サーバーのセットアップ：Claude、Cursor、Windsurf
• x402 プラグイン：支払い前に支払先を確認
• エージェントにとって信頼が重要な理由
• プライバシーとデータの取り扱い
• 監査ログ仕様。独立した検証ツールは tools/verify-proof にあります。

貢献

貢献を歓迎します。CONTRIBUTING.md と 行動規範をご覧ください。脆弱性を報告する場合は、 SECURITY.md の手順に従ってください。

プロジェクトの状況と信頼モデル

TrustScoreAgent は**フェーズ 1（初期段階）**です。実際には、次のような状況です。

• 初期データは実測に基づき、監査可能です。 初期スコアは、透明性のある運用プローブ （did:web:trustscoreagent.com:probe）が、厳選された無料の公開 API と、エージェントが最も頻繁に支払う x402 エンドポイントの可用性、レイテンシ、適合性を測定して算出します。x402 エンドポイントは公開 Bazaar カタログから毎日選び、支払いを行わずにプローブします（docs/x402-probe.md をご覧ください）。捏造された数値ではなく、実測値を Merkle 監査で検証できます。これらの x402 エンドポイントについては、スコアに支払先アドレスと提示価格、およびそのいずれかが最後に変更された日時も示されます。コミュニティ評価とレシート検証済み評価も加算されます。（以前の架空の *.example.com シードは削除されました。）
• 運営者は単一です。 現時点での中立性は、分散化ではなく、オープンソースのスコアリングコードと検証可能な Merkle 監査証跡によって確保されています。フェデレーションは後のフェーズで予定しています。
• エージェントの身元は証明できますが、現時点では必須ではありません。 did:key で識別されるエージェントは、Ed25519 キーで各評価に署名します（X-Agent-Signature）。これにより、評価とそのキーの保有者が結び付けられます。署名のない評価も半分の重みで集計されるため、既存のクライアントも引き続き動作します。つまり、評価の帰属を確認できる範囲は、その署名によって決まります。検証済みのサービスレシートが、引き続き最も強力なシグナルです。

信頼モデルの詳細と脆弱性の報告方法については、SECURITY.md をご覧ください。

ライセンス

Apache-2.0。LICENSE をご覧ください。