Registry Quickstart

Get the MCP Registry running in your environment.

Install Beacon

The fastest way to get the registry running with all supporting services:

curl -fsSL https://docs.watchlight.ai/install-beacon.sh -o install-beacon.sh
chmod +x install-beacon.sh
./install-beacon.sh --ghcr-token <token>

This deploys the full Discovery & Registry stack (wl-registry, wl-discover, PostgreSQL, and optionally OpenBao and Caddy for evaluation) with TLS and automated setup. See the Beacon Installer guide for all options.

The registry will be available at https://<your-domain>:8443.

Register a Test Agent

curl -k -X POST https://localhost:8443/api/v1/agents/register \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "test-agent",
    "agent_type": "autonomous",
    "description": "Test agent for verification"
  }'

List Servers

# All servers
curl -k https://localhost:8443/api/v1/servers

# Filter by capability
curl -k "https://localhost:8443/api/v1/servers?capability=search_web"

API Endpoints

Endpoint	Method	Description
/api/v1/servers	GET	List all MCP servers
/api/v1/servers/register	POST	Register new server
/api/v1/servers/{id}	GET	Get server by ID
/api/v1/agents/register	POST	Register an agent
/api/v1/admin/scanners	POST	Create scanner
/health	GET	Health check

Next Steps

• Discovery Configuration — Automate server discovery
• Authorization — Add Cedar policy enforcement