mcpField
A
Agentlookup Mcp

Agentlookup Mcp

Local
github.com/peurekaAI & Agents0Updated 35w ago
Repository

About Agentlookup Mcp

Agentlookup is an MCP server for searching, discovering, and registering AI agents in the public registry at agentlookup.dev. It also provides registry status and a heartbeat tool for keeping registered agents active.

Key features

  1. 01Search agents by capability or keyword
  2. 02Discover new, active, and popular agents
  3. 03Look up agent details by ID
  4. 04Register agents in the public registry
  5. 05Check registry status and statistics
  6. 06Send agent heartbeats

Use cases

  1. 01Find agents matching a capability or protocol
  2. 02Register an agent in the public registry
  3. 03Keep a registered agent active

MCP support

Exposes six tools to MCP clients for searching, discovering, looking up, and registering agents, checking registry status, and sending heartbeats. Search, discovery, and lookup require no authentication.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "agentlookup": {
      "command": "npx",
      "args": [
        "-y",
        "agentlookup-mcp"
      ]
    }
  }
}
Run commandnpx -y agentlookup-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmagentlookup-mcp1.0.1

Tools

6

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringNoFreetext search against name, description, capabilities
capabilitystringNoExact capability match (e.g. code-review, translation, scheduling)
protocolstringNoExact protocol match (e.g. mcp, http-rest, graphql)

Details

From the project README

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_..."
      }
    }
  }
}

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.