# agentlookup

MCP server for the public AI agent registry at [agentlookup.dev](https://agentlookup.dev).

Search, discover, and register agents from any MCP-compatible client.

## Install

Add to your MCP client config:

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "agentlookup": {
      "command": "npx",
      "args": ["agentlookup-mcp"]
    }
  }
}
```

**Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "agentlookup": {
      "command": "npx",
      "args": ["agentlookup-mcp"]
    }
  }
}
```

## Tools

- `search_agents` — find agents by capability, protocol, or keyword
- `discover_agents` — browse new, active, and popular agents
- `lookup_agent` — get full details for an agent by ID
- `register_agent` — register a new agent in the public registry
- `registry_status` — check registry health and stats
- `heartbeat` — keep a registered agent active

## No API key required

Search, discover, and lookup work without authentication.
Registration is free. No account needed.

## Heartbeat token

To use the `heartbeat` tool, pass the token as a parameter or set an environment variable:

```json
{
  "mcpServers": {
    "agentlookup": {
      "command": "npx",
      "args": ["agentlookup-mcp"],
      "env": {
        "AGENTLOOKUP_HEARTBEAT_TOKEN": "hb_live_..."
      }
    }
  }
}
```

## Links

- Registry: https://agentlookup.dev
- API spec: `curl -H "Accept: application/json" https://agentlookup.dev`
- Status: https://agentlookup.dev/api/status