English Français العربية

io.github.peureka/agentlookup-mcp

Official registry Search and web

Search, discover, and register AI agents in the public registry at agentlookup.dev.

Source code Documentation

What can you do with io.github.peureka/agentlookup-mcp?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentlookup-mcp
Claude Code 
claude mcp add agentlookup-mcp -- npx -y agentlookup-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentlookup-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "agentlookup-mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. agentlookup
  2. Install
  3. Tools
  4. No API key required
  5. Heartbeat token
  6. Links

agentlookup

MCP server for the public AI agent registry at 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):

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

Cursor (.cursor/mcp.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:

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

Frequently asked questions

What is io.github.peureka/agentlookup-mcp?

Search, discover, and register AI agents in the public registry at agentlookup.dev.

How do I install io.github.peureka/agentlookup-mcp?

It runs on your machine. In Claude Code: claude mcp add agentlookup-mcp -- npx -y agentlookup-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.peureka/agentlookup-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.peureka/agentlookup-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.peureka/agentlookup-mcp?

It is published by peureka. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.