AgentIndex

AgentIndex

AgentIndex 会向 AI Agent 展示哪些付费服务诚实可信、哪些存在欺诈，并提供链上证据。

在线应用 · 演示视频 · 证据 · MCP 服务 · 子图

如今，AI Agent 可以发现 API，并通过 x402 自动向其付款。付款回执能证明资金已转移，却不能证明 API 返回的数据完整或正确。

AgentIndex 填补了这一空白。它像普通客户一样向 x402 服务付款，检查服务返回的内容，并发布信任评分，供其他 Agent 在花钱前查询。

信任源于回执，而非评论。

在 Agent 花钱前，先询问索引该向谁付款。

问题

假设一个 Agent 需要天气数据，并找到了两个付费 API：

• weatherpro 价格略高，但能稳定返回其承诺提供的字段。
• scamco 价格更低，接受付款，却经常返回空数据或不完整的数据。

目录可以显示这两项服务都存在，使用次数可以显示哪一项更受欢迎。但两者都无法告诉 Agent 返回的数据是否真的可信。

AgentIndex 会自行发起请求并向服务付款，根据服务公布的承诺检查响应，同时保留付款和验证证据。这样，Agent 就可以选择 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. 探测器使用真实 HBAR 在 Hedera 测试网上为 x402 请求付款。经批准的外部探测可以使用额度严格受限的 Base USDC。
4. 探测器会检查交付情况、必需的响应字段、延迟，以及在答案客观时与 The Graph Token API 和同行共识进行核对的准确性。
5. 结果会在 Sepolia 上进行证明，并由 AgentIndex 子图建立索引。
6. AI Agent 会在选择要付费的服务前，通过 MCP 查询信任评分和证据。

在线网站会逐步说明每个步骤，并链接到对应的链上证明。

为什么这些协议很重要

AgentIndex 的作用类似于付费 API 的信用评级机构。每个赞助方都提供了系统赖以运行的组成部分。

需求	AgentIndex 实现方式	协议
为每项服务提供稳定身份	ENSv2 子名称和服务自有清单	ENS
基于实际行为的付款记录	通过 x402 进行额度受限的 HBAR 付款	Hedera
可供 Agent 查询的实时记录	Token API 验证、子图、MCP 和 Agent SKILL	The Graph

The Graph

AgentIndex 在同一信任检查流程中使用两款 The Graph 产品。

对于客观价格 API，探测器会将付费响应与来自 The Graph Token API 的实时市场数据进行比较。响应即使符合预期的 JSON 格式，也仍可能不诚实；预言机检查可以识别出看似有效但实际错误的价格。

随后，判定结果会写入链上。我们已部署的 子图 会索引服务注册和探测证明，排除无效的审计输入记录，并计算交付情况、诚实度、平均延迟和最终信任分数。MCP 服务会使用这些索引结果告知 Agent 应向谁付费，以及原因。

这不仅仅是面向仪表板的集成：

• Token API 是用于判定客观回答的独立输入。
• 子图是实时账本，可将探测历史转化为信任分数。
• MCP 服务和 SKILL.md 让其他 Agent 也能复用这些分数。
• 每个 MCP 响应都包含子图部署和索引区块的新鲜度元数据。

相关代码：

• Token API 预言机和价格比较
• 子图信任分数计算
• 子图查询和新鲜度元数据
• 可复用的 Agent 工作流

Hedera

Hedera 是预置索引的主要支付通道。自主探测器会在评估六项服务的响应前，通过 Blocky402 facilitator 在 Hedera 测试网上使用真实 HBAR 向它们全部付款。

支付流程以资金安全为设计重点：

• 预置服务的支付路径仅允许使用 HBAR。
• 每笔付款上限为 1 HBAR。
• 付款方和收款方是不同的 Hedera 账户。
• 支付引用会与探测证据一同存储，并链接到 HashScan。
• 同一 x402 流程也保护 AgentIndex 的信任 API，因此 AgentIndex 既是机器可读服务的买方，也是卖方。

相关代码：

• Hedera 签名器、x402 客户端、资产允许列表和支付上限
• 用于预置服务的 Hedera x402 付费墙
• 受 x402 保护的信任 API

ENS

ENSv2 是实际的服务注册表，而不只是显示名称。每个经评估的提供方都会获得 agentindex.eth 下可撤销的子名称，例如 weatherpro.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。这些记录会保留以便审计，但不会计入服务商评分，因此审计人员的失误不会不公平地损害服务评分。

证据仪表板由实时子图提供数据，而非静态数据集。

种子服务

这六个种子服务构成一组受控的教学示例，用于展示不同的信任信号。

服务	类别	行为	展示内容
weatherpro	天气	诚实且快速	Agent 应该付费使用的服务
scamco	天气	收款但返回错误数据	Agent 应该避开的服务
pricefeed	代币价格	诚实，且由实时 Graph 数据支持	预言机验证
summarize	摘要	诚实但缓慢	延迟会影响信任度
geocode	地理编码	诚实，但偶尔不可用	在不虚假指控欺诈的前提下展示可靠性
newsfeed	头条新闻	诚实	另一种服务类别

scamco 是特意植入的，用于演示检测流程，而不会指控无关的真实服务存在欺诈行为。

通过 MCP 使用 AgentIndex

公共 MCP 服务提供四种工具：

工具	用途
find_service	根据需求查找并排序服务
check_trust	检查某项服务的信任报告
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

运行一轮不循环的探测：

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 门控的 API 服务
prober/	发现、支付、验证、共识和证明
subgraph/	服务历史记录和信任评分索引
mcp/	MCP 服务和四个面向 Agent 的工具
api/	通过 x402 门控的信任层 REST 访问接口
web/	Next.js 仪表板、证据视图、注册功能和 MCP 控制台
demo-agent/	从信任检查到支付的端到端 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 测试网，外部 TickersFeed 验证则使用 Base 主网。

安全措施

• Hedera 支付仅限 HBAR，每次请求的金额上限为 1 HBAR。
• 外部支付需主动启用，且仅限一次性支付、仅允许列入白名单的提供方，并仅支持规范的 Base USDC。
• Base 支出设有持久化的每轮和每日预算，并设定了硬性代码级上限。
• 预言机故障时会返回不可用结果，而不会错误地将提供方标记为不诚实。
• 无效的审计员输入会继续显示，但不会影响提供方评分。
• 公共 Web 和 MCP 容器不会获得支付密钥或签名密钥。

未来可持续性

目前，演示探测由 AgentIndex 运营方出资。未来版本可允许提供方为定期独立探测提供资金，同时 Agent 在请求最新信任报告时支付少量 x402 费用。支付只会用于覆盖验证成本，绝不会用于购买更高评分或改变探测结果。

部署

生产环境通过 Docker Compose 运行，并由 Caddy 处理 HTTPS。定期支出工作进程被置于单独的 Compose 配置文件中，以防在初始部署期间开始支出。

有关生产环境布局和验证命令，请参阅部署指南。