MCP Server

the-brain implements the Model Context Protocol, allowing any MCP-compatible client to use it as a memory backend.

Supported Clients

• Claude Desktop — Add to claude_desktop_config.json
• Cursor IDE — Configure MCP server in Cursor settings
• Zed — Add to Zed's context server config

Starting the Server

# stdio transport (for Claude Desktop)
the-brain mcp serve

# SSE transport (for network clients)
the-brain mcp serve --sse --port 9422

Claude Desktop Config

{
  "mcpServers": {
    "the-brain": {
      "command": "bun",
      "args": ["run", "the-brain", "mcp", "serve"]
    }
  }
}

For remote mode with auth:

{
  "mcpServers": {
    "the-brain": {
      "command": "bun",
      "args": ["run", "the-brain", "mcp", "serve", "--sse"],
      "env": {
        "THE_BRAIN_AUTH_TOKEN": "mb_xxx"
      }
    }
  }
}

Available Capabilities

• 20 tools: memory CRUD, graph ops, brain management, training, pipeline
• 11 resources: stats, memories, identity, projects, training status
• SSE subscriptions: real-time updates on consolidation events

See Also

• MCP Tools Reference — Full tool listing
• Remote Mode — Multi-machine setup