MCP Tools Reference
Complete reference for all tools available in the Agentscan MCP server.
Search & Discovery
search_agentsFull-featured agent search with text, network, quality tier, reputation range filters, sorting, and pagination.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Text search (name, description, address) |
| network | string | No | Filter by network key (e.g. "ethereum", "base") |
| quality | string | No (default: all) | Quality tier: "all", "basic", "verified" |
| reputation_min | number | No | Minimum reputation score |
| reputation_max | number | No | Maximum reputation score |
| has_reputation | boolean | No | Only agents with reputation data |
| sort_field | string | No (default: created_at) | Sort field |
| sort_order | string | No (default: desc) | "asc" or "desc" |
| page | integer | No (default: 1) | Page number |
| page_size | integer | No (default: 20) | Items per page (max 100) |
get_trending_agentsGet top-ranked, featured, and trending agents.
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No (default: 5) | Max results per category (1-20) |
get_leaderboardAgent leaderboard ranked by composite scores (service, usage, freshness, profile).
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No (default: 1) | Page number |
| page_size | integer | No (default: 20) | Items per page (max 100) |
| network | string | No | Filter by network |
| sort_by | string | No (default: score) | "score", "service", "usage", "freshness", "profile" |
Agent Details
get_agentFull agent details including metadata, OASF classification, reputation, owner, endpoints, and on-chain data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID (e.g. "ethereum-1") |
get_agent_reputationReputation summary: feedback count, average score, and validation count.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID |
get_agent_feedbacksIndividual feedback items with scores, tags, client addresses, and tx hashes.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID |
| page | integer | No (default: 1) | Page number |
| page_size | integer | No (default: 10) | Items per page (max 50) |
get_agent_activitiesOn-chain event history (registrations, reputation updates, validations).
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID |
get_agent_endpoint_healthLive endpoint health checks with response times and HTTP status codes.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID |
get_agent_transactionsTransaction history with gas/fee breakdown, types, and first/latest activity.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | Yes | Agent ID |
Platform Analytics
get_statsPlatform statistics: total agents, active agents, networks, sync status.
No parameters required.
get_registration_trendDaily agent registration counts over a configurable lookback period.
| Parameter | Type | Required | Description |
|---|---|---|---|
| days | integer | No (default: 30) | Lookback period (max 365) |
get_analytics_overviewTransaction stats, daily trends by type, network breakdown, and fees.
| Parameter | Type | Required | Description |
|---|---|---|---|
| days | integer | No (default: 30) | Lookback period (max 365) |
| network | string | No | Filter by network |
get_recent_activitiesPlatform-wide activity feed with pagination.
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No (default: 1) | Page number |
| page_size | integer | No (default: 20) | Items per page (max 100) |
Networks
list_networksAll supported blockchain networks with chain IDs, explorer URLs, and contract addresses.
No parameters required.
get_endpoint_health_statsPlatform-wide endpoint health overview with top agents by reputation.
| Parameter | Type | Required | Description |
|---|---|---|---|
| network | string | No | Filter by network |
Taxonomy
get_taxonomy_distributionOASF skill and domain distribution with agent counts and percentages.
No parameters required.
list_taxonomy_skillsAll 136 OASF skill categories with display names and slugs.
No parameters required.
list_taxonomy_domainsAll OASF domain categories with display names and slugs.
No parameters required.