BrainCTL

Setup

Install BrainCTL in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tschonleber/brainctl

Follow the installation instructions in the repository README, then restart your MCP client.

{ "mcpServers": { "brainctl": { "command": "brainctl-mcp" } } }

Add to~/.claude/claude_desktop_config.json,~/.cursor/mcp.json, or equivalent. Full tool list and decision tree:MCP_SERVER.md. v1→v2 name migration map:docs/TOOL_MIGRATION_V2.md.

// Discover what's available subsystem_list() // 27 brain subsystems subsystem_list_actions(name="lc") // valid actions for LC // Then act subsystem_status(name="lc", agent_id="me") subsystem_emit(name="lc", action="fire", payload={"trigger_name":"x", "surprise_magnitude":0.7}) belief(action="collapse", payload={...}) trust(action="show", payload={"agent_id":"me"})

brainctl memory add "content" -c convention # store a memory brainctl search "query" # FTS5 search brainctl vsearch "semantic query" # vector search (requires [vec]) brainctl entity create "Alice" -t person # create entity brainctl entity relate Alice works_at Acme # link entities brainctl event add "deployed v3" -t result # log an event brainctl decide "title" -r "rationale" # record a decision brainctl export --sign -o bundle.json # signed export brainctl verify bundle.json # verify a bundle brainctl wallet new # create managed signing wallet brainctl wallet export-key # base58 private key for Phantom/Backpack/Solflare/Glow import brainctl stats # DB overview brainctl doctor # health check brainctl lint # quality issues brainctl gaps scan # coverage + orphan + broken-edge scans brainctl consolidate cycle # full consolidation pass

- Write gate(W(m)): surprise scoring rejects redundant writes. Bypass withforce=True.
- Three-tier routing: high-value memories get full indexing; low-value get lightweight storage.
- Duplicate suppression: near-duplicates reinforce existing memories instead of creating new rows.
- Half-life decay: unused memories fade at a rate set by category. Recalled memories are reinforced.
- Consolidation: Hebbian learning, temporal promotion, compression — runs on a cron schedule.

Tested with default settings, no tuning for benchmark data. Two harnesses ship in the tree:

- tests/bench/— single-system retrieval baselines forBrain.searchandcmd_search, gated against regression in CI.
- tests/bench/competitor_runs/— same-fixture head-to-head harness with adapters for Mem0, Letta, Zep, Cognee, MemPalace, OpenAI Memory. Skip-not-fabricate contract: missing SDK / API key raisesCompetitorUnavailableinstead of returning a fake 0. Each result row carries aprovenanceblock recordingretrieval_mode,vector_enabled,embedding_model,rerankers_active, and the fullsearch_argsso the JSON is self-describing.