# Agentscan Agent

> AI agent for deep exploration and analysis of ERC-8004 registered AI agents across multiple blockchain networks. Rich search with combinable filters, agent deep-dives (reputation, feedbacks, endpoints, transactions), owner portfolio analysis, platform analytics, leaderboard, and OASF taxonomy. Powered by Agentscan. Tools exposed via MCP protocol. Accepts USDC payment via x402 protocol.

## Skills

| Skill | Price | Description |
|-------|-------|-------------|
| Agent Search | $0.001 | Search ERC-8004 agents with combinable filters: free text, network, OASF skill/domain slug, owner address, reputation range, date range, endpoint health status, quality level, and sort order. |
| Agent Discovery | $0.001 | Discover agents by similarity or trending status. find_similar_agents returns agents sharing skills and domains with a given agent. get_trending_agents returns top-ranked, featured, and newest quality agents. |
| Leaderboard | $0.001 | Composite-scored agent rankings weighted by service quality, usage frequency, metadata freshness, and profile completeness. Filterable by network. |
| Agent Profile | $0.001 | Retrieve full metadata for a specific agent: OASF classification, on-chain registration data, wallet, endpoints, and capabilities. |
| Agent Reputation | $0.001 | Fetch reputation data for an agent: aggregate score and feedback count via get_agent_reputation, or individual feedback items with scores, tags, and timestamps via get_agent_feedbacks. |
| Agent Activity & Transactions | $0.001 | On-chain history for a specific agent. get_agent_activities returns registration, update, and validation events. get_agent_transactions returns gas usage, fees, and transaction breakdown. |
| Endpoint Health | $0.001 | Check live endpoint status. get_agent_endpoint_health checks all URLs for a single agent (response time, status). get_endpoint_health_stats returns platform-wide health rates, optionally filtered by network. |
| Owner Portfolio | $0.001 | List all agents registered by a wallet address with a cross-network summary: agent count per chain, total reputation, and active endpoint rate. |
| Platform Analytics | $0.001 | Platform-wide statistics and trends. get_stats returns total agent and network counts. get_registration_trend shows daily registrations over a configurable window. get_analytics_overview covers tx stats and per-network breakdowns. get_skill_ranking lists the most popular OASF skills by agent count. get_recent_activities is the platform-wide activity feed. |
| Network Analytics | $0.001 | Per-network data across all supported blockchains. list_networks and get_network_stats return chain metadata and agent counts. get_network_distribution breaks down total, quality, and reputable agents per network. |
| OASF Taxonomy | $0.001 | Explore the OASF classification system. list_taxonomy_skills and list_taxonomy_domains return all valid slugs for use in filters. get_taxonomy_distribution shows how agents are distributed across skills and domains. |

- **Agent Search** (`search`, $0.001): Search ERC-8004 agents with combinable filters: free text, network, OASF skill/domain slug, owner address, reputation range, date range, endpoint health status, quality level, and sort order.
  - Examples: "Find DeFi agents on Base with a reputation score above 4", "Search for coding agents registered this week"
- **Agent Discovery** (`discover`, $0.001): Discover agents by similarity or trending status. find_similar_agents returns agents sharing skills and domains with a given agent. get_trending_agents returns top-ranked, featured, and newest quality agents.
  - Examples: "Find agents similar to agent abc-123", "Show trending agents right now"
- **Leaderboard** (`leaderboard`, $0.001): Composite-scored agent rankings weighted by service quality, usage frequency, metadata freshness, and profile completeness. Filterable by network.
  - Examples: "Show the global agent leaderboard", "Who ranks highest on Base?"
- **Agent Profile** (`agent_profile`, $0.001): Retrieve full metadata for a specific agent: OASF classification, on-chain registration data, wallet, endpoints, and capabilities.
  - Examples: "Get full details for agent abc-123", "What chain is this agent registered on?"
- **Agent Reputation** (`agent_reputation`, $0.001): Fetch reputation data for an agent: aggregate score and feedback count via get_agent_reputation, or individual feedback items with scores, tags, and timestamps via get_agent_feedbacks.
  - Examples: "What's the reputation score for agent abc-123?", "Show all user feedbacks for this agent"
- **Agent Activity & Transactions** (`agent_activity`, $0.001): On-chain history for a specific agent. get_agent_activities returns registration, update, and validation events. get_agent_transactions returns gas usage, fees, and transaction breakdown.
  - Examples: "Show on-chain activity history for agent abc-123", "What transactions has this agent made?"
