Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Brain Server — Who it’s for (target audiences)

Meta description: Brain Server is a local-first, offline, deterministic semantic-memory and knowledge-graph server for AI agents. Zero token cost, human-gated writes, GDPR/DSAR erasure, SHA-256 audit, and the current MCP 2026-07-28 stateless protocol — all in one self-hosted Rust binary.

Brain Server is a local-first, offline, deterministic semantic-memory and knowledge-graph server for AI agents. This page maps the product’s shipped capabilities to the concrete people and teams who use them, so you can tell at a glance whether it fits your job — and exactly what you’d get.

Every claim below is reverse-checked against the current source (v1.27.22): a “Shipped” row names a real route, role preset, or test that exists in this repository today. “Planned” means a documented roadmap ceiling. Nothing here is a promise dressed as a feature — the honest ceiling is stated plainly at the end, and so is the honest “when not to choose it.”


In one minute — is this you?

Answer these to self-select before reading the tables:

  • You build or run an AI agent and need it to remember — you want conversation history, decisions, runbooks, and customer context recalled deterministically, not hallucinated. → §3 AI / agent builders.
  • You run customer support or a helpdesk and want “how did we resolve this before?” answered from a grounded memory your team can review. → §1 support & contact-center.
  • You’re in a regulated industry (finance, healthcare, legal, government) where memory must stay in-house, be auditable, and be erasable on request. → §2 enterprise & regulated.
  • You deploy on thin or air-gapped hardware (Jetson, Raspberry Pi, field ops) with no cloud dependency. → §4 edge & field.
  • You’re an individual who wants a private second brain that does temporal, point-in-time recall. → §5 knowledge workers.
  • You’re an SI/MSP/consultant standing up auditable memory layers for clients. → §6 ecosystem & delivery partners.

The honest frame first (read this before the tables)

The shipped product is a single-node, loopback-first memory server. Today it has per-domain isolation, per-tenant audit, DSAR (data-subject access requests), PII redaction, a human write-gate, and the current MCP 2026-07-28 stateless protocol. What it does not have yet is multi-team tenancy — running several client accounts as isolated tenants on one shared backend. That is the documented v2.0 “Cortex” milestone (call-center intelligence), so the BPO and multi-client contact-center rows below are the roadmap the product is building toward, not its current single-node form.

In plain terms:

  • What it is: your own private memory server for an AI agent — no cloud, no embedding API fees, no telemetry. One Rust binary (v1.27.22) + one SQLite file.
  • What it costs to run: local static embeddings (model2vec), so recall costs zero embedding tokens and zero decision tokens; fits a Jetson/Raspberry Pi.
  • What it gives an agent: deterministic hybrid recall (vector + full-text + graph), a knowledge graph, temporal evidence, and an audit trail — without an LLM in the loop making retrieval or redaction decisions.
  • What it enforces: human-gated writes (proposals), prompt-injection quarantine, PII redaction on read, GDPR/DSAR erasure with certificates, and a SHA-256 hash-chained audit log.
  • The one big gap: shared multi-tenant packaging. If you need several client accounts on one backend as hard-isolated tenants, that’s v2.0. Until then each tenant gets its own domain on its own node.

Shipped, in numbers (all source-checked)

CapabilityThe real number
Self-contained deployment1 binary + 1 SQLite file (WAL), single process
Memory cost per recall0 embedding tokens, 0 decision tokens (local static model2vec)
Retrieval quality gater@5 = r@10 = 0.919, MRR 0.905, nDCG@10 0.909 on the frozen 37-query / 10-doc smoke set; CI pins floors r5/r10/mrr ≥ 0.85
Audit integritySHA-256 hash chain, verifiable end-to-end via /audit/verify
Agent protocolUMP 1.0 conformance: L3 (13/13 checks), MCP 2026-07-28 stateless, OpenAPI
Human write-gateProposals: novelty/conflict/salience scored, approved or rejected by a human
ErasureDSAR locate → export → purge → chain-verifiable certificate
Domain isolationPer-domain graphs + auto-routing; registration capped at 256 domain DBs

Honest calibration on the numbers. The retrieval figures above are a directional signal on a small frozen smoke set, not a large benchmark — the repo itself says so. They prove the recall pipeline is deterministic and gated; they do not claim a production-quality corpus score. Expand to ≥100 judged queries before treating any recall number as a floor for your workload.


1. Customer-support & contact-center operations

The v2.0 “Cortex” milestone is explicitly call-center intelligence. The controls those teams need are largely shipped today (isolation, audit, DSAR, PII, human-gated writes); the shared-tenant packaging is the planned part.

