LOB BrainLOB Brain
Docs/MCP Quickstart

Quick MCP Setup

Connect LOB Brain with your AI agent in under 5 minutes. This guide will walk you through setting up a Spoke node and integrating it with Claude, Gemini, Cursor, or any IDE that supports MCP.

1Prerequisites

• LOB Brain Executable (the executable file lob-brain.exe or linux binary)

• An IDE with MCP support: Cursor, VS Code + Continue, Windsurf, or Claude Desktop

• Project Directory: The directory you wish to initialize LOB Brain in

2Install LOB Brain Spoke

terminal

# Simply drop the executable into your desired project directory

Windows: Copy lob-brain.exe into the project directory.

Linux/Mac: Copy the lob-brain binary into the project directory.

# (No complex installation, no external dependencies. This is a standalone engine)

3Initialize Workspace

terminal

# Open a terminal in your project directory and run the initialization command

$ ./lob-brain.exe init --mode spoke --attach cursor

▶ Injecting ./.cursorrules ...

▶ Injecting ./mcp.json ...

✓ IDE workspace configured.

# Or configure for VS Code / Windsurf

$ ./lob-brain.exe init --mode spoke --attach vscode

This command automatically creates the config file lob-brain.toml containing policies and injects the MCP settings into your IDE.

4Activate License Key (v2.7.0+)

Starting with version 2.7.0, LOB Brain requires a License Key to activate memory limits (LOB Lite, LOB Pro, or Enterprise). Open lob-brain.toml and paste your key:

lob-brain.toml
[license]
key = "LOB-LITE-XXXX-XXXX-XXXX-XXXX"
# If you do not have a key, a 7-day free trial will be activated by default.

5Configure MCP Server

Your IDE requires this configuration to locate the server daemon. The init command has configured this automatically. If you need to set it manually, use this template:

mcp.json
{
  "mcpServers": {
    "lob-brain": {
      "command": "./lob-brain.exe",
      "args": ["--mode", "spoke", "--stdio"],
      "env": {
        "LOB_PROJECT": "my-project"
      }
    }
  }
}

6Verify Connection

Once the MCP server loads, your AI agent will automatically detect LOB's 12 core tools. Test the connection by asking the agent to check the system status:

agent conversation

You ask in chat: "Please check my LOB Brain status."

Agent responds: Calling brain_status()...

→ Total memories: 0

→ Projects: (none)

→ Database: healthy

✓ LOB Brain connection verified.

📦Available MCP Tools

brain_store

Memory

brain_query

Memory

brain_recall

Memory

brain_context

Memory

brain_search

RAG

brain_ingest

RAG

brain_sources

RAG

brain_status

System

brain_clusters

Analytics

brain_snapshot

Cache

brain_log_session

Logging

brain_sync

Sync

View detailed API reference →

Next Steps