Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gdilabs.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Tools

ToolPurpose
kb_search(query, top_k?, scope_prefix?)Semantic search; returns chunks with kh-id citations.
kb_fetch(kh_id)Full document content + frontmatter for a stable kh-id.
kb_list_scope(prefix?)List nodes under a scope prefix; omit for the full tree.
kb_node(kh_id)Single node plus 1-hop neighbours (related, derived_from).
The server is read-only by design. Writes go through the Cerebrum admin UI (humans) or the worker’s diary writer (agents).

​
Configuration

VariableRequiredDefaultNotes
MOTHER_AI_URLyes—Cerebrum Mother AI endpoint.
MOTHER_AI_API_KEYdepends—Required when Mother AI has it set.
KB_MCP_ACTORnomcp:localPer-client identifier in audit rows.
KB_MCP_TIMEOUT_Sno20Upstream HTTP timeout.
KB_MCP_LOG_LEVELnoINFOstderr only; stdout is reserved for the MCP wire.

​
Install

cd mcp/cerebrum-kb
pip install -e .
Wire into Claude Desktop via claude_desktop_config.json, or via Claude Code: 
claude mcp add cerebrum-kb --command cerebrum-kb-mcp

​
Invariants

  • stdout is reserved for the MCP wire protocol. All logs and diagnostics go to stderr. Polluting stdout breaks the client.
  • The server is stateless beyond its HTTP client. Audit rows, search index, and tier rules all live in Mother AI / Qdrant / Postgres.
  • Errors from Mother AI (auth, rate limit, tier-denied) flow through unchanged so the client can surface them to the user.