MCP Server Integration

ZeroDB ships as MCP (Model Context Protocol) servers that let AI agents access memory, vectors, files, and more directly from their tools.

Two Servers

Server	Tools	Install	Best For
zerodb-memory-mcp	6	npm i ainative-zerodb-memory-mcp	Agent memory only
zerodb-mcp-server	69+	pip install zerodb-mcp	Full database access

Quick Setup

The fastest way to get started:

npx zerodb-cli init

This auto-detects your editor (Claude Code, Cursor, VS Code, Windsurf) and configures the MCP server.

Manual Setup — Claude Code

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "zerodb-memory": {
      "command": "npx",
      "args": ["-y", "ainative-zerodb-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "your-api-key",
        "ZERODB_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Manual Setup — Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "zerodb-memory": {
      "command": "npx",
      "args": ["-y", "ainative-zerodb-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "your-api-key",
        "ZERODB_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Memory MCP Tools (6 tools)

Tool	Description
zerodb_store_memory	Store a memory with content and metadata
zerodb_search_memory	Search memories by keyword or metadata
zerodb_semantic_search	Semantic similarity search across memories
zerodb_get_context	Get agent context window for current session
zerodb_embed_text	Generate embeddings for text
zerodb_clear_session	Clear session-scoped memories

Full MCP Server (69+ tools)

The full server includes everything in the memory server plus:

• Vector operations — upsert, search, list, delete, stats
• Table operations — create, insert, query, update, delete
• File operations — upload, download, list, presigned URLs
• Event operations — create, list events
• PostgreSQL — provision, query, manage dedicated instances
• Graph operations — traverse, GraphRAG search, entity management

Install:

pip install zerodb-mcp

Remote MCP (Hosted)

Don't want to run locally? Use the hosted remote MCP server — no local install needed. Configure in your editor settings with the remote URL.

Next Steps

• ZeroDB Overview — Full product docs
• ZeroMemory — Cognitive memory system
• API Reference — REST API documentation