MCP server for ZizkaDB. Gives any MCP-compatible AI agent persistent memory, keyword and semantic search, causal debugging, time travel, and proof that its history is untouched (verify_chain).

Setup (managed cloud)

Sign up at db.zizka.ai
Dashboard → Create agent (e.g. cursor-agent) — copy the API key shown once
Paste the key into your MCP config (see below)
Reload MCP in Cursor — use the same agent name in log_event calls
Events appear on your dashboard within seconds

Agent name must match. If your key is for cursor-agent, log with agent="cursor-agent". For many dynamic agent names, use a tenant-wide key (Settings).

Signup alone does not log events. You must create an agent + key and add it to ZIZKADB_API_KEY.

Cursor — 30 second setup

Paste into ~/.cursor/mcp.json (or .cursor/mcp.json in your project), then reload MCP:

{
  "mcpServers": {
    "zizkadb": {
      "command": "uvx",
      "args": ["zizkadb-mcp"],
      "env": { "ZIZKADB_API_KEY": "zizkadb_live_xxxx" }
    }
  }
}

Self-host: use the Self-hosted block below (ZIZKADB_HOST only — dev key auto-injected on localhost).

Prerequisite: install uv for uvx:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install

pip install zizkadb-mcp
# or
uvx zizkadb-mcp

Self-hosted

{
  "mcpServers": {
    "zizkadb": {
      "command": "uvx",
      "args": ["zizkadb-mcp"],
      "env": {
        "ZIZKADB_HOST": "http://localhost:8000"
      }
    }
  }
}

On localhost, the dev key (zizkadb_dev_local) is auto-injected — no API key needed. Must match DEV_API_KEY in infra/.env if you changed it.

Environment variables

Variable	Default	Purpose
`ZIZKADB_HOST`	`https://db.zizka.ai`	API base URL
`ZIZKADB_API_KEY`	—	Required on cloud. Your key from db.zizka.ai Settings
`AGENTDB_API_KEY`	—	Legacy alias for `ZIZKADB_API_KEY`
`AGENTDB_HOST`	—	Legacy alias for `ZIZKADB_HOST`
`ZIZKADB_TELEMETRY`	on	Set `false` to opt out (anonymous install ping when MCP server starts)