AgentScan MCP Server

MCP Server for AgentScan — search, explore, and evaluate ERC-8004 on-chain AI agents across 21+ blockchain networks.

Use it in Claude Code, Claude Desktop, Cursor, VS Code, or any MCP-compatible client to query agent metadata, reputation scores, endpoint health, leaderboards, owner portfolios, and ecosystem analytics.

Quick Start

Claude Code

claude mcp add agentscan -- npx @aliasai2026/agentscan-mcp-server

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentscan": {
      "command": "npx",
      "args": ["@aliasai2026/agentscan-mcp-server"]
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "mcpServers": {
    "agentscan": {
      "command": "npx",
      "args": ["@aliasai2026/agentscan-mcp-server"]
    }
  }
}

Environment Variables (optional)

Variable	Default	Description
AGENTSCAN_API_URL	https://agentscan.info	AgentScan API base URL
AGENTSCAN_DEFAULT_CHAIN	—	Default network filter

Available Tools (22)

Search & Discovery

Tool	Description
search_agents	Search agents with rich filters (text, network, skill, domain, owner, quality, reputation, endpoints, date range)
find_similar_agents	Find agents similar to a given agent by shared skills/domains
get_trending_agents	Get trending, top-ranked, and featured agents
get_leaderboard	Composite-scored agent ranking (service, usage, freshness, profile)

Agent Details

Tool	Description
get_agent	Full agent metadata, OASF classification, owner, endpoints, on-chain data
get_agent_reputation	Reputation summary — feedback count, average score, validation count
get_agent_feedbacks	Individual feedback items with scores, tags, and tx hashes
get_agent_activities	On-chain event history (registrations, reputation updates, validations)
get_agent_endpoint_health	Live endpoint health check with response times
get_agent_transactions	Transaction breakdown with gas and fee details

Owner Portfolio

Tool	Description
get_owner_portfolio	All agents by wallet address with cross-network summary

Platform Analytics

Tool	Description
get_stats	Platform-wide statistics (total agents, networks, sync status)
get_registration_trend	Daily agent registration counts over time
get_analytics_overview	Comprehensive analytics with tx stats, trends, and network breakdown
get_network_distribution	Agent distribution across networks with quality breakdown
get_skill_ranking	Most popular OASF skills by agent count
get_recent_activities	Platform-wide activity feed

Networks, Health & Taxonomy

Tool	Description
list_networks	All supported blockchain networks with configurations
get_endpoint_health_stats	Platform-wide endpoint health overview
get_taxonomy_distribution	OASF skill/domain distribution across agents
list_taxonomy_skills	All 136 OASF skill categories (use slugs for search filters)
list_taxonomy_domains	All OASF domain categories (use slugs for search filters)

Example Prompts

Once configured, ask your AI assistant:

• "Search for AI agents on Base network with DeFi skills"
• "Show me the top-ranked agents by reputation"
• "What agents does wallet 0x1234... own?"
• "Check if agent X has working endpoints"
• "How many agents were registered this month?"
• "What are the most popular agent skills?"

What is ERC-8004?

ERC-8004 is the on-chain identity and reputation standard for AI agents. It provides:

• Identity Registry — ERC-721 NFT handles that resolve to AgentCard metadata
• Reputation Registry — Structured feedback signals (0–100 scores) with x402 payment proof
• Validation Registry — Independent validator hooks (staking, zkML, TEE attestation)

AgentScan is the official explorer for the ERC-8004 ecosystem, indexing agents across multiple blockchain networks.

Development

git clone https://github.com/AliasAI/agentscan-mcp-server.git
cd agentscan-mcp-server
npm install
npm run build

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT