Skip to content

MCP Server

AlexClaw implements a Model Context Protocol server, allowing external AI clients to discover and invoke skills, run workflows, and browse internal data stores through a standardized protocol.

What is MCP?

MCP is an open protocol that enables AI assistants to interact with external tools and data sources. AlexClaw's MCP server exposes:

  • Tools — all registered skills and workflows, callable by name
  • Resources — knowledge base, memory, workflows, runs, config, and RSS feeds

Supported Clients

Any MCP-compatible client can connect:

Architecture

MCP Client ──Bearer Token──> /mcp endpoint
                                │
                          McpAuth Plug (token validation)
                                │
                          McpForward Plug (deferred init)
                                │
                          Anubis StreamableHTTP Transport
                                │
                          AlexClaw.MCP.Server
                           ├── handle_tool_call  ──> PolicyEngine ──> SkillRegistry ──> Skill.run()
                           ├── handle_resource_read ──> ResourceProvider ──> Context modules
                           └── handle_info (PubSub) ──> tools/list_changed notification

Key Modules

Module Role
AlexClaw.MCP.Server Anubis server — init, tool calls, resource reads, PubSub
AlexClaw.MCP.ToolSchema Maps skills/workflows to MCP tool definitions (Peri format)
AlexClaw.MCP.ResourceProvider Routes resource URIs to context modules
AlexClawWeb.Plugs.McpAuth Bearer token validation
AlexClawWeb.Plugs.McpForward Runtime forwarder to Anubis StreamableHTTP Plug

Transport

Built on anubis_mcp v1.0.0 with Streamable HTTP transport. The server is added to the OTP supervision tree and starts automatically with the application.

Quick Test

Once configured (see Client Setup), verify from the command line:

# Health check — should show mcp: running
curl -s http://localhost:5001/health | jq .mcp

# MCP initialize (raw HTTP — clients handle this automatically)
curl -s http://localhost:5001/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test"}}}'