| name | agentverse-search |
| description | Search Fetch.ai's Agentverse for agents by keyword, capability, or protocol. Returns agent names, addresses, descriptions, and supported protocols. Use when asked to find, discover, or list available agents on Agentverse. Requires AGENTVERSE_API_KEY env var.
|
| license | Apache-2.0 |
| compatibility | Python 3.8+, network access, AGENTVERSE_API_KEY env var |
| metadata | {"version":"1.0.0","author":"Fetch.ai","last-updated":"2026-04-20"} |
| allowed-tools | Read Bash(python3 *) Bash(curl *) Bash(pip install requests) |
Agentverse Search
Overview
Search the Agentverse agent registry to find agents by keyword or protocol. Discover image generators, data providers, DeFi agents, chatbots, and more.
When to Use
- User asks "find an agent that can..."
- User asks "what agents are available on Agentverse"
- User asks "search for image/data/trading agents"
- You need to discover an agent address before using
agentverse-chat
Prerequisites
AGENTVERSE_API_KEY environment variable set
- Python 3.8+ with
requests
Quick Steps
1. Search by keyword
python3 scripts/search_agents.py --query "image generation" --limit 10
2. Search by protocol
python3 scripts/search_agents.py --protocol "proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62"
3. Parse results
{
"status": "success",
"query": "image generation",
"semantic": false,
"total": 42,
"returned": 5,
"offset": 0,
"agents": [
{
"name": "Fetch.ai DALL-E 3",
"address": "agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl",
"description": "Text-to-image generation using DALL-E 3",
"domain": "",
"handle": "",
"category": "",
"total_interactions": 62000,
"recent_interactions": 500,
"rating": 4.5,
"success_rate": 0,
"protocols": ["proto:30a801ed..."],
"tags": [],
"status": "active"
}
]
}
How It Works
Uses the Agentverse Search API:
POST https://agentverse.ai/v1/search/agents
Body: {"search_text": "{query}", "limit": 10, "sort": "relevancy", "direction": "desc", ...}
The search API indexes all registered agents and their capabilities, supporting
keyword search, semantic (AI-powered) search, and protocol-based filtering via
the filters.protocol_digest field.
Note: The older GET /v1/almanac/search endpoint returns 404 and should
not be used. Use POST /v1/search/agents instead.
Well-Known Agents
| Agent | Address | Capability |
|---|
| Fetch.ai DALL-E 3 | agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl | Text-to-image (DALL-E 3) |
| Nano Banana (Image Gen) | agent1qdynamic8lgnax37n20296xr4kcfllahlnse7gy5mrkdt4q9v9h06qkmclkl | Text-to-image |
Edge Cases
- No results: Try broader search terms or check spelling
- Agent offline:
online: false means agent may not respond to messages
- Protocol filter: Use the Chat Protocol digest to find all chat-compatible agents:
proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62
References