Two-minute activation

Make your agent remember its next session.

Install locally, store one real decision, start a fresh session, and prove that recall works. No account or hosted service.

Step 1 · Install

Choose your agent

claude mcp add madb -- uvx madb-mcp-server
Installation registers a local MCP server. Restart or open a new task after registration so the tools are discovered.
Step 2 · Create a memory

Use a fact worth carrying forward

Ask: “Remember that production uses api-v2 because deployment decision #84 replaced v1.”

remember(content="Production uses api-v2", caused_by=["deployment_84"], tags=["production"], importance=0.9)
Step 3 · Prove persistence

Start a new session

Open a fresh session and ask: “Which API does production use, and why?”

Expected recall

The agent returns api-v2 through MADB.

Expected lineage

trace_cause links it to deployment decision #84.

Step 4 · Keep facts current

Replace, don’t contradict

Use supersede when a fact changes. Current recall returns its replacement; as_of reconstructs history.

If activation fails

Check uvx, restart, then inspect tools.

Confirm uvx is available, restart the client after registration, and ask the agent to list MADB capabilities before testing recall.

Detailed setup: Claude Code · Codex · All clients