{"_id":"@aliasai2026/agentscan-mcp-server","_rev":"2-0830652ffce8b4b034a707d279de8a0d","name":"@aliasai2026/agentscan-mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@aliasai2026/agentscan-mcp-server","version":"0.1.0","keywords":["mcp","agentscan","erc-8004","ai-agents","blockchain","model-context-protocol"],"author":{"name":"Alias Labs"},"license":"MIT","_id":"@aliasai2026/agentscan-mcp-server@0.1.0","maintainers":[{"name":"aliasai","email":"aliasai888666@gmail.com"}],"homepage":"https://agentscan.info","bugs":{"url":"https://github.com/AliasAI/agentscan-mcp-server/issues"},"bin":{"agentscan-mcp-server":"dist/index.js"},"dist":{"shasum":"878aeaac962bf01dcdbfa0a5979ad6b2aeba820c","tarball":"https://registry.npmjs.org/@aliasai2026/agentscan-mcp-server/-/agentscan-mcp-server-0.1.0.tgz","fileCount":42,"integrity":"sha512-9m1Y/uaD3UbkUg8X40oqe4QO0ocam48VHKGQWyEdXKIBpOnwsj1/6bAUtHPr1Ud/CXIsexMVcS1mtLeQGeF3Jg==","signatures":[{"sig":"MEYCIQDHzE9oC69aJe/uZoRsuI9IN5IO3ejd+nJObXhi7MYWnQIhALFpYvnvHUfAzFT4GWksUkf/JNLSX2yo73o5kT0+y07W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54515},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"3e368af0b0bb96462fe32bf94a4f7698435cdb18","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"aliasai","email":"aliasai888666@gmail.com"},"repository":{"url":"git+https://github.com/AliasAI/agentscan-mcp-server.git","type":"git"},"_npmVersion":"10.9.3","description":"MCP Server for AgentScan — search, explore, and evaluate ERC-8004 on-chain AI agents","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.2","typescript":"^5.8.3","@types/node":"^22.14.0"},"_npmOperationalInternal":{"tmp":"tmp/agentscan-mcp-server_0.1.0_1775036159927_0.3870796310842173","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aliasai2026/agentscan-mcp-server","version":"0.1.1","description":"MCP Server for AgentScan — search, explore, and evaluate ERC-8004 on-chain AI agents","author":{"name":"Alias Labs"},"license":"MIT","type":"module","bin":{"agentscan-mcp-server":"dist/index.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.4"},"devDependencies":{"@types/node":"^22.14.0","typescript":"^5.8.3","vitest":"^4.1.2"},"engines":{"node":">=18.0.0"},"keywords":["mcp","agentscan","erc-8004","ai-agents","blockchain","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/AliasAI/agentscan-mcp-server.git"},"homepage":"https://agentscan.info","_id":"@aliasai2026/agentscan-mcp-server@0.1.1","gitHead":"bd6b87ad48ed08695e9310091168da25d7611f2b","bugs":{"url":"https://github.com/AliasAI/agentscan-mcp-server/issues"},"_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Z5iUXjMkwU2Z+qYdbvPT9tdnv6p+JQOgKULJA2yz1ckKq3KC9lomiVwMCa3Z9B1buFudV2UCPF0ptLjUs/9fTQ==","shasum":"ad2813db2eaa790c5b2d5e9584379fa628fdbc80","tarball":"https://registry.npmjs.org/@aliasai2026/agentscan-mcp-server/-/agentscan-mcp-server-0.1.1.tgz","fileCount":42,"unpackedSize":54521,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC8L9xmZPxFuIJWGZwX2+N7KMUUQQfZIlmbS3MkO1mUygIgANNJdFnjkkG61H9JoTdRXX0SFwX7eDe81h3i7eON3KM="}]},"_npmUser":{"name":"aliasai","email":"aliasai888666@gmail.com"},"directories":{},"maintainers":[{"name":"aliasai","email":"aliasai888666@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentscan-mcp-server_0.1.1_1775036944839_0.2009883411017772"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T09:35:59.779Z","modified":"2026-04-01T09:49:05.147Z","0.1.0":"2026-04-01T09:36:00.059Z","0.1.1":"2026-04-01T09:49:05.001Z"},"bugs":{"url":"https://github.com/AliasAI/agentscan-mcp-server/issues"},"author":{"name":"Alias Labs"},"license":"MIT","homepage":"https://agentscan.info","keywords":["mcp","agentscan","erc-8004","ai-agents","blockchain","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/AliasAI/agentscan-mcp-server.git"},"description":"MCP Server for AgentScan — search, explore, and evaluate ERC-8004 on-chain AI agents","maintainers":[{"name":"aliasai","email":"aliasai888666@gmail.com"}],"readme":"# AgentScan MCP Server\n\nMCP Server for [AgentScan](https://agentscan.info) — search, explore, and evaluate **ERC-8004** on-chain AI agents across 21+ blockchain networks.\n\nUse 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.\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add agentscan -- npx @aliasai2026/agentscan-mcp-server\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentscan\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aliasai2026/agentscan-mcp-server\"]\n    }\n  }\n}\n```\n\n### Cursor / VS Code\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentscan\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aliasai2026/agentscan-mcp-server\"]\n    }\n  }\n}\n```\n\n## Environment Variables (optional)\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `AGENTSCAN_API_URL` | `https://agentscan.info` | AgentScan API base URL |\n| `AGENTSCAN_DEFAULT_CHAIN` | — | Default network filter |\n\n## Available Tools (22)\n\n### Search & Discovery\n\n| Tool | Description |\n|------|-------------|\n| `search_agents` | Search agents with rich filters (text, network, skill, domain, owner, quality, reputation, endpoints, date range) |\n| `find_similar_agents` | Find agents similar to a given agent by shared skills/domains |\n| `get_trending_agents` | Get trending, top-ranked, and featured agents |\n| `get_leaderboard` | Composite-scored agent ranking (service, usage, freshness, profile) |\n\n### Agent Details\n\n| Tool | Description |\n|------|-------------|\n| `get_agent` | Full agent metadata, OASF classification, owner, endpoints, on-chain data |\n| `get_agent_reputation` | Reputation summary — feedback count, average score, validation count |\n| `get_agent_feedbacks` | Individual feedback items with scores, tags, and tx hashes |\n| `get_agent_activities` | On-chain event history (registrations, reputation updates, validations) |\n| `get_agent_endpoint_health` | Live endpoint health check with response times |\n| `get_agent_transactions` | Transaction breakdown with gas and fee details |\n\n### Owner Portfolio\n\n| Tool | Description |\n|------|-------------|\n| `get_owner_portfolio` | All agents by wallet address with cross-network summary |\n\n### Platform Analytics\n\n| Tool | Description |\n|------|-------------|\n| `get_stats` | Platform-wide statistics (total agents, networks, sync status) |\n| `get_registration_trend` | Daily agent registration counts over time |\n| `get_analytics_overview` | Comprehensive analytics with tx stats, trends, and network breakdown |\n| `get_network_distribution` | Agent distribution across networks with quality breakdown |\n| `get_skill_ranking` | Most popular OASF skills by agent count |\n| `get_recent_activities` | Platform-wide activity feed |\n\n### Networks, Health & Taxonomy\n\n| Tool | Description |\n|------|-------------|\n| `list_networks` | All supported blockchain networks with configurations |\n| `get_endpoint_health_stats` | Platform-wide endpoint health overview |\n| `get_taxonomy_distribution` | OASF skill/domain distribution across agents |\n| `list_taxonomy_skills` | All 136 OASF skill categories (use slugs for search filters) |\n| `list_taxonomy_domains` | All OASF domain categories (use slugs for search filters) |\n\n## Example Prompts\n\nOnce configured, ask your AI assistant:\n\n- \"Search for AI agents on Base network with DeFi skills\"\n- \"Show me the top-ranked agents by reputation\"\n- \"What agents does wallet 0x1234... own?\"\n- \"Check if agent X has working endpoints\"\n- \"How many agents were registered this month?\"\n- \"What are the most popular agent skills?\"\n\n## What is ERC-8004?\n\n[ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) is the on-chain identity and reputation standard for AI agents. It provides:\n\n- **Identity Registry** — ERC-721 NFT handles that resolve to AgentCard metadata\n- **Reputation Registry** — Structured feedback signals (0–100 scores) with x402 payment proof\n- **Validation Registry** — Independent validator hooks (staking, zkML, TEE attestation)\n\nAgentScan is the official explorer for the ERC-8004 ecosystem, indexing agents across multiple blockchain networks.\n\n## Development\n\n```bash\ngit clone https://github.com/AliasAI/agentscan-mcp-server.git\ncd agentscan-mcp-server\nnpm install\nnpm run build\n```\n\nTest with MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}