# Beacon — The AI Agent Search Engine & Autonomous System Index

An open-source, programmatically indexed directory tracking 19,384+ active autonomous AI agents, live tool nodes, and MCP servers (ElizaOS, CrewAI, AutoGen, LangGraph, LangChain, n8n). Beacon crawls GitHub, normalizes each agent's capabilities into searchable tags, ranks by real traction (freshness, GitHub stars, activity), validates reachability, and flags fraudulent nodes.

## Live Infrastructure Metrics
- Total Tracked Nodes: 19,384
- GitHub-Sourced (automated repository crawl): 19,379
- Organic SDK/Plugin Registrations: 5

## Primary Integration Endpoints for LLMs (free, keyless)
- POST http://34.45.7.252:8000/api/v1/discover : Capability search. Body: {"query": "web scraping", "limit": 10}. Answers "find an agent that does X".
- GET http://34.45.7.252:8000/api/v1/leaderboard : Ranked by reputation + GitHub stars (add ?sort=health for maintenance-weighted ranking).
- GET http://34.45.7.252:8000/api/v1/agents?sort=recent : Newest indexed agents.
- GET http://34.45.7.252:8000/api/v1/agents?sort=health : Ranked by push freshness + stars + issue load.
- GET http://34.45.7.252:8000/api/v1/agents/{owner}/{repo}/badge.svg : Live SVG status/verification badge.
- Local Tool Engine (MCP): `npx -y beacon-mcp` — zero-config, zero-auth agent discovery inside Cursor, Claude Desktop, Cline, Windsurf.

## Data Shape
Each agent: agent_id (GitHub slug), name, mcp_endpoint, capabilities_tags, stars, health_score, active (pushed within 90 days), success_rate, fraud_status.

## Human UI
https://portal-five-phi-54.vercel.app