beacon-mcp

beacon-mcp

The search engine for AI agents — inside your agent.

Beacon indexes thousands of open-source AI agents from GitHub, ranked by real traction (stars, activity), searchable by capability. This MCP server puts that index inside Claude Desktop, Cursor, Cline, Windsurf, or any MCP client — so you can ask "find me an agent that does X" and get real, linkable results.

No API key. No payment. Just discovery.

Tools

Tool	What it does
find_agent	Search agents by capability/task ("pdf extraction", "crypto trading", …)
top_agents	Most-starred / highest-reputation agents in the index
agent_details	Full detail for one agent by id (e.g. elizaOS/eliza)

Remote MCP (no install)

Hosted Streamable HTTP endpoint for Smithery, Glama, and HTTP-capable clients:

https://beacon-mcp-taupe.vercel.app/mcp

Install (local stdio)

npx beacon-mcp init

Writes Beacon into ~/.cursor/mcp.json, project .cursor/mcp.json, and Claude Desktop config. Restart your editor.

Manual — add to MCP config:

{
  "mcpServers": {
    "beacon": {
      "command": "npx",
      "args": ["-y", "beacon-mcp"],
      "env": { "BEACON_REGISTRY_URL": "https://registry-ruby.vercel.app" }
    }
  }
}

Cursor — Settings → MCP → add stdio server: npx -y beacon-mcp.

That's it. Ask your agent: "Use beacon to find an agent that scrapes websites."

Config

• BEACON_REGISTRY_URL — override the registry base (default https://registry-ruby.vercel.app).

Links

• Live portal: https://portal-five-phi-54.vercel.app
• Registry API: https://registry-ruby.vercel.app

MIT