Who you areWhat you needWhat Brain Server gives youStatus
BPO (Business Process Outsourcer)Serve multiple client accounts with hard isolation; per-client agent-assist memory; per-client audit + DSAR; PII containmentPer-domain isolation, per-tenant audit chain, DSAR + deletion certificates, PII redaction, human write-gateControls shipped; multi-client tenancy = v2.0 Cortex (planned)
In-house contact / call centerOne org, many teams; agent memory that recalls past resolutions, policies, customer context; supervision + auditDeterministic recall, knowledge graphs, temporal evidence, HITL write gate, audit chain, reviewer-calibration stripShipped (single-org form); multi-team packaging in v2.0
Customer-support team / helpdeskFaster, grounded answers; “how did we resolve this before?”; no fabricated answersCalibrated abstention, span verification (/verify), recall traces, resolution knowledge graphShipped
Managed-service / shared-services supportStandardized knowledge across internal teams with per-team scopeDomains + centroid routing, per-agent opt-in, chat-type gatingShipped

Try it (10 minutes, single node): brain-server + brain ingest-dir a handful of past resolutions, then brain recall "how did we fix the onboarding issue" and brain get <id> to pull the source chunk. Approve a captured fact through the proposal queue to see the human write-gate in action.

2. Enterprise & regulated industries (sovereignty)

Brain Server is self-hosted, offline-capable, and audited, so it fits organizations for whom memory must stay in-house and be provable.

Who you areWhat you needWhat Brain Server gives youStatus
Financial servicesPII containment, immutable audit, DSAR (GDPR/CCPA), no data egressSHA-256 audit chain, read-time PII redaction, DSAR/certificates, loopback-only defaultShipped
Healthcare & clinicalLocal records, on-prem, explainable recall, erasureLocal-first, /verify span check, DSAR, /.well-known/ai-noticeShipped
Legal & complianceTamper-evident logs, Art 22 explainability, Art 50 originHash chain + /audit/verify, replayable recall traces, origin metadataShipped
Government / public sectorAir-gapped or on-prem, procurement-grade evidenceSingle binary, no telemetry, RFP_RESPONSE_KIT.md, threat modelShipped
Any regulated enterpriseSOC 2 / ISO 42001 evidence baseDocumented posture + evidence kit (COMPLIANCE.md)Shipped (posture, not certification)

Try it: run /audit/verify (returns {ok: true} if the chain is intact) and run a DSAR dry-run (POST /dsar {"dry_run": true}) to see the locate/export footprint with zero erasure. Both are live, audited endpoints.

3. AI / agent builders & platforms

The current primary audience — teams and individuals building agents that need memory.

Who you areWhat you needWhat Brain Server gives youStatus
OpenClaw usersDeterministic memory in the memory slot, zero token costNative kind: "memory" plugin (autoRecall / autoCapture / Proposal), plugin 0.4.5Shipped
Agent / LLM developersA self-hosted memory store with standard contractsOpen HTTP API, MCP binary, OpenAPI, UMP 1.0 L3Shipped
MCP-adopting teams (2026)A memory backend that speaks the current stateless MCPThe mcp binary implements MCP 2026-07-28: stateless, server/discover, per-request _meta, ttlMs/cacheScope — no initialize handshakeShipped
Edge / privacy-first agent buildersMemory on-device, no embedding APILocal static model2vec, offline, bounded RSS (default 512 MiB)Shipped
Agent platforms & ISVsA memory backend to embed without lock-inStandard-based (UMP, MCP, open HTTP), self-hostableShipped

Try it: brain recall "…" from the CLI, or point any MCP-capable host at the mcp binary (it implements the 2026-07-28 stateless spec out of the box). See docs/mcp.md for the exact install + a working request.

4. Edge, field & hardware deployments

Who you areWhat you needWhat Brain Server gives youStatus
Retail / logistics field opsOffline memory on thin hardwareSingle binary, low power, Jetson / Raspberry PiShipped
Industrial / remote / air-gapped sitesNo cloud dependency, deterministicLocal static embeddings, no data egressShipped

5. Knowledge workers & individuals

Who you areWhat you needWhat Brain Server gives youStatus
Personal-knowledge (PKM) usersA private second brain, temporal recallDomains (health/business/code), point-in-time recallShipped
Researchers & academicsA reproducible memory/RAG substrateOpen source, benchmark harness, frozen judged corpusShipped

6. Ecosystem & delivery partners

Who you areWhat you needWhat Brain Server gives youStatus
SIs / MSPs / consultantsA deployable, auditable memory layer to stand up for clientsOne binary, edge-ready, documented deployment + DSAR drillsShipped
Platform / tooling vendorsAn embeddable, standard memory contractUMP 1.0 L3, MCP 2026-07-28, OpenAPIShipped

Why it’s genuinely useful (the practical cases)

