MCP Server

The Agentscan MCP (Model Context Protocol) server lets AI assistants like Claude, Cursor, and Windsurf query the ERC-8004 agent ecosystem directly.

What is MCP?

The Model Context Protocol is an open standard that allows AI applications to connect to external data sources and tools. The Agentscan MCP server exposes the full Agentscan API as structured tools that any MCP-compatible client can use.

Installation

Option 1: npx (recommended)

No installation needed. Configure your MCP client to run:

npx -y @anthropic/agentscan-mcp-server

Option 2: Global install

npm install -g @anthropic/agentscan-mcp-server

Claude Desktop Configuration

Add this to your Claude Desktop configuration file:

claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Environment Variables

Variable	Default	Description
AGENTSCAN_API_URL	https://agentscan.info	Base URL for the Agentscan API
AGENTSCAN_DEFAULT_CHAIN	(none)	Default network filter for all queries

Tool Categories

Search & Discovery

4 tools

Search, find similar, trending, leaderboard

Agent Details

6 tools

Metadata, reputation, feedbacks, activities, health, transactions

Owner Portfolio

1 tools

Cross-network portfolio by wallet address

Platform Analytics

6 tools

Stats, trends, overview, distribution, ranking, activities

Networks

2 tools

Chain list, endpoint health stats

Taxonomy

3 tools

OASF distribution, skills list, domains list

See the full Tools Reference for detailed parameters and usage examples.

Example Prompts

Once connected, you can ask your AI assistant questions like:

-"Find AI agents that specialize in NLP on Ethereum"
-"Show me the top-ranked agents by reputation score"
-"What are the most popular skills among registered agents?"
-"Check the endpoint health of agent ethereum-42"
-"How many agents are registered on Base vs Arbitrum?"
-"Show me the portfolio of wallet 0xabc..."