# 8004 Explorer

> Verifiable data layer for on-chain agents, with indexed ERC-8004 discovery, provenance, and reputation context.

8004 Explorer indexes the on-chain ERC-8004 Identity Registry, Reputation Registry, and Validation Registry across Ethereum and Base. It provides searchable agent records, service endpoints, reputation signals, and sync-aware provenance for builders and operators integrating on-chain agents.

## Key Links

- [Browse Agents](https://8004.fyi/agents): Search and filter all registered AI agents
- [MCP Server](https://8004.fyi/mcp): Model Context Protocol server for agent discovery (Streamable HTTP)
- [OpenAPI Spec](https://8004.fyi/openapi.json): OpenAPI 3.1 specification for the REST API
- [API: List Agents](https://8004.fyi/api/v2/agents): Paginated, sortable, searchable agent data
- [API: Agent Details](https://8004.fyi/api/v2/agents/{id}): Full agent metadata and feedback
- [API: Registry Stats](https://8004.fyi/api/v2/stats): Total agents, feedback, sync status
- [Discovery](https://8004.fyi/.well-known/agents.json): Machine-readable registry discovery
- [MCP Discovery](https://8004.fyi/.well-known/mcp.json): MCP server discovery metadata
- [ERC-8004 Standard](https://eips.ethereum.org/EIPS/eip-8004): The Ethereum standard specification
- [Full Details](https://8004.fyi/llms-full.txt): Complete reference for LLMs

## API

The public REST API serves indexed agent data from the ERC-8004 registries across Ethereum and Base and includes sync metadata for provenance.

### GET /api/v2/agents
Query params: page, limit, sort (newest|reputation|name), search, filter (has-reputation|all), service (mcp|a2a), chain (1|8453)

### GET /api/v2/agents/{id}
Returns single agent with full metadata, services, and all feedback entries. Optional query param: chain (1|8453).

### GET /api/v2/stats
Returns totalAgents, agentsWithReputation, totalFeedback, lastSyncBlock.

## MCP

The MCP server exposes the indexed registry through five focused tools over Streamable HTTP.

- `vet_agent(agentId, targetService?)`: Return an integration verdict, reasons, risks, matching services, and provenance for one agent
- `search_agents(query?, service?, hasReputation?, sort?, page?, limit?)`: Search and browse indexed agents
- `get_agent(agentId, includeReputation?)`: Return the full indexed record for one agent
- `get_stats()`: Return registry-wide counts and sync metadata
- `resolve_endpoint(service, query?, limit?)`: Find concrete service endpoints for matching agents

## Contracts

- Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (Ethereum + Base)
- Reputation Registry: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 (Ethereum + Base)