Registry Quickstart

Get the MCP Registry running in your environment.

Recommended: Bootstrap Deployment

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

cd deploy/tier1-discovery/docker-compose
./bootstrap.sh

This deploys the full Discovery & Registry tier (wl-registry, wl-discover, PostgreSQL, OpenBao, Caddy) with TLS and automated setup. See the Deployment Guide for details.

The registry will be available at https://localhost:8443.

Register a Scanner

Before registering MCP servers, create a scanner:

curl -X POST http://localhost:8080/scanners \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "scanner-001",
    "name": "Development Scanner",
    "api_key": "your-secret-api-key"
  }'

Register an MCP Server

curl -X POST http://localhost:8080/mcp-servers \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-api-key" \
  -d '{
    "name": "web-search",
    "command": "npx",
    "args": ["-y", "@anthropic/mcp-server-web-search"],
    "capabilities": {
      "tools": [
        {
          "name": "search_web",
          "description": "Search the web",
          "input_schema": {
            "type": "object",
            "properties": {
              "query": {"type": "string"}
            }
          }
        }
      ]
    }
  }'

List MCP Servers

# All servers
curl http://localhost:8080/mcp-servers

# Filter by capability
curl "http://localhost:8080/mcp-servers?capability=search_web"

API Endpoints

Endpoint	Method	Description
/mcp-servers	GET	List all MCP servers
/mcp-servers	POST	Register new server
/mcp-servers/{id}	GET	Get server by ID
/mcp-servers/{id}	PUT	Update server
/mcp-servers/{id}	DELETE	Remove server
/scanners	GET	List scanners
/scanners	POST	Create scanner
/health	GET	Health check
/ready	GET	Readiness check

Next Steps

• Discovery Configuration — Automate server discovery
• API Reference — Full API documentation
• Authorization — Add Cedar policy enforcement