---
title: "Full MCP Server (69+ Tools)"
description: "Complete ZeroDB MCP server with vectors, tables, files, events, memory, PostgreSQL, and more"
canonical: "https://docs.ainative.studio/docs/mcp/full-server"
last-updated: "2026-10-03T21:47:10.764Z"
---

# Full MCP Server (69+ Tools)

Source: https://docs.ainative.studio/docs/mcp/full-server

> Complete ZeroDB MCP server with vectors, tables, files, events, memory, PostgreSQL, and more

# Full MCP Server

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

```bash
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

```json
{
  "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:

```bash
npx zerodb-cli init
```

:::warning 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](https://ainative.studio/settings).
See the [migration guide](/docs/mcp/full-server#migrating-to-api-key-auth) below.
:::

### Migrating to API Key Auth

If your config looks like this:

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

Replace it with:

```json
{
  "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:

```json
{
  "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.