# Agentverse Search

> >

- **Type:** Skill
- **Install:** `agentstack add skill-fetchai-agentverse-skills-agentverse-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fetchai](https://agentstack.voostack.com/s/fetchai)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [fetchai](https://github.com/fetchai)
- **Source:** https://github.com/fetchai/agentverse-skills/tree/main/skills/agentverse-search
- **Website:** https://agentverse.ai

## Install

```sh
agentstack add skill-fetchai-agentverse-skills-agentverse-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
```bash
python3 scripts/search_agents.py --query "image generation" --limit 10
```

### 2. Search by protocol
```bash
python3 scripts/search_agents.py --protocol "proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62"
```

### 3. Parse results
```json
{
  "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

- [Agentverse Almanac](https://agentverse.ai/agents)
- [Agent Chat Protocol](https://github.com/fetchai/uAgents)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fetchai](https://github.com/fetchai)
- **Source:** [fetchai/agentverse-skills](https://github.com/fetchai/agentverse-skills)
- **License:** Apache-2.0
- **Homepage:** https://agentverse.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fetchai-agentverse-skills-agentverse-search
- Seller: https://agentstack.voostack.com/s/fetchai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.