The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Beacon MCP listing page.
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.
| 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) |
Claude Desktop / Cline / Windsurf — add to your MCP config:
Cursor — Settings → MCP → add a stdio server: npx -y beacon-mcp.
That's it. Ask your agent: "Use beacon to find an agent that scrapes websites."
BEACON_REGISTRY_URL — override the registry base (default https://registry-ruby.vercel.app).MIT