retainLABSCO SUMMARY
One MCP endpoint per bank is the isolation boundary, not a naming convention.
Because the endpoint carries the bank id, a client is wired to exactly one memory store and cannot reach another — which is what makes per-user or per-project memory safe to run on a shared server. Note that this is infrastructure you operate: it wants a server, a database and an LLM provider, and the local-model options exist precisely so memory contents need not leave your network.
What it is
A memory system for agents, with an MCP endpoint built into every server. Memories go in through retain, come back through recall, and reflect produces a considered answer over them. Facts do not stay a flat pile: they are consolidated in the background into observations that keep their supporting quotes and are refined rather than overwritten as evidence arrives.
What you get
- Retain, recall and reflect available as tools to any MCP client, one endpoint per bank at
http://localhost:8888/mcp/<YOUR_BANK_ID>/, enabled by default - Banks as isolated memory stores — one brain per user, agent or project, with no cross-bank leakage, carrying background context and disposition traits that shape how reflect reasons
- Observations: deduplicated beliefs built from many memories, each keeping exact supporting quotes and a proof count
- Mental models and knowledge pages — standing answers to questions about a bank, rewritten in the background, read as a database lookup with no retrieval and no model call
- Multilingual handling that preserves the input language and native scripts end to end
- Memory Defense, an opt-in per-bank policy that scans every retain against 45 secret and PII patterns and either redacts or blocks the item before storage
Requirements
A running server plus an LLM provider key. The quickest path is Docker: run ghcr.io/vectorize-io/hindsight:latest with HINDSIGHT_API_LLM_API_KEY set, exposing the API on 8888 and the UI on 9999. pip install hindsight-api, Docker Compose with external PostgreSQL, and a Helm chart are the other options. HINDSIGHT_API_LLM_PROVIDER selects among 25+ providers including fully local ones like ollama and lmstudio; existing ChatGPT, Claude and GitHub Copilot subscriptions work without an API key. Hindsight Cloud is the managed alternative; the README points clients at https://api.hindsight.vectorize.io with an API key, and gives no Cloud address for MCP. Version 0.9.2.
Setup effort
Follow the published steps — pip install hindsight-api
USE CASES
01
Giving one agent memory that survives its session
Point the client at that agent's bank endpoint; retain writes what happened, recall brings back what matters, and consolidation happens in the background between sessions.
02
Keeping per-user memories genuinely separate
Give each user their own bank. Isolation is strict, so a fact learned about one user can never surface in another's conversation.
03
Booting an agent with settled knowledge instead of rediscovering it
Define a mental model as a question about the bank; Hindsight writes and rewrites the answer in the background, and reading it costs a database read.
04
Storing conversations that may contain secrets
Turn on Memory Defense for that bank so tokens and PII are redacted or blocked at retain time rather than discovered in storage later.
3 tools
Listed in project docs. Your client may show a different list.
recallreflectBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- pip on PATH
- HINDSIGHT_API_LLM_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install hindsight-api
export HINDSIGHT_API_LLM_API_KEY=<YOUR_HINDSIGHT_API_LLM_API_KEY>
hindsight-apiMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
npx @vectorize-io/hindsight-coding-agents install claude-codeThe configuration on this page does not set HINDSIGHT_API_LLM_API_KEY; the project's instructions set it with an export line. That line reaches only programs started from the same terminal, so to supply HINDSIGHT_API_LLM_API_KEY, start your client or the server from that terminal.
Any MCP client — HTTP
ANY MCP CLIENT — HTTP · URL
http://localhost:8888/mcp/<YOUR_BANK_ID>/The configuration on this page does not set HINDSIGHT_API_LLM_API_KEY; the project's instructions set it with an export line. That line reaches only programs started from the same terminal, so to supply HINDSIGHT_API_LLM_API_KEY, start your client or the server from that terminal.