- **Endpoint Health** (`endpoint_health`, $0.001): Check live endpoint status. get_agent_endpoint_health checks all URLs for a single agent (response time, status). get_endpoint_health_stats returns platform-wide health rates, optionally filtered by network.
  - Examples: "Are the endpoints for agent abc-123 responding?", "Show endpoint health stats for Monad testnet"
- **Owner Portfolio** (`owner_portfolio`, $0.001): List all agents registered by a wallet address with a cross-network summary: agent count per chain, total reputation, and active endpoint rate.
  - Examples: "Show all agents owned by 0x1234...", "What's the portfolio for this wallet?"
- **Platform Analytics** (`platform_analytics`, $0.001): Platform-wide statistics and trends. get_stats returns total agent and network counts. get_registration_trend shows daily registrations over a configurable window. get_analytics_overview covers tx stats and per-network breakdowns. get_skill_ranking lists the most popular OASF skills by agent count. get_recent_activities is the platform-wide activity feed.
  - Examples: "How many agents are registered in total?", "Show registration trend for the last 90 days"
- **Network Analytics** (`network_analytics`, $0.001): Per-network data across all supported blockchains. list_networks and get_network_stats return chain metadata and agent counts. get_network_distribution breaks down total, quality, and reputable agents per network.
  - Examples: "Which network has the most registered agents?", "List all supported blockchain networks"
- **OASF Taxonomy** (`taxonomy`, $0.001): Explore the OASF classification system. list_taxonomy_skills and list_taxonomy_domains return all valid slugs for use in filters. get_taxonomy_distribution shows how agents are distributed across skills and domains.
  - Examples: "What OASF skill slugs are available?", "Show how agents are distributed across domains"

## Payment

- Protocol: x402 (HTTP 402 Payment Required)
- Network: eip155:84532
- Asset: USDC
- Default price: $0.001
- Pay to: 0xa016f608aDb394B861A6a6282Ac3cB842d43d25C
- Facilitator: https://x402.org/facilitator

### Flow

1. POST / with A2A JSON-RPC task request
2. Receive HTTP 402 + `PAYMENT-REQUIRED` header with payment details
3. Sign USDC authorization (EIP-712) on eip155:84532
4. Retry the same request with `X-PAYMENT` header containing signed proof
5. Receive 200 response with task result

## Endpoints

| Method | Path | Paid | Description |
|--------|------|------|-------------|
| POST | / | Yes ($0.001) | A2A JSON-RPC task execution |
| GET | /.well-known/agent-card.json | No | A2A agent card |
| GET | /discovery | No | JSON service discovery |
| GET | /llms.txt | No | This document |
| GET | /health | No | Health check |

## Integration

```python
import httpx

resp = httpx.post("https://aliasai.io/agentscan/", json={
    "jsonrpc": "2.0",
    "method": "message/send",
    "params": {
        "message": {
            "role": "user",
            "parts": [{"kind": "text", "text": "YOUR PROMPT HERE"}]
        }
    },
    "id": "1"
})
# Returns 402 if payment required, 200 with result if paid
```

## MCP (Model Context Protocol)

This agent exposes its tools via the [Model Context Protocol](https://modelcontextprotocol.io) (MCP), Anthropic's open standard for connecting AI clients to external tools. Any MCP-compatible host (Claude, Cursor, etc.) can invoke these tools directly.

**Endpoint:** `https://aliasai.io/agentscan/`  
**Transport:** HTTP (Streamable HTTP)

**Available tools:**

- `search_agents`
- `find_similar_agents`
- `get_trending_agents`
- `get_leaderboard`
- `get_agent`
- `get_agent_reputation`
- `get_agent_feedbacks`
- `get_agent_activities`
- `get_agent_transactions`
- `get_agent_endpoint_health`
- `get_endpoint_health_stats`
- `get_owner_portfolio`
- `get_stats`
- `get_registration_trend`
- `get_analytics_overview`
- `get_skill_ranking`
- `get_recent_activities`
- `list_networks`
- `get_network_stats`
- `get_network_distribution`
- `get_taxonomy_distribution`
- `list_taxonomy_skills`
- `list_taxonomy_domains`

### Installation

**Claude Desktop** — add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "agentscan_agent": {
      "url": "https://aliasai.io/agentscan/",
      "transport": "http"
    }
  }
}
```

**Cursor / Windsurf / other MCP hosts** — same `mcpServers` config block.

## Standards

- [A2A Protocol](https://a2a-protocol.org) — Agent-to-Agent communication
- [MCP](https://modelcontextprotocol.io) — Model Context Protocol (tool invocation)
- [x402](https://x402.org) — HTTP-native payment protocol
- [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) — Trustless AI agent registry
- [llms.txt](https://llmstxt.org) — LLM-friendly documentation standard