Beyond the tables, here is what Brain Server does that most “agent memory” solutions don’t — in terms a buyer can hand to a decision-maker:

  • Zero-cost recall. Because embeddings are local/static and the recall decision is made in code (not by an LLM), every memory read costs no embedding tokens and no decision tokens. In an agent that recalls every turn, that’s the difference between a memory feature you can afford to leave on and one you disable to save money.
  • No fabricated answers. When retrieval quality is too low to support a claim, /recall returns {decision: "low_confidence", hits: []} instead of top-1 garbage. /verify does deterministic span checking — is a claim literally in a stored chunk? No LLM guessing.
  • Memory that can’t leak instructions. Every recalled block is wrapped in an untrusted sentinel fence; the invisible-Unicode/bidi smuggling set and markdown references are stripped on every read seam. A malicious stored chunk cannot smuggle a “system:” injection or exfiltrate context to the model.
  • Memory your reviewer can trust. Writes go through a human-gated proposal queue by default; a reviewer sees novelty, conflict, salience, a PII-safe digest, and a calibration strip — not a rubber stamp.
  • Memory you can prove. The audit log is a SHA-256 hash chain (/audit/verify returns {ok: true}), recall traces are replayable, DSAR produces deletion certificates. “Show me” replaces “trust me.”
  • Speaks the 2026 standard. The MCP server implements the stateless MCP 2026-07-28 spec — server/discover instead of initialize, per-request _meta, ttlMs/cacheScope caching. It’s ready for the current generation of MCP hosts out of the box.

When not to choose it (the honest other side)

Being direct saves everyone a wasted proof-of-concept:

  • You need shared multi-tenant SaaS — several customer accounts on one hosted backend with per-tenant limits and billing. Brain Server is single-node and per-tenant-isolation is per-domain on separate nodes until v2.0.
  • You want a hosted, managed memory API with no ops. This is self-hosted; you run the binary and the SQLite file.
  • You need semantic quality on a huge corpus today. The shipped recall figures are validated on a small smoke set — a production-sized judged corpus is a roadmap item, not a current guarantee.
  • You want the model to judge relevance or summarize. Brain Server is deliberately deterministic — no LLM in the retrieval or redaction path. If you want learned re-ranking, that’s a different design.
  • You require an SOC 2 / ISO 42001 attestation certificate. The repo ships a documented engineering posture, not an org-level certification.

Frequently asked questions

Is Brain Server free / self-hosted? Open source, MIT-licensed, self-hosted. One Rust binary + one SQLite file; no cloud dependency and no telemetry.

Does using it cost tokens? No. Embeddings are local/static (model2vec) and retrieval/redaction decisions are deterministic code — recall costs zero embedding and decision tokens. The only context cost is the capped snippets injected into a turn.

How does it stop an agent from fabricating answers? /recall returns {decision: "low_confidence", hits: []} when retrieval quality is too low, and /verify does deterministic span verification (is the claim literally in a stored chunk?).

How do I make sure my data can be erased on request? POST /dsar runs locate → export → purge and issues a chain-verifiable deletion certificate. A dry_run shows the footprint without erasing anything.

What MCP standard does it speak? The mcp binary implements the current MCP 2026-07-28 stateless spec: server/discover, per-request _meta, ttlMs/cacheScope, no initialize handshake. It also speaks UMP 1.0 (L3 conformance, 13/13 checks) and plain OpenAPI over HTTP.

Is it multi-tenant? Not yet. Per-domain isolation is shipped; multi-team tenancy is the v2.0 “Cortex” roadmap milestone.


The honest ceiling (state this in any pitch)

  • Multi-client / multi-team tenancy is v2.0 “Cortex”, not today. A BPO running several client accounts as isolated tenants on one shared backend gets the controls (isolation, audit, DSAR, PII) shipped now, but the shared-tenant packaging and per-tenant limits are the documented v2.0/v2.1 roadmap. Until then, per-client isolation is per-domain on separate nodes.
  • Not a certification. SOC 2 / ISO 42001 attestation are organization-level audits outside this repo; COMPLIANCE.md is a documented engineering posture.
  • PII at rest is not encrypted — full-disk encryption is the operator’s layer (LUKS/FileVault).
  • Deterministic, not learned — recall and redaction are heuristic / deterministic, not model-inference.

Next steps

  • Overview — what it is and the five differentiators.
  • Use cases — worked technical scenarios.
  • RFP Response Kit — evidence-backed answers for procurement.
  • Media kit — positioning + one-liners for press/marketing.
  • Human in the loop — the operator’s field manual, incl. §7 the erasure procedure (the documented, audited path a BPO/QA/Admin follows to delete memory).
  • MCP — the current stateless MCP server + install.
  • OpenClaw integration — the plugin (0.4.5) and its token-resolution ladder.
  • Roadmap — the v2.0 “Cortex” trajectory this map points at.
  • BENCHMARKS — the recall numbers behind the “in numbers” table, with their honest calibration caveats.