Vestige — Claude Code MCP server: what it does, how to install
Equips AI agents with an append-only causal memory log and stops dangerous tool calls like database drops or force pushes before they execute.
claude mcp add vestige -- npx -y vestige-mcp-serverWhat Vestige does
Vestige stores facts inside Strata, an append-only log. Every entry receives a cryptographic receipt upon save. If fresh context makes an older fact relevant, Retroactive Salience Backfill surfaces it for upcoming planning tasks. Lookups rely on exact identifiers and tags. Lookups avoid vector similarity entirely.
When an agent breaks code, causal_walk traces recorded dependencies backward to find the root cause. The gather command walks backward starting from a GitHub issue reference. The package includes Operator Lite, a tool call guard with 30 rules. Exactly 15 rules block operations like database drops or force pushes. Another 15 log suspect commands for manual review.
Installing Operator Lite requires Python 3. The installer inspects your past 30 days of agent commands to demonstrate what it would have blocked. The code is licensed under AGPL-3.0.
What it helps with
- Block destructive terminal commands like table drops and force pushes
- Record agent context in an append-only log with receipts instead of vectors
- Trace execution failures back to their trigger using
causal_walk - Resurface older relevant facts when related information arrives
Example prompts for the agent
- Find the root cause of the build failure using
causal_walkfrom issue #142. - Save a note that Maya has a peanut allergy and link it to dinner plans.
- Review recent tool executions and report which actions Operator Lite stopped.
How to install Vestige
Platform CLI
claude mcp add vestige -- npx -y vestige-mcp-serverPlatform CLI
codex mcp add vestige -- npx -y vestige-mcp-serverConfig file
{
"mcpServers": {
"vestige": {
"command": "npx",
"args": [
"-y",
"vestige-mcp-server"
]
}
}
}Config file
{
"servers": {
"vestige": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vestige-mcp-server"
]
}
}
}Platform CLI
gemini mcp add vestige npx -y vestige-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Vestige
How do I install Vestige in Claude Code?
Run claude mcp add vestige -- npx -y vestige-mcp-server in your terminal and restart your client.
What does Vestige do?
It gives AI agents an append-only memory log with verifiable receipts and stops unapproved tool executions through its Operator Lite guard.
How does Operator Lite stop dangerous commands?
It evaluates calls against 30 rules: 15 immediately halt destructive commands like force pushes, while 15 record the call for manual inspection.
