Full MCP Server

The full ZeroDB MCP server (zerodb-mcp) provides 69+ tools covering the entire ZeroDB data layer.

pip install zerodb-mcp

Tool Categories

Category	Tools	Key Operations
Memory	3	Store, search, get context
Vector	10	Upsert, search, list, delete, stats
Embedding	3	Embed text, batch embed, model info
Table/NoSQL	8	Create, insert, query, update, delete tables
File Storage	6	Upload, download, list, delete, presigned URLs
Event Stream	5	Create, list, get events
PostgreSQL	6	Provision, query, connection info, logs, usage
Project	7	Info, stats, settings, API keys
Graph	6	Traverse, GraphRAG, neighbors, entities, merge, stats
RLHF	10	Feedback collection, rating, analysis
Admin	5	Health, status, diagnostics

Top Tools

Vectors

• zerodb_vector_upsert — Store text with auto-generated embeddings
• zerodb_vector_search — Semantic similarity search
• zerodb_vector_list — List vectors with pagination
• zerodb_vector_stats — Collection statistics

Tables

• zerodb_table_create — Create a NoSQL table
• zerodb_table_insert — Insert rows
• zerodb_table_query — Query with filters
• zerodb_table_update — Update rows by filter

Files

• zerodb_file_upload — Upload a file
• zerodb_file_download — Download a file
• zerodb_file_list — List files
• zerodb_file_url — Generate presigned URL

Graph

• zerodb_graphrag_search — Hybrid vector + graph search
• zerodb_graph_traverse — Multi-hop traversal
• zerodb_entity_neighbors — Direct connections
• zerodb_entity_list — List entities

Setup

{
  "mcpServers": {
    "zerodb": {
      "command": "python",
      "args": ["-m", "zerodb_mcp"],
      "env": {
        "ZERODB_API_KEY": "your-api-key",
        "ZERODB_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Or use the CLI for auto-setup:

npx zerodb-cli init

Deprecation Notice

ZERODB_USERNAME/ZERODB_PASSWORD authentication is deprecated and will be removed in v3.0. If you are using username/password auth, please switch to ZERODB_API_KEY.

Get your API key at ainative.studio/settings. See the migration guide below.

Migrating to API Key Auth

If your config looks like this:

{
  "env": {
    "ZERODB_USERNAME": "your-email@example.com",
    "ZERODB_PASSWORD": "YourPassword123!"
  }
}

Replace it with:

{
  "env": {
    "ZERODB_API_KEY": "zdb_your-api-key-here"
  }
}

API keys are simpler (no login/token refresh), more secure (no plaintext passwords), and revocable.

Remote MCP (Hosted)

Don't want to run locally? Use the hosted remote MCP server:

{
  "mcpServers": {
    "zerodb": {
      "url": "https://mcp.ainative.studio/zerodb",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

No local install needed — the server runs in AINative's cloud.