ZizkaDB
Persistent memory and a tamper-evident audit log for agents, with causal lineage
- Pricing
- Freemium
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 0.1.13
- Listing updated
- 3 days ago
About ZizkaDB
ZizkaDB is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Every event an agent logs is SHA-256 checksummed and hash-chained, so a verify_chain call can prove that its history is untouched. The site ties this to EU AI Act Article 12 record-keeping. The point is to answer why an agent did something, with each decision linked to its cause, rather than showing a span tree of what happened.
Agents log through log_event, then use keyword and semantic search, causal queries, and time travel to see state at an earlier moment. The dashboard adds session replay and drift measurement against a baseline. Each agent needs its own API key, and the name used when logging must match the key's agent name unless you use a tenant-wide key.
The Python server runs over stdio with uvx or pip. Point ZIZKADB_HOST at a self-hosted Docker Compose install, where a local dev key is injected automatically, or use the managed cloud. The site says the self-hosted stack is AGPL licensed, and cloud plans start at 50k events a month.
Install
Run in a terminal
claude mcp add zizkadb-mcp --env ZIZKADB_API_KEY='<ZIZKADB_API_KEY>' -- uvx zizkadb-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"zizkadb-mcp": {
"command": "uvx",
"args": [
"zizkadb-mcp"
],
"env": {
"ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"zizkadb-mcp": {
"command": "uvx",
"args": [
"zizkadb-mcp"
],
"env": {
"ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"zizkadb-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zizkadb-mcp"
],
"env": {
"ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"zizkadb-mcp": {
"command": "uvx",
"args": [
"zizkadb-mcp"
],
"env": {
"ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"zizkadb-mcp": {
"command": "uvx",
"args": [
"zizkadb-mcp"
],
"env": {
"ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
}
}
}
}Configuration
ZIZKADB_HOSTZizkaDB API URL, e.g. http://localhost:8000 for self-hosted. Default: ZizkaDB Cloud.ZIZKADB_API_KEYAgent API key (zizkadb_live_...). Not needed for a local development install.ZIZKADB_TELEMETRYSet to false to turn off the anonymous install ping.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- log_event
- Logs an event for a named agent.
- verify_chain
- Verifies that the agent's logged history is untouched.
What it does
- Hash-chained audit log
- Events are checksummed and chained so history can be verified.
- Causal lineage
- Trace each agent decision back to its cause.
- Time travel
- Inspect logged state as it was at an earlier time.
- Keyword and semantic search
- Search an agent's persistent memory both ways.
- Session replay and drift
- The dashboard replays sessions and measures drift against a baseline.
- Self-host or cloud
- Run Docker Compose on your infrastructure or use managed cloud.
Good for
- Find out why an agent changed behavior after a prompt tweak
- Prove an agent's logged history has not been altered
- Give a coding agent persistent searchable memory
- Replay a production session end to end
- Keep records for EU AI Act review
Pricing
Freemium
Self-host free; managed cloud plans from 50k events a month, prices not published
Prices change. Check db.zizka.ai before you buy.
ZizkaDB FAQ
Do I need an API key?
On cloud, yes: create an agent in the dashboard and set ZIZKADB_API_KEY. A local self-hosted install injects a dev key automatically.
Why does signing up not log anything?
You must create an agent and key and add it to the config; signup alone does not log events.
How is it installed?
With pip install zizkadb-mcp or uvx zizkadb-mcp over stdio.
Is there telemetry?
The server sends an anonymous install ping when it starts. Set ZIZKADB_TELEMETRY to false to opt out.
Is ZizkaDB free?
ZizkaDB has a free plan, with paid plans for more usage or features.
How do I add ZizkaDB to Claude Code?
Run this command in your terminal: claude mcp add zizkadb-mcp --env ZIZKADB_API_KEY='<ZIZKADB_API_KEY>' -- uvx zizkadb-mcp
What are the best alternatives to ZizkaDB?
The closest alternatives to ZizkaDB are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to ZizkaDB

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools