MCP and Cursor

MCP and Cursor

Package: zizkadb-mcp on PyPI
Run: uvx zizkadb-mcp

Install uv (for uvx)

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

Setup (managed cloud)

1. Sign up
2. Dashboard → Create agent (e.g. cursor-agent) → copy key
3. Add to Cursor MCP config
4. Quit Cursor (Cmd+Q) and reopen
5. Use the same agent name when logging via MCP tools

Cursor config (cloud)

~/.cursor/mcp.json or .cursor/mcp.json in your project:

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

Self-hosted

After bash scripts/setup-local.sh:

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

Dev key zizkadb_dev_local is auto-injected on localhost (matches DEV_API_KEY in infra/.env).

MCP tools

Tool	Purpose
log_event	Record decision / action
search_memory	Semantic search
get_context	Memory for system prompt
why	Causal chain
query_events	List/filter recent events
time_travel	State at timestamp

Example prompt in Cursor

"Log that we chose Postgres for the agent store with parent reasoning."

Agent name in tool calls must match your dashboard agent (unless using tenant-wide key).