Hindsight™ is an agent memory system built to create smarter agents that learn over time. Most agent memory systems focus on recalling conversation
Hindsight™ is an agent memory system built to create smarter agents that learn over time. Most agent memory systems focus on recalling conversation history. Hindsight is focused on making agents that learn, not just remember. That is what the hindsight mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
The server publishes 11 tools. What each one is for:
World — ** Facts about the world ("The stove gets hot")Experiences — ** Agent's own experiences ("I touched the stove and it really hurt")Retain — ** Provide information to Hindsight that you want it to rememberRecall — ** Retrieve memories from HindsightReflect — ** Reflect on memories and experiences to generate new observations and insights from existing memoriesSemantic — Vector similarityKeyword — BM25 exact matchingGraph — Entity/temporal/causal linksTemporal — Time range filteringPlatform — DockerClient — The Client tool exposed by this serverConfiguration is passed through the environment: OPENAI_API_KEY, HINDSIGHT_DB_PASSWORD, HINDSIGHT_API_LLM_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
The server ships on npm as skills, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Among the knowledge and memory options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Hindsight's toolset — World, Experiences, Retain and 8 more — is a fair guide to whether it matches your workflow. It is maintained by vectorize-io; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Hindsight's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| World | ** Facts about the world ("The stove gets hot") |
| Experiences | ** Agent's own experiences ("I touched the stove and it really hurt") |
| Retain | ** Provide information to Hindsight that you want it to remember |
| Recall | ** Retrieve memories from Hindsight |
| Reflect | ** Reflect on memories and experiences to generate new observations and insights from existing memories. |
| Semantic | Vector similarity |
| Keyword | BM25 exact matching |
| Graph | Entity/temporal/causal links |
| Temporal | Time range filtering |
| Platform | Docker |
| Client | The Client tool exposed by this server. |
{
"mcpServers": {
"hindsight": {
"command": "npx",
"args": ["-y", "skills"],
"env": {
"OPENAI_API_KEY": "your-value",
"HINDSIGHT_DB_PASSWORD": "your-value",
"HINDSIGHT_API_LLM_API_KEY": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| OPENAI_API_KEY | Credential the server authenticates with. | Yes |
| HINDSIGHT_DB_PASSWORD | Configuration value read at startup. | Optional |
| HINDSIGHT_API_LLM_API_KEY | Credential the server authenticates with. | Yes |
A knowledge graph your assistant keeps between sessions — entities, relations and observations that persist.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
A structured scratchpad for hard problems — stepwise reasoning with revisions, branches and visible logic.
Symbol-level code navigation, refactoring and memory for coding agents — the IDE brain your assistant has been missing.
Chat with your second brain — search, read and write vault notes through the Local REST API.