Skip to main content
Glama
ERC-8004 MCP Server

ERC-8004 MCP Server

by wpank

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

Search agents by name with optional protocol filter

list_agents

Browse agents with pagination and sorting

get_agent

Get full details for an agent by ID

get_agent_feedback

Get all feedback/reviews for an agent

get_agent_stats

Get engagement metrics and score breakdown

get_agent_metadata

Get full on-chain + off-chain metadata (IPFS)

Setup

yarn install

Usage

stdio mode (Claude Desktop, Cursor, etc.)

yarn dev

HTTP mode (Streamable HTTP)

yarn dev:http

The 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     # HTTP

Configuration 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 tools
erc8004_evaluate_agent_trustA
Read-only

Composite tool that combines identity, reputation, and validation data to produce a holistic trust evaluation for an agent.

Inputs: agentId (required).

erc8004_get_agentA
Read-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_feedbackA
Read-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_metadataA
Read-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_statsA
Read-only

Get engagement metrics, score breakdown, feedback tag analysis, and score distribution for an ERC-8004 agent.

Inputs: agentId (required).

erc8004_get_feedback_detailsA
Read-only

Get detailed individual feedback records from the Reputation Registry, including signed values and revocation status.

Inputs: agentId (required), limit, includeRevoked.

erc8004_get_reputation_summaryA
Read-only

Get the aggregated reputation summary for an ERC-8004 agent from the Reputation Registry.

Inputs: agentId (required).

erc8004_get_validation_statusA
Read-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_agentsA
Read-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_servicesA
Read-only

Parse the agent's registration file and return typed service endpoints (MCP, A2A, ENS, DID).

Inputs: agentId (required).

erc8004_search_agentsA
Read-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

    A4/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    11 tools is well-scoped for a registry information server. Each tool covers a necessary query function without redundancy, balancing breadth and depth.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      8
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Provides 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.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets 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