Skip to content
MCP server

ZizkaDB

Persistent memory and a tamper-evident audit log for agents, with causal lineage

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools