mcpField
B
beacon-mcp

beacon-mcp

Local
github.com/enrichgateagent-pngSearch0Updated 15w ago
Repository

About beacon-mcp

beacon-mcp brings a capability-searchable index of open-source AI agents into MCP clients. It is for people discovering existing agents, with results ranked by GitHub traction and linked to their projects.

Key features

  1. 01Search agents by task capability
  2. 02Browse top-ranked agents
  3. 03Retrieve an agent's details

Use cases

  1. 01Find agents for PDF extraction
  2. 02Discover agents for website scraping
  3. 03Inspect a specific GitHub agent

MCP support

As an MCP server, it exposes agent search, ranking, and detail lookup tools to clients.

Configuration

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

mcp.json · Universal config
{
  "mcpServers": {
    "enrichgateagent-png-beacon": {
      "command": "npx",
      "args": [
        "-y",
        "beacon-mcp"
      ],
      "env": {
        "BEACON_REGISTRY_URL": "<BEACON_REGISTRY_URL>"
      }
    }
  }
}
Run commandnpx -y beacon-mcp
Environment variables to set
BEACON_REGISTRY_URLOverride the Beacon registry base URL (defaults to the public instance). Not required.

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
npmbeacon-mcp0.1.1

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitnumberNo
querystringYesCapability or task to search for

Details

From the project README

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

ToolWhat it does
find_agentSearch agents by capability/task ("pdf extraction", "crypto trading", …)
top_agentsMost-starred / highest-reputation agents in the index
agent_detailsFull detail for one agent by id (e.g. elizaOS/eliza)

Install

Claude Desktop / Cline / Windsurf — add to your MCP config:

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

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

Config

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

Links

MIT

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.