AgentIndex

AgentIndex

AgentIndex は、オンチェーンの証拠に基づいて、どの有料サービスが誠実で、どのサービスが詐欺なのかを AI エージェントに示します。

ライブアプリ · デモ動画 · 証拠 · MCP サーバー · サブグラフ

AI エージェントは API を見つけ、x402 を通じて自動的に支払いを行えるようになりました。支払いのレシートは資金が移動したことを証明しますが、API が完全かつ正確なデータを返したことまでは証明しません。

AgentIndex はこのギャップを埋めます。通常の顧客と同じように x402 サービスへ支払い、返された内容を検証し、ほかのエージェントが支払い前に確認できる信頼スコアを公開します。

レビューではなく、レシートに基づく信頼。

エージェントが支出する前に、どこに支払うべきかをインデックスに尋ねます。

問題

エージェントが天気データを必要としていて、有料 API を 2 つ見つけたとします。

• weatherpro は少し高価ですが、約束したフィールドを確実に返します。
• scamco はより安価で、支払いを受け付けますが、空または不完全なデータを返すことがよくあります。

ディレクトリを見れば、どちらのサービスも存在することはわかります。利用回数を見れば、どちらが人気なのかはわかります。しかし、応答が本当に信頼できるかどうかは、どちらからもわかりません。

AgentIndex は実際にリクエストを送り、サービスに支払い、公開されているサービスの仕様と照らし合わせて応答を確認し、支払いと検証の証拠を保存します。これにより、エージェントは検証可能な根拠に基づいて weatherpro を選び、scamco を避けられます。

仕組み

flowchart LR
    A[Service registers<br/>ENSv2 subname + manifest] --> B[Prober discovers service]
    B --> C[Real x402 payment<br/>Hedera or Base]
    C --> D[Response verification<br/>spec + oracle + consensus]
    D --> E[Verdict attested<br/>on Sepolia]
    E --> F[The Graph subgraph<br/>builds trust score]
    F --> G[Agent checks trust<br/>through MCP or API]

1. プロバイダーは agentindex.eth のサブネームを登録し、エンドポイント、価格、メソッド、応答仕様を ENS テキストレコードに保存します。
2. プローバーは ENS からマニフェストを直接読み取り、通常の顧客と同じようにサービスを呼び出します。
3. Hedera テストネット上で実際の HBAR を使って x402 リクエストに支払います。承認済みの外部プローブでは、Base 上で厳格な上限を設けた USDC を使用できます。
4. データの提供、必須の応答フィールド、レイテンシを確認します。また、回答が客観的に評価できる場合は、The Graph Token API とピアコンセンサスを基準に正確性を検証します。
5. 検証結果は Sepolia 上でアテステーションとして記録され、AgentIndex サブグラフによってインデックス化されます。
6. AI エージェントは MCP を通じて信頼スコアと証拠を照会してから、支払うサービスを選びます。

ライブサイトでは各ステップを説明し、オンチェーンの証明へのリンクを掲載しています。

これらのプロトコルが重要な理由

AgentIndex は、有料 API の信用調査機関のように機能します。各スポンサーが、システムに不可欠な役割を担います。

必要なもの	AgentIndex での実装	プロトコル
すべてのサービスに安定した ID を付与する	ENSv2 のサブネームとサービス所有のマニフェスト	ENS
実際の挙動に基づく支払い履歴	x402 を通じた支出上限付き HBAR 支払い	Hedera
エージェントが照会できる最新の記録	Token API による検証、サブグラフ、MCP、エージェント SKILL	The Graph

The Graph

AgentIndex は、同じ信頼性確認フローで The Graph の 2 つの製品を使用します。

客観的な価格 API については、プローバーが有料の応答を The Graph Token API の最新市場データと比較します。応答が期待される JSON 形式に一致していても、不正確な情報が含まれていることがあります。オラクルチェックにより、正しく見えても誤っている価格を検出します。

判定結果はその後、オンチェーンに書き込まれます。デプロイ済みの サブグラフ はサービス登録とプローブの証明をインデックス化し、無効な監査者入力レコードを除外したうえで、配信、正確性、平均レイテンシ、最終的な信頼スコアを算出します。MCP サーバーはインデックス化された結果を使い、どのエージェントに支払うべきか、その理由とともに伝えます。

これはダッシュボードだけの統合ではありません。

• Token API は、客観的な回答を評価するために使用する独立した入力です。
• サブグラフは、プローブ履歴を信頼スコアに変換するライブ台帳です。
• MCP サーバーと SKILL.md により、ほかのエージェントもこれらのスコアを再利用できます。
• すべての MCP 応答には、サブグラフのデプロイ情報とインデックス化されたブロックの鮮度メタデータが含まれます。

関連コード：

• Token API オラクルと価格比較
• サブグラフの信頼スコア計算
• サブグラフのクエリと鮮度メタデータ
• 再利用可能なエージェントワークフロー

Hedera

Hedera は、シード済みインデックスの主要な決済レールです。自律型プローバーは、応答を評価する前に、Blocky402 ファシリテーターを通じて Hedera テストネット上で実際の HBAR を使い、6 つすべてのサービスに支払います。

