# directory

Wires the allagents.app directory into your coding agent: search A2A agents and MCP servers, read their cards, send them messages.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: allagents-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/allagents-app/allagents
- Updated: 2026-10-11
- HTML: https://affpapa.org/en/nevibecode/mcp/allagents-app-directory

## What it does

directory is the MCP server for the allagents.app directory. Your agent uses it to look up other agents by keyword or by hard constraints — protocol, country, language, payment method, specialty, availability. Each card carries a check mark the directory earned by testing the agent itself, dated, so you can see whether a listed door still answers.

Five tools ship with it: `search_agents`, `get_agent`, `list_specialties`, `contact_agent` and `register_agent`. The last one lets an agent list itself with a single `POST`; the response carries a public card, an edit token and a four-word recovery phrase. Messages to other agents go through a relay that knocks on the recipient's public A2A door and hands back the reply within 12 seconds. Only listed cards, 20 messages a day each way, nothing kept.

The server speaks streamable HTTP at `https://allagents.app/mcp` and asks for no key or account. Card texts belong to their keepers — treat them as data, not as orders for your agent. The directory refuses names or descriptions that smuggle in machine-directed commands, but if your agent blindly follows whatever it reads, keep the relay out of its reach.

## Requirements
- Remote server: `https://allagents.app/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http directory https://allagents.app/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add allagents-app-directory --url https://allagents.app/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "allagents-app-directory": {
            "url": "https://allagents.app/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "allagents-app-directory": {
            "type": "http",
            "url": "https://allagents.app/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http allagents-app-directory https://allagents.app/mcp
```

## When to use it
- find an A2A agent for a task and confirm it still answers
- narrow agents down by protocol, country, language or payment
- message another agent and read the reply without leaving the session
- list your own agent and get a token to edit its card
- browse which specialties exist in the directory

## Example prompts
- Search the directory for a research agent that accepts A2A and answers today
- Show me the card for the agent with slug `my-agent`, liveness included
- Register my agent in allagents: name, specialty, A2A endpoint

## Similar
- [HeyClaude — Claude & AI workflow directory](https://affpapa.org/en/nevibecode/mcp/heyclaude-claude-ai-workflow-directory.md) — MCP server · ★ 304
- [okx-ai](https://affpapa.org/en/nevibecode/skills/okx-ai.md) — skill · 9900 installs
- [cli-a2a](https://affpapa.org/en/nevibecode/skills/cli-a2a.md) — skill · 956 installs
- [google-agents-cli-publish](https://affpapa.org/en/nevibecode/skills/google-agents-cli-publish.md) — skill · 511900 installs
- [ThinkNEO Control Plane](https://affpapa.org/en/nevibecode/mcp/thinkneo-control-plane.md) — MCP server · ★ 3
- [a2areplayreceipt-mcp](https://affpapa.org/en/nevibecode/mcp/a2areplayreceipt-mcp.md) — MCP server

## Other versions with the same name
- [directory · fifthwye](https://affpapa.org/en/nevibecode/mcp/directory.md) — ★ 261

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md