ERC-8004 MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ERC-8004 MCP Server Search for fitness agents on ERC-8004"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ERC-8004 MCP Server
An MCP (Model Context Protocol) server for querying ERC-8004 AI agent identities. It queries The Graph subgraph for on-chain data and fetches IPFS metadata for full off-chain details.
Features
Search agents by name with optional protocol filtering (MCP/A2A)
List agents with pagination, sorting, and protocol filtering
Get full agent details including contract state, services, identity, and statistics
Get feedback/reviews with scores, tags, review text, and MCP/A2A context
Get engagement stats with tag analysis and score distribution
Get full metadata including off-chain IPFS attributes (certifications, model info, social links, pricing, etc.)
Related MCP server: ERC-8126 Scan MCP Server
Tools
Tool | Description |
| Search agents by name with optional protocol filter |
| Browse agents with pagination and sorting |
| Get full details for an agent by ID |
| Get all feedback/reviews for an agent |
| Get engagement metrics and score breakdown |
| Get full on-chain + off-chain metadata (IPFS) |
Setup
yarn installUsage
stdio mode (Claude Desktop, Cursor, etc.)
yarn devHTTP mode (Streamable HTTP)
yarn dev:httpThe server starts on http://localhost:3100/mcp by default. Set the PORT environment variable to change it.
Production
yarn build
yarn start # stdio
yarn start:http # HTTPConfiguration with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"erc-8004-agents": {
"command": "npx",
"args": ["tsx", "/path/to/erc-8004-mcp-server/src/index.ts"]
}
}
}Or with the compiled version:
{
"mcpServers": {
"erc-8004-agents": {
"command": "node",
"args": ["/path/to/erc-8004-mcp-server/dist/index.js"]
}
}
}Configuration with Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"erc-8004-agents": {
"command": "npx",
"args": ["tsx", "/path/to/erc-8004-mcp-server/src/index.ts"]
}
}
}Or for the HTTP transport:
{
"mcpServers": {
"erc-8004-agents": {
"url": "http://localhost:3100/mcp"
}
}
}Example queries
Once connected, you can ask your AI assistant:
"Search for fitness agents on ERC-8004"
"List the most recently created agents with MCP support"
"Get details for agent 11155111:1213"
"Show me all the feedback for Larry the Lobster"
"What are the full metadata attributes for agent 11155111:1213?"
"Show me the stats and score breakdown for this agent"
Data Sources
On-chain data: ERC-8004 Subgraph on Sepolia testnet
Off-chain metadata: IPFS via public gateways (ipfs.io, cloudflare-ipfs.com, dweb.link)
Available Tools
11 toolserc8004_evaluate_agent_trustARead-only
Composite tool that combines identity, reputation, and validation data to produce a holistic trust evaluation for an agent.
Inputs: agentId (required).
erc8004_get_agentARead-only
Get full details for a specific ERC-8004 agent by ID, including contract state, services, metadata, statistics, and recent feedback.
Inputs: agentId (required).
erc8004_get_agent_feedbackARead-only
Get all feedback and reviews for an ERC-8004 agent, including scores, tags, review text, and MCP/A2A context.
Inputs: agentId (required), limit.
erc8004_get_agent_metadataARead-only
Get the full on-chain and off-chain metadata for an ERC-8004 agent. Fetches the IPFS registration file and returns all extended attributes.
Inputs: agentId (required).
erc8004_get_agent_statsARead-only
Get engagement metrics, score breakdown, feedback tag analysis, and score distribution for an ERC-8004 agent.
Inputs: agentId (required).
erc8004_get_feedback_detailsARead-only
Get detailed individual feedback records from the Reputation Registry, including signed values and revocation status.
Inputs: agentId (required), limit, includeRevoked.
erc8004_get_reputation_summaryARead-only
Get the aggregated reputation summary for an ERC-8004 agent from the Reputation Registry.
Inputs: agentId (required).
erc8004_get_validation_statusARead-only
Check the validation status of an ERC-8004 agent from the Validation Registry (zkML, TEE attestation, or stake-secured re-execution).
Inputs: agentId (required).
erc8004_list_agentsARead-only
Browse ERC-8004 registered AI agents with pagination and sorting. Supports protocol and chain filtering.
Inputs: page, chain, sortBy, pageSize, +2 more.
erc8004_resolve_agent_servicesARead-only
Parse the agent's registration file and return typed service endpoints (MCP, A2A, ENS, DID).
Inputs: agentId (required).
erc8004_search_agentsARead-only
Search for ERC-8004 registered AI agents by name. Supports optional protocol and chain filtering.
Inputs: query (required), chain, limit, protocol.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct aspect of ERC-8004 agents: search, list, get details, feedback, stats, metadata, reputation, validation, services, and composite trust. No two tools have overlapping functionality.
All tools follow the pattern 'erc8004_verb_noun', with verbs like search, list, get, resolve, evaluate. Minor inconsistency: some use 'agent' singular (get_agent) while others use 'agents' plural (search_agents), but overall consistent.
11 tools is well-scoped for a registry information server. Each tool covers a necessary query function without redundancy, balancing breadth and depth.
The tool set comprehensively covers read operations for ERC-8004 agents: search, detail, feedback, stats, metadata, reputation, validation, services, and composite trust. No obvious gaps for querying agent information.
Maintenance
Related MCP Connectors
On-chain ERC-8004 agent registry. Search, register, and check reputation across 16 chains.
Look up AI agents on Arc: ERC-8004 identity, feedback, validations and USDC-backed trust scores.
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.
Look up AI agents on Robinhood Chain: ERC-8004 identity, feedback and USDG-backed trust scores.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that bridges ERC-8004 agent identity, reputation, and validation registries into tool calls, enabling discovery, inspection, and verification of on-chain AI agents from any MCP client.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to search the on-chain index of 378,000+ ERC-8004 agents and read Cybercentry verification results spanning token, code, media, web, and wallet dimensions.MIT
- FlicenseNot gradedqualityBmaintenanceProvides protocol-neutral market intelligence for the AI agent economy, with read-only tools to search agents, retrieve details and histories, compare agents, list categories, view category rankings, and access methodology.-
- AlicenseNot gradedqualityBmaintenanceLets you probe ERC-8004 agents on BNB Smart Chain by calling their declared MCP or A2A endpoints, checking payment requirements, reading on-chain reputation authorship, and finding agents by description.MIT