# ZizkaDB

> ZizkaDB is a freemium MCP server for knowledge and memory. Persistent memory and a tamper-evident audit log for agents, with causal lineage. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted, API, Web
- **Website:** https://db.zizka.ai
- **Repository:** https://github.com/zizka-ai-sl/zizkadb/tree/HEAD/mcp
- **MCP Registry name:** io.github.ZIZKA-AI-SL/zizkadb-mcp
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add zizkadb-mcp --env ZIZKADB_API_KEY='<ZIZKADB_API_KEY>' -- uvx zizkadb-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zizkadb-mcp": {
      "command": "uvx",
      "args": [
        "zizkadb-mcp"
      ],
      "env": {
        "ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zizkadb-mcp": {
      "command": "uvx",
      "args": [
        "zizkadb-mcp"
      ],
      "env": {
        "ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zizkadb-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zizkadb-mcp"
      ],
      "env": {
        "ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zizkadb-mcp": {
      "command": "uvx",
      "args": [
        "zizkadb-mcp"
      ],
      "env": {
        "ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zizkadb-mcp": {
      "command": "uvx",
      "args": [
        "zizkadb-mcp"
      ],
      "env": {
        "ZIZKADB_API_KEY": "<ZIZKADB_API_KEY>"
      }
    }
  }
}
```

## Tools

- `log_event`: Logs an event for a named agent.
- `verify_chain`: Verifies that the agent's logged history is untouched.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/zizkadb
