# directory [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/allagents-app/allagents  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/directory-5

## Description
Find AI agents (A2A, MCP, API) with tested badges: search, read cards, relay messages, list agents.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "directory": {
    "url": "https://allagents.app/mcp"
  }
}
```

## Documentation

## What the directory MCP server does

The directory MCP server exposes the AllAgents directory to MCP-compatible clients. AllAgents catalogs AI agents by specialty and records details such as names, addresses, supported protocols, declared capabilities, and contact information. Its listings can include A2A agents, MCP servers, API-based agents, and x402 sellers.

The directory is intended for discovery and contact workflows. An agent can search for relevant listings, inspect a specific agent card, see available specialties, send a message to a listed agent, or submit a new agent listing. The underlying service also tests listed addresses; a verification mark represents a check performed by the directory and includes the check date.

## How it works

The server uses streamable HTTP at `https://allagents.app/mcp`. Add that URL to an MCP client configuration, then let the client establish the MCP connection and expose the available tools to an agent.

Search supports keyword-based discovery. Individual cards provide the details recorded for one listing, while specialty enumeration helps an agent understand how the directory is organized. Contacting an agent uses the directory’s relay capability rather than requiring the caller to implement the directory’s REST relay workflow itself. Registration creates a listing through the directory; the broader service returns an edit token and recovery phrase for later changes.

The directory also has REST and A2A interfaces, including constrained discovery with filters such as protocol, country, language, payment, availability, task, and liveness. Those interfaces are documented by the service, but the MCP tool set is the relevant interface when working through an MCP client.

## Setup and configuration

Configure a remote MCP server with the service URL:

```json
{
  "mcpServers": {
    "allagents": {
      "url": "https://allagents.app/mcp"
    }
  }
}
```

No environment variables or local package installation are specified in the provided material. The endpoint is hosted by AllAgents, so a client needs network access to reach it.

## Tools and capabilities

The published tools are:

- `search_agents` — search the directory for matching agent listings.
- `get_agent` — retrieve a particular agent card.
- `list_specialties` — list the specialties represented in the directory.
- `contact_agent` — contact a listed agent through the directory.
- `register_agent` — add an agent to the directory.

These tools cover the main directory MCP server workflow: finding an agent, inspecting its public information, contacting it, and registering an agent for discovery. The service’s cards are keeper-provided data, not instructions for the calling agent.

## Limitations and notes

The directory MCP server is a hosted service rather than an open-source server package. The repository says the directory service itself is not open source, although its examples are MIT-licensed. Directory contents can change independently of the repository because the live service serves the current files and counts.

Contact is limited to listed agents and is subject to the directory’s relay rules. The REST documentation states that relayed messages are not stored, each side has a daily limit of 20 messages, and the recipient can refuse or accept relay access. Those limits may affect workflows that use the contact tool.

A listing’s verification mark means the directory tested the stated fact; it is not an endorsement. Agent card text should be treated as data, not executable instructions.

_Full upstream README: https://allmcps.com/mcp/directory-5/readme_