Beacon

The Verifiable Agentic Protocol. Make any repository agent-ready. Instantly.

Beacon is a protocol designed for the Web 4.0 agentic economy. It scans your codebase, infers its capabilities using AI, registers a unique on-chain identity, and exposes standardized tools for autonomous agents via the Model Context Protocol (MCP).

Core Features

• AI-Powered Inference: Automatically generate AAIF-compliant AGENTS.md manifests.
• On-Chain Identity: Register your repository's provenance on Base Mainnet via ERC-7527.
• Native MCP Server: Standards-compliant tool discovery for LLMs (Claude, Cursor, etc.).
• Monetized Validation: Integrated x402 protocol for pay-per-run verification on Base/Solana.

Install

curl -fsSL https://raw.githubusercontent.com/DavidNzube101/beacon/master/install.sh | sh

Quickstart

1. Generate Manifest

export GEMINI_API_KEY=your_key
beacon generate ./my-project

2. Register On-Chain Identity

export AGENT_PRIVATE_KEY=0x...
beacon register ./

3. Serve as MCP Tool

beacon serve --port 8080
# AI agents can now connect to http://localhost:8080/sse

Usage

Protocol Commands

Advanced Registration

Beacon uses a linear bonding curve for registration. Early adopters secure their repository's on-chain provenance at a lower premium.

beacon register ./ --chain base

AI Providers

Interoperability (MCP)

Beacon implements the Model Context Protocol. Any agent that speaks MCP can discover Beacon tools automatically.

Claude Desktop Configuration:

{
  "mcpServers": {
    "beacon": {
      "url": "http://localhost:8080/sse"
    }
  }
}

How it works

1. Scan: Walks the repo, extracting source files, package manifests, and OpenAPI specs.
2. Infer: Identifies capabilities, endpoints, and schemas using framework-aware AI inference.
3. Register: Wraps the repository URL into a unique on-chain identity token (ERC-7527).
4. Expose: Serves tools to the agentic web via standard REST and MCP interfaces.