決済フローは、資金の安全性を考慮して構築されています。

• シード済みサービスの決済経路では、HBAR のみが許可されます。
• すべての支払いは 1 HBAR を上限とします。
• 支払者と受取人には、それぞれ別の Hedera アカウントを使用します。
• 支払い参照情報はプローブの証拠とともに保存され、HashScan にリンクされます。
• 同じ x402 フローで AgentIndex の信頼 API も保護されるため、AgentIndex は機械可読なサービスの購入者と販売者の両方として機能します。

関連コード：

• Hedera 署名者、x402 クライアント、アセット許可リスト、支払い上限
• シード済みサービス向け Hedera x402 ペイウォール
• x402 で保護された信頼 API

ENS

ENSv2 は実際のサービスレジストリであり、表示名にとどまりません。評価対象のプロバイダーには、weatherpro.agentindex.eth のように、agentindex.eth 配下の取り消し可能なサブネームが割り当てられます。

各サービスは、ENS テキストレコードを通じてマニフェストを公開します。

• url
• description
• x402:method
• x402:price
• x402:spec

プローバーは支払いを行う前にこれらのレコードを読み取ります。そのため、確認対象のエンドポイントとサービスの約束は、非公開のアプリケーションデータベースではなく ENS に由来します。ENSv2 の権限設定により、各プロバイダーは自身のレコードだけを管理できます。一方、AgentIndex は、サービスが支払いを受け取って不正なデータを返したと判明した場合に、サブネームを取り消す権限を保持します。

関連コード：

• ENSv2 のサブネーム登録、権限設定、更新、取り消し
• ライブ ENS マニフェストリーダー
• 権限付きリゾルバーのデプロイ

検証モデル

AgentIndex は、サービスの種類ごとに適切な最も厳格なチェックを適用します。

チェック	確認内容	対象
配信	サービスは空でない JSON 応答を返しましたか？	すべてのサービス
仕様との一致	ENS マニフェストで約束されたすべてのフィールドを返しましたか？	すべてのサービス
オラクルチェック	客観的な値は The Graph Token API と一致していますか？	価格サービス
コンセンサス	ほかのプロバイダーと比較して、その値は外れ値ですか？	比較可能なサービス
実績	多数の有料プローブを通じて、サービスはどのように動作してきましたか？	すべてのサービス

信頼スコアはベーシスポイントで算出されます。

trust = 0.60 × delivery + 0.25 × honesty + 0.15 × latency

要約などの主観的な出力について、AgentIndex は回答が「良い」ことを証明できるとは主張しません。配信状況、公開形式への準拠、レイテンシ、過去の動作を報告します。客観的なデータには、さらにオラクルチェックとコンセンサスチェックを適用します。

実際の支払い検証

このプロジェクトには、デモ用に作成したサービスだけでなく、外部の x402 プロバイダーに対する実際の有料プローブも含まれています。

• プロバイダー： TickersFeed
• 支払い： Base メインネットで $0.002 USDC
• 検証： 返された BTC 価格を The Graph Token API およびピアコンセンサスと照合
• 結果： 設定された 2% のオラクル許容誤差内
• Base での支払い： BaseScan で表示
• Sepolia の証明： Etherscan で表示

誤ったリクエストパスを使用した以前のプローブは、引き続き valid=false として表示されます。監査可能性を保つために残していますが、プロバイダーのスコアからは除外されるため、監査者のミスによってサービスが不当に損なわれることはありません。

証拠ダッシュボードは静的データセットではなく、ライブサブグラフに基づいています。

シード済みサービス

6 つのシード済みサービスは、さまざまな信頼シグナルを示すために使用する、管理された学習用セットです。

サービス	カテゴリ	挙動	示す内容
weatherpro	天気	誠実で高速	エージェントが支払うべきサービス
scamco	天気	支払いを受け取るが、不正確なデータを返す	エージェントが避けるべきサービス
pricefeed	トークン価格	誠実で、ライブの Graph データに裏付けられている	オラクル検証
summarize	要約	誠実だが低速	レイテンシが信頼に影響すること
geocode	ジオコーディング	誠実だが、ときどき利用できない	誤った不正の主張をせずに信頼性を示すこと
newsfeed	ニュース見出し	誠実	別のサービスカテゴリ

scamco は意図的に仕込まれています。これにより、無関係な実在サービスを不正だと非難することなく、不正の検出を実演できます。

MCP 経由で AgentIndex を使う

公開 MCP サーバーでは、4 つのツールを利用できます。

ツール	目的
find_service	ニーズに合ったサービスを見つけ、順位付けする
check_trust	1 つのサービスの信頼レポートを確認する
resolve_data_need	支払う相手、または避ける相手を判断し、その理由を説明する
get_verified_data	最適なプロバイダーから、スコアと最新の証明付きでデータを取得する

MCP 対応クライアントにリモートサーバーをインストールします。

npx add-mcp https://mcp-agentindex.craftyour.site/mcp

