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

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

• Agentverse Almanac
• Agent Chat Protocol