• レジストリ名：io.github.cognivis/agentindex
• トランスポート：ステートレスな Streamable HTTP
• 検出マニフェスト：https://mcp-agentindex.craftyour.site/.well-known/mcp.json

実際の MCP セッションでは、`weatherpro` を推奨し、`scamco` を却下して、インデックス化された証拠に基づいて判断理由を説明します。

ローカルで実行する

必要条件

• Node.js 22 以降
• pnpm
• Solidity コントラクト用の Foundry

インストール

corepack enable
pnpm install
cp .env.example .env

実行するコンポーネントに必要な環境変数だけを設定してください。.env や秘密鍵は絶対にコミットしないでください。

安全なローカルモード

支払いを行わずにテストするには、.env で PAYWALL=off を設定します。各コンポーネントを別々のターミナルで実行してください。

pnpm services
pnpm web
pnpm --filter @agentindex/mcp http

ループしないプローブを 1 ラウンド実行します。

PAYWALL=off pnpm --filter @agentindex/prober run once

Base での外部支払いはデフォルトで無効です。支払いを有効にするには、明示的なワンショット実行、承認済みプロバイダー、正規の Base USDC、および設定済みのラウンド予算と日次予算が必要です。有効にする前に、プローブガイドを参照してください。

テスト

pnpm test

個々の TypeScript パッケージは、次のコマンドでチェックできます。

pnpm --filter @agentindex/services run typecheck
pnpm --filter @agentindex/prober run typecheck
pnpm --filter @agentindex/mcp run typecheck
pnpm --filter @agentindex/api run typecheck
pnpm --filter @agentindex/web run typecheck

リポジトリの構成

パス	目的
contracts/	ENSv2 サービスレジストラーとオンチェーンの証明レジストリ
services/	x402 で保護された 6 つの API サービス
prober/	検出、支払い、検証、コンセンサス、証明
subgraph/	サービス履歴と信頼スコアのインデックス作成
mcp/	MCP サーバーとエージェント向けツール 4 つ
api/	信頼レイヤーへの x402 で保護された REST アクセス
web/	Next.js ダッシュボード、証拠の表示、登録、MCP コンソール
demo-agent/	信頼性の確認から支払いまでのエンドツーエンドのエージェントフロー
deploy/	Docker、Caddy、VPS のデプロイ設定
SKILL.md	再利用可能な「支払いの前に信頼性を確認する」ワークフロー

公開デプロイ

コンポーネント	URL またはアドレス
ダッシュボード	https://agentindex.craftyour.site
証拠ダッシュボード	https://agentindex.craftyour.site/evidence
MCP エンドポイント	https://mcp-agentindex.craftyour.site/mcp
有料の信頼性 API	https://api-agentindex.craftyour.site
シード済み x402 サービス	https://services-agentindex.craftyour.site
Subgraph	https://api.studio.thegraph.com/query/1759003/agentindex-sepolia/v0.0.3
Subgraph のデプロイ	QmXxckRjUGcYCJgVEeD38GYEKnybGDapfA9ZgWKM2iuQgs
AttestationRegistry	0x33406801acD2A16549462153261A224F779768CC
ServiceRegistrar	0xdeB458892c7702Fe0112161EEa28C0F46eFd6379
PermissionedResolver	0xDEb75A113E4A072F182bAF24B14B148Fe6377416
ENSv2 UserRegistry	0xEFb0a4696145598C9d4d74df15Dd5D3CaAeD2F9D

表中のすべてのコントラクトは Sepolia にデプロイされています。Hedera での支払いには Hedera testnet を使用し、外部の TickersFeed の検証には Base mainnet を使用します。

セキュリティ上の選択

• Hedera での支払いは HBAR に限定され、1 リクエストあたり 1 HBAR を上限とします。
• 外部への支払いは明示的な有効化が必要で、1 回限りに限られ、許可リストに登録されたプロバイダーのみを対象とし、標準の Base USDC に限定されます。
• Base での支出には、ラウンドごとおよび日ごとの継続的な予算上限があり、コードレベルで上限値が固定されています。
• オラクルが停止した場合、プロバイダーに不正な行為があったと誤って判定せず、利用不可の結果を返します。
• 無効な監査者入力は表示されますが、プロバイダーのスコアには影響しません。
• 公開ウェブコンテナと MCP コンテナには、支払いキーや署名キーを渡しません。

将来の持続可能性

現在、デモのプローブ費用は AgentIndex の運営者が負担しています。将来のバージョンでは、プロバイダーが継続的な独立プローブの費用を負担し、エージェントが最新の信頼性レポートをリクエストする際に少額の x402 手数料を支払う仕組みにできる可能性があります。支払いは検証費用のみを賄うものであり、より高いスコアを購入したり、プローブの結果を変えたりすることはできません。

デプロイ

本番環境は Docker Compose で稼働し、Caddy が HTTPS を処理します。継続的な支出を行うワーカーは別の Compose プロファイルで分離されているため、初回デプロイ中に支出を開始することはありません。

本番環境の構成と検証コマンドについては、デプロイガイドを参照してください。