Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add ainative-zerodb-mcp-server -- npx -y ainative-zerodb-mcp-server@2.5.2In einem Terminal ausführen.
{ "mcpServers": { "ainative-zerodb-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Enterprise-grade Model Context Protocol (MCP) server providing full access to ZeroDB's vector search, quantum compression, PostgreSQL, NoSQL operations, and persistent memory for AI agents.
/v1/auth/login with email field (was broken in v2.2.0)/v1/public/mcp (was dead endpoint)zerodb_generate_embeddings, zerodb_embed_and_store, zerodb_semantic_searchnpm install -g ainative-zerodb-mcp-server
npx ainative-zerodb-mcp-server
Before using the MCP server, you need a ZeroDB account and project.
curl -X POST 'https://api.ainative.studio/v1/public/auth/register' \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "YourSecurePassword123!",
"username": "yourname"
}'
Response:
{
"email": "[email protected]",
"id": "user-uuid-here",
"username": "yourname"
}
After registration, create a project to get your PROJECT_ID:
# 1. Login to get your access token
curl -X POST 'https://api.ainative.studio/v1/auth/login' \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "YourSecurePassword123!"
}'
Response:
{
"access_token": "eyJhbGc...",
"token_type": "bearer",
"expires_in": 1800
}
# 2. Create a project using your token
curl -X POST 'https://api.ainative.studio/v1/public/projects' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE' \
-H 'Content-Type: application/json' \
-d '{
"name": "My ZeroDB MCP Project",
"description": "Project for Claude Desktop MCP integration"
}'
Response:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "My ZeroDB MCP Project",
"status": "ACTIVE",
...
}
Save this Project ID! You'll need it for the MCP configuration.
Add to your Claude Desktop configuration file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"zerodb": {
"command": "npx",
"args": ["ainative-zerodb-mcp-server"],
"env": {
"ZERODB_API_URL": "https://api.ainative.studio",
"ZERODB_PROJECT_ID": "your-project-id-here",
"ZERODB_API_KEY": "your-api-key",
"MCP_CONTEXT_WINDOW": "8192",
"MCP_RETENTION_DAYS": "30"
}
}
}
}
After saving the configuration, restart Claude Desktop to activate the MCP server.
In Claude Desktop, try:
Store a memory: "This is my first ZeroDB memory entry"
Claude will use the zerodb_store_memory tool to persist this information.
All 60 operations are organized into 9 categories. Each operation is exposed as an MCP tool that Claude can invoke.
zerodb_store_memoryStore agent memory in ZeroDB for persistent context across sessions.
Parameters:
content (string, required) - Memory content to storerole (string, required) - Message role: "user", "assistant", or "system"session_id (string, optional) - Session identifier (auto-generated if not provided)agent_id (string, optional) - Agent identifier (auto-generated if not provided)metadata (object, optional) - Additional metadataReturns:
{
"memory_id": "uuid",
"created_at": "2025-10-14T12:00:00Z"
}
Example:
{
"content": "User prefers dark mode and TypeScript",
"role": "system",
"metadata": {
"category": "preferences"
}
}
zerodb_search_memorySearch agent memory using semantic similarity.
Parameters:
query (string, required) - Search querysession_id (string, optional) - Filter by sessionagent_id (string, optional) - Filter by agentrole (string, optional) - Filter by rolelimit (number, optional) - Max results (default: 10)Returns:
{
"memories": [
{
"memory_id": "uuid",
"content": "string",
"role": "user|assistant|system",
"created_at": "timestamp",
"similarity_score": 0.95
}
]
}
Example:
{
"query": "What were the user's preferences?",
"limit": 5
}
zerodb_get_contextGet agent context window for current session, optimized for token limits.
Parameters:
session_id (string, required) - Session identifieragent_id (string, optional) - Agent identifiermax_tokens (number, optional) - Max tokens in context (default: 8192)Returns:
{
"session_id": "uuid",
"agent_id": "uuid",
"total_tokens": 1024,
"memory_count": 15,
"messages": [
{
"role": "user",
"content": "string",
"timestamp": "2025-10-14T12:00:00Z"
}
]
}
Example:
{
"session_id": "session-123",
"max_tokens": 4096
}
zerodb_store_vectorStore vector embedding with metadata (exactly 1536 dimensions).
Parameters:
vector_embedding (array[number], required) - 1536-dimensional vectordocument (string, required) - Source document textmetadata (object, optional) - Document metadatanamespace (string, optional) - Vector namespace (default: "windsurf")Returns:
{
"vector_id": "uuid",
"namespace": "windsurf"
}
Example:
{
"vector_embedding": [0.1, 0.2, ..., 0.9], // 1536 values
"document": "This is the source text",
"metadata": {
"source": "documentation",
"page": 42
}
}
zerodb_batch_upsert_vectorsBatch upsert multiple vectors for improved performance.
Parameters:
vectors (array, required) - Array of vector objects
vector_embedding (array[number], required) - 1536-dimensional vectordocument (string, required) - Source documentmetadata (object, optional) - Document metadatanamespace (string, optional) - Vector namespaceReturns:
{
"success_count": 100,
"failed_count": 0,
"vector_ids": ["uuid1", "uuid2", ...]
}
Example:
{
"vectors": [
{
"vector_embedding": [...],
"document": "Document 1",
"metadata": {"index": 1}
},
{
"vector_embedding": [...],
"document": "Document 2",
"metadata": {"index": 2}
}
],
"namespace": "knowledge-base"
}
zerodb_search_vectorsSearch vectors using semantic similarity.
Parameters:
query_vector (array[number], required) - 1536-dimensional query vectornamespace (string, optional) - Vector namespacelimit (number, optional) - Max results (default: 10)threshold (number, optional) - Similarity threshold 0-1 (default: 0.7)Returns:
{
"vectors": [
{
"vector_id": "uuid",
"document": "string",
"similarity_score": 0.95,
"metadata": {}
}
]
}
Example:
{
"query_vector": [...], // 1536 values
"namespace": "windsurf",
"limit": 20,
"threshold": 0.8
}
zerodb_delete_vectorDelete a specific vector by ID.
Parameters:
vector_id (string, required) - Vector UUID to deleteReturns:
{
"success": true,
"deleted_id": "uuid"
}
Example:
{
"vector_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_get_vectorRetrieve a specific vector by ID.
Parameters:
vector_id (string, required) - Vector UUID to retrieveReturns:
{
"vector_id": "uuid",
"vector_embedding": [...],
"document": "string",
"metadata": {},
"created_at": "timestamp"
}
Example:
{
"vector_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_list_vectorsList vectors with pagination and filtering.
Parameters:
namespace (string, optional) - Filter by namespacelimit (number, optional) - Results per page (default: 50)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"vectors": [...],
"total_count": 1000,
"limit": 50,
"offset": 0
}
Example:
{
"namespace": "windsurf",
"limit": 100,
"offset": 200
}
zerodb_vector_statsGet statistics about vector storage.
Parameters:
namespace (string, optional) - Filter by namespaceReturns:
{
"total_vectors": 10000,
"namespaces": {
"windsurf": 5000,
"default": 5000
},
"storage_bytes": 1048576,
"avg_dimension": 1536
}
Example:
{
"namespace": "windsurf"
}
zerodb_create_vector_indexCreate a vector search index for improved performance.
Parameters:
namespace (string, required) - Namespace to indexindex_type (string, optional) - Index type: "ivfflat" or "hnsw" (default: "hnsw")params (object, optional) - Index-specific parametersReturns:
{
"index_id": "uuid",
"namespace": "windsurf",
"index_type": "hnsw",
"status": "created"
}
Example:
{
"namespace": "windsurf",
"index_type": "hnsw",
"params": {
"m": 16,
"ef_construction": 200
}
}
zerodb_optimize_vectorsOptimize vector storage and indexes.
Parameters:
namespace (string, optional) - Namespace to optimizeReturns:
{
"optimized": true,
"space_saved_bytes": 102400,
"duration_ms": 1500
}
Example:
{
"namespace": "windsurf"
}
zerodb_export_vectorsExport vectors to external format.
Parameters:
namespace (string, required) - Namespace to exportformat (string, optional) - Export format: "json" or "csv" (default: "json")include_embeddings (boolean, optional) - Include vector data (default: false)Returns:
{
"export_id": "uuid",
"download_url": "https://...",
"expires_at": "timestamp"
}
Example:
{
"namespace": "windsurf",
"format": "json",
"include_embeddings": true
}
zerodb_quantum_compressCompress vector using quantum algorithms for reduced storage.
Parameters:
vector_embedding (array[number], required) - 1536-dimensional vector to compresscompression_ratio (number, optional) - Target ratio 0-1 (default: 0.5)algorithm (string, optional) - Algorithm: "qaoa" or "vqe" (default: "qaoa")Returns:
{
"compressed_vector": [...],
"original_dimensions": 1536,
"compressed_dimensions": 768,
"compression_ratio": 0.5,
"fidelity_score": 0.98
}
Example:
{
"vector_embedding": [...],
"compression_ratio": 0.6,
"algorithm": "qaoa"
}
zerodb_quantum_decompressDecompress quantum-compressed vector.
Parameters:
compressed_vector (array[number], required) - Compressed vector dataoriginal_dimensions (number, required) - Original dimension countReturns:
{
"decompressed_vector": [...],
"dimensions": 1536,
"reconstruction_error": 0.02
}
Example:
{
"compressed_vector": [...],
"original_dimensions": 1536
}
zerodb_quantum_hybrid_searchPerform hybrid search using quantum-enhanced similarity.
Parameters:
query_vector (array[number], required) - 1536-dimensional querynamespace (string, optional) - Vector namespacelimit (number, optional) - Max results (default: 10)quantum_weight (number, optional) - Quantum influence 0-1 (default: 0.5)Returns:
{
"vectors": [
{
"vector_id": "uuid",
"document": "string",
"similarity_score": 0.96,
"quantum_score": 0.94,
"hybrid_score": 0.95
}
]
}
Example:
{
"query_vector": [...],
"namespace": "windsurf",
"limit": 10,
"quantum_weight": 0.7
}
zerodb_quantum_optimizeOptimize vector space using quantum optimization.
Parameters:
namespace (string, required) - Namespace to optimizeoptimization_target (string, optional) - "storage" or "search_speed" (default: "storage")Returns:
{
"optimized": true,
"improvement_percentage": 35.5,
"duration_ms": 5000
}
Example:
{
"namespace": "windsurf",
"optimization_target": "search_speed"
}
zerodb_quantum_feature_mapGenerate quantum feature map for vector.
Parameters:
vector_embedding (array[number], required) - 1536-dimensional vectorfeature_map_type (string, optional) - "zz" or "pauli" (default: "zz")Returns:
{
"feature_map": [...],
"quantum_circuit_depth": 10,
"qubit_count": 12
}
Example:
{
"vector_embedding": [...],
"feature_map_type": "pauli"
}
zerodb_quantum_kernelCompute quantum kernel similarity between vectors.
Parameters:
vector_a (array[number], required) - First 1536-dimensional vectorvector_b (array[number], required) - Second 1536-dimensional vectorkernel_type (string, optional) - "linear" or "rbf" (default: "rbf")Returns:
{
"kernel_similarity": 0.92,
"quantum_advantage": 0.15,
"computation_time_ms": 45
}
Example:
{
"vector_a": [...],
"vector_b": [...],
"kernel_type": "rbf"
}
zerodb_create_tableCreate a new NoSQL table with schema.
Parameters:
table_name (string, required) - Table nameschema (object, required) - JSON schema definitiondescription (string, optional) - Table descriptionReturns:
{
"table_id": "uuid",
"table_name": "string",
"created_at": "timestamp"
}
Example:
{
"table_name": "user_profiles",
"schema": {
"user_id": "uuid",
"name": "string",
"email": "string",
"created_at": "timestamp"
},
"description": "User profile information"
}
zerodb_list_tablesList all tables in project.
Parameters:
limit (number, optional) - Results per page (default: 50)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"tables": [
{
"table_id": "uuid",
"table_name": "string",
"row_count": 1000,
"created_at": "timestamp"
}
],
"total_count": 10
}
Example:
{
"limit": 100,
"offset": 0
}
zerodb_get_tableGet table details and schema.
Parameters:
table_id (string, required) - Table UUIDReturns:
{
"table_id": "uuid",
"table_name": "string",
"schema": {},
"row_count": 1000,
"created_at": "timestamp"
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_delete_tableDelete a table and all its data.
Parameters:
table_id (string, required) - Table UUID to deleteReturns:
{
"success": true,
"deleted_id": "uuid",
"rows_deleted": 1000
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_insert_rowsInsert rows into table.
Parameters:
table_id (string, required) - Table UUIDrows (array, required) - Array of row objectsReturns:
{
"inserted_count": 100,
"row_ids": ["uuid1", "uuid2", ...]
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000",
"rows": [
{
"user_id": "user-1",
"name": "John Doe",
"email": "[email protected]"
},
{
"user_id": "user-2",
"name": "Jane Smith",
"email": "[email protected]"
}
]
}
zerodb_query_rowsQuery table rows with filters.
Parameters:
table_id (string, required) - Table UUIDfilters (object, optional) - Query filterslimit (number, optional) - Max results (default: 50)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"rows": [...],
"total_count": 1000,
"limit": 50,
"offset": 0
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"email": {
"$contains": "@example.com"
}
},
"limit": 100
}
zerodb_update_rowsUpdate rows in table.
Parameters:
table_id (string, required) - Table UUIDfilters (object, required) - Row selection filtersupdates (object, required) - Fields to updateReturns:
{
"updated_count": 50,
"row_ids": ["uuid1", "uuid2", ...]
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"user_id": "user-1"
},
"updates": {
"email": "[email protected]"
}
}
zerodb_delete_rowsDelete rows from table.
Parameters:
table_id (string, required) - Table UUIDfilters (object, required) - Row selection filtersReturns:
{
"deleted_count": 25,
"row_ids": ["uuid1", "uuid2", ...]
}
Example:
{
"table_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"created_at": {
"$lt": "2025-01-01"
}
}
}
zerodb_upload_fileUpload file to ZeroDB storage.
Parameters:
file_name (string, required) - File namefile_data (string, required) - Base64-encoded file datacontent_type (string, optional) - MIME typemetadata (object, optional) - File metadataReturns:
{
"file_id": "uuid",
"file_name": "string",
"size_bytes": 1024,
"upload_url": "string"
}
Example:
{
"file_name": "document.pdf",
"file_data": "base64encodeddata...",
"content_type": "application/pdf",
"metadata": {
"category": "documentation"
}
}
zerodb_download_fileDownload file from ZeroDB storage.
Parameters:
file_id (string, required) - File UUIDReturns:
{
"file_id": "uuid",
"file_name": "string",
"file_data": "base64encodeddata...",
"content_type": "string",
"size_bytes": 1024
}
Example:
{
"file_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_list_filesList files with pagination.
Parameters:
limit (number, optional) - Results per page (default: 50)offset (number, optional) - Pagination offset (default: 0)content_type (string, optional) - Filter by MIME typeReturns:
{
"files": [
{
"file_id": "uuid",
"file_name": "string",
"size_bytes": 1024,
"content_type": "string",
"created_at": "timestamp"
}
],
"total_count": 100
}
Example:
{
"limit": 100,
"content_type": "application/pdf"
}
zerodb_delete_fileDelete file from storage.
Parameters:
file_id (string, required) - File UUID to deleteReturns:
{
"success": true,
"deleted_id": "uuid"
}
Example:
{
"file_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_get_file_metadataGet file metadata without downloading.
Parameters:
file_id (string, required) - File UUIDReturns:
{
"file_id": "uuid",
"file_name": "string",
"size_bytes": 1024,
"content_type": "string",
"metadata": {},
"created_at": "timestamp"
}
Example:
{
"file_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_generate_presigned_urlGenerate temporary download URL.
Parameters:
file_id (string, required) - File UUIDexpiry_seconds (number, optional) - URL validity (default: 3600)Returns:
{
"file_id": "uuid",
"presigned_url": "https://...",
"expires_at": "timestamp"
}
Example:
{
"file_id": "123e4567-e89b-12d3-a456-426614174000",
"expiry_seconds": 7200
}
zerodb_create_eventCreate a new event in the event system.
Parameters:
event_type (string, required) - Event type identifierevent_data (object, required) - Event payloadmetadata (object, optional) - Event metadataReturns:
{
"event_id": "uuid",
"event_type": "string",
"created_at": "timestamp"
}
Example:
{
"event_type": "user.signup",
"event_data": {
"user_id": "user-123",
"email": "[email protected]"
},
"metadata": {
"source": "web"
}
}
zerodb_list_eventsList events with filtering and pagination.
Parameters:
event_type (string, optional) - Filter by event typestart_date (string, optional) - Filter by start date (ISO 8601)end_date (string, optional) - Filter by end date (ISO 8601)limit (number, optional) - Results per page (default: 50)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"events": [
{
"event_id": "uuid",
"event_type": "string",
"event_data": {},
"created_at": "timestamp"
}
],
"total_count": 1000
}
Example:
{
"event_type": "user.signup",
"start_date": "2025-10-01T00:00:00Z",
"limit": 100
}
zerodb_get_eventGet specific event by ID.
Parameters:
event_id (string, required) - Event UUIDReturns:
{
"event_id": "uuid",
"event_type": "string",
"event_data": {},
"metadata": {},
"created_at": "timestamp"
}
Example:
{
"event_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_subscribe_eventsSubscribe to event stream (WebSocket).
Parameters:
event_types (array[string], required) - Event types to subscribe tofilters (object, optional) - Additional filtersReturns:
{
"subscription_id": "uuid",
"event_types": ["user.signup", "user.login"],
"websocket_url": "wss://..."
}
Example:
{
"event_types": ["user.signup", "user.login"],
"filters": {
"source": "web"
}
}
zerodb_event_statsGet event statistics and analytics.
Parameters:
event_type (string, optional) - Filter by event typestart_date (string, optional) - Start date (ISO 8601)end_date (string, optional) - End date (ISO 8601)group_by (string, optional) - Group by: "hour", "day", "week" (default: "day")Returns:
{
"total_events": 10000,
"event_types": {
"user.signup": 1000,
"user.login": 9000
},
"timeline": [
{
"date": "2025-10-14",
"count": 500
}
]
}
Example:
{
"start_date": "2025-10-01T00:00:00Z",
"end_date": "2025-10-14T23:59:59Z",
"group_by": "day"
}
zerodb_create_projectCreate a new ZeroDB project.
Parameters:
project_name (string, required) - Project namedescription (string, optional) - Project descriptionsettings (object, optional) - Project settingsReturns:
{
"project_id": "uuid",
"project_name": "string",
"created_at": "timestamp"
}
Example:
{
"project_name": "My AI Application",
"description": "Vector search for customer support",
"settings": {
"retention_days": 90
}
}
zerodb_get_projectGet project details.
Parameters:
project_id (string, required) - Project UUIDReturns:
{
"project_id": "uuid",
"project_name": "string",
"description": "string",
"settings": {},
"created_at": "timestamp"
}
Example:
{
"project_id": "123e4567-e89b-12d3-a456-426614174000"
}
zerodb_list_projectsList all accessible projects.
Parameters:
limit (number, optional) - Results per page (default: 50)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"projects": [
{
"project_id": "uuid",
"project_name": "string",
"created_at": "timestamp"
}
],
"total_count": 10
}
Example:
{
"limit": 100
}
zerodb_update_projectUpdate project settings.
Parameters:
project_id (string, required) - Project UUIDproject_name (string, optional) - New project namedescription (string, optional) - New descriptionsettings (object, optional) - Updated settingsReturns:
{
"project_id": "uuid",
"updated_fields": ["project_name", "settings"],
"updated_at": "timestamp"
}
Example:
{
"project_id": "123e4567-e89b-12d3-a456-426614174000",
"settings": {
"retention_days": 120
}
}
zerodb_delete_projectDelete a project and all its data.
Parameters:
project_id (string, required) - Project UUID to deleteconfirm (boolean, required) - Must be true to confirm deletionReturns:
{
"success": true,
"deleted_id": "uuid",
"deleted_at": "timestamp"
}
Example:
{
"project_id": "123e4567-e89b-12d3-a456-426614174000",
"confirm": true
}
zerodb_get_project_statsGet project usage statistics.
Parameters:
project_id (string, required) - Project UUIDstart_date (string, optional) - Start date (ISO 8601)end_date (string, optional) - End date (ISO 8601)Returns:
{
"project_id": "uuid",
"vector_count": 10000,
"memory_count": 5000,
"table_count": 10,
"file_count": 100,
"storage_bytes": 10485760,
"api_calls": 50000
}
Example:
{
"project_id": "123e4567-e89b-12d3-a456-426614174000",
"start_date": "2025-10-01T00:00:00Z"
}
zerodb_enable_databaseEnable database features for project.
Parameters:
project_id (string, required) - Project UUIDfeatures (array[string], required) - Features to enable: ["vectors", "tables", "files", "events"]Returns:
{
"project_id": "uuid",
"enabled_features": ["vectors", "tables"],
"enabled_at": "timestamp"
}
Example:
{
"project_id": "123e4567-e89b-12d3-a456-426614174000",
"features": ["vectors", "tables", "files"]
}
zerodb_rlhf_interactionCollect user interaction for RLHF training.
Parameters:
session_id (string, required) - Session identifieruser_input (string, required) - User's inputagent_response (string, required) - Agent's responsefeedback_score (number, optional) - User rating 1-5metadata (object, optional) - Additional contextReturns:
{
"interaction_id": "uuid",
"collected_at": "timestamp"
}
Example:
{
"session_id": "session-123",
"user_input": "How do I reset my password?",
"agent_response": "You can reset your password by...",
"feedback_score": 5,
"metadata": {
"model": "claude-3-sonnet",
"response_time_ms": 1200
}
}
zerodb_rlhf_agent_feedbackCollect feedback about agent performance.
Parameters:
agent_id (string, required) - Agent identifiersession_id (string, required) - Session identifierfeedback_type (string, required) - "positive" or "negative"feedback_text (string, optional) - Detailed feedbackmetrics (object, optional) - Performance metricsReturns:
{
"feedback_id": "uuid",
"collected_at": "timestamp"
}
Example:
{
"agent_id": "agent-123",
"session_id": "session-123",
"feedback_type": "positive",
"feedback_text": "Very helpful and accurate responses",
"metrics": {
"accuracy": 0.95,
"helpfulness": 0.9
}
}
zerodb_rlhf_workflowCollect feedback about workflow completion.
Parameters:
workflow_id (string, required) - Workflow identifiersession_id (string, required) - Session identifiercompleted (boolean, required) - Workflow completion statusduration_ms (number, optional) - Workflow durationfeedback (object, optional) - Workflow feedbackReturns:
{
"workflow_feedback_id": "uuid",
"collected_at": "timestamp"
}
Example:
{
"workflow_id": "workflow-123",
"session_id": "session-123",
"completed": true,
"duration_ms": 5000,
"feedback": {
"ease_of_use": 5,
"effectiveness": 4
}
}
zerodb_rlhf_errorCollect error reports for model improvement.
Parameters:
session_id (string, required) - Session identifiererror_type (string, required) - Error categoryerror_message (string, required) - Error descriptioncontext (object, optional) - Error contextuser_impact (string, optional) - Impact level: "low", "medium", "high"Returns:
{
"error_report_id": "uuid",
"collected_at": "timestamp"
}
Example:
{
"session_id": "session-123",
"error_type": "hallucination",
"error_message": "Agent provided incorrect information about product pricing",
"context": {
"user_query": "What is the price?",
"agent_response": "The price is $50"
},
"user_impact": "high"
}
zerodb_rlhf_statusGet RLHF collection status.
Parameters:
session_id (string, optional) - Filter by sessionstart_date (string, optional) - Start date (ISO 8601)end_date (string, optional) - End date (ISO 8601)Returns:
{
"total_interactions": 1000,
"avg_feedback_score": 4.2,
"positive_feedback": 850,
"negative_feedback": 150,
"collection_rate": 0.85
}
Example:
{
"start_date": "2025-10-01T00:00:00Z",
"end_date": "2025-10-14T23:59:59Z"
}
zerodb_rlhf_summaryGet RLHF analytics summary.
Parameters:
group_by (string, optional) - Group by: "agent", "workflow", "session" (default: "agent")start_date (string, optional) - Start date (ISO 8601)end_date (string, optional) - End date (ISO 8601)Returns:
{
"summary": [
{
"group_id": "agent-123",
"interaction_count": 500,
"avg_score": 4.5,
"improvement_trend": 0.15
}
]
}
Example:
{
"group_by": "agent",
"start_date": "2025-10-01T00:00:00Z"
}
zerodb_rlhf_startStart RLHF collection for session.
Parameters:
session_id (string, required) - Session identifiercollection_config (object, optional) - Collection settingsReturns:
{
"session_id": "uuid",
"collection_started": true,
"started_at": "timestamp"
}
Example:
{
"session_id": "session-123",
"collection_config": {
"collect_all_interactions": true,
"require_explicit_feedback": false
}
}
zerodb_rlhf_stopStop RLHF collection for session.
Parameters:
session_id (string, required) - Session identifierReturns:
{
"session_id": "uuid",
"collection_stopped": true,
"stopped_at": "timestamp",
"total_collected": 50
}
Example:
{
"session_id": "session-123"
}
zerodb_rlhf_sessionGet all interactions for a session.
Parameters:
session_id (string, required) - Session identifierlimit (number, optional) - Max results (default: 100)Returns:
{
"session_id": "uuid",
"interactions": [
{
"interaction_id": "uuid",
"user_input": "string",
"agent_response": "string",
"feedback_score": 5,
"timestamp": "timestamp"
}
],
"total_count": 50
}
Example:
{
"session_id": "session-123",
"limit": 200
}
zerodb_rlhf_broadcastBroadcast RLHF event to subscribers.
Parameters:
event_type (string, required) - Event typeevent_data (object, required) - Event payloadtarget_sessions (array[string], optional) - Target session IDsReturns:
{
"broadcast_id": "uuid",
"recipients": 10,
"broadcasted_at": "timestamp"
}
Example:
{
"event_type": "feedback.requested",
"event_data": {
"interaction_id": "interaction-123",
"question": "Was this response helpful?"
},
"target_sessions": ["session-1", "session-2"]
}
zerodb_admin_system_statsGet system-wide statistics (requires admin role).
Parameters:
include_details (boolean, optional) - Include detailed metrics (default: false)Returns:
{
"total_projects": 100,
"total_users": 500,
"total_vectors": 1000000,
"total_storage_bytes": 10737418240,
"active_sessions": 50,
"api_calls_24h": 100000,
"avg_response_time_ms": 150
}
Example:
{
"include_details": true
}
zerodb_admin_list_projectsList all projects in system (requires admin role).
Parameters:
user_id (string, optional) - Filter by userlimit (number, optional) - Results per page (default: 100)offset (number, optional) - Pagination offset (default: 0)Returns:
{
"projects": [
{
"project_id": "uuid",
"project_name": "string",
"user_id": "uuid",
"created_at": "timestamp",
"storage_bytes": 1048576
}
],
"total_count": 100
}
Example:
{
"limit": 500
}
zerodb_admin_user_usageGet user usage statistics (requires admin role).
Parameters:
user_id (string, required) - User UUIDstart_date (string, optional) - Start date (ISO 8601)end_date (string, optional) - End date (ISO 8601)Returns:
{
"user_id": "uuid",
"project_count": 5,
"vector_count": 10000,
"storage_bytes": 10485760,
"api_calls": 50000,
"cost_estimate_usd": 25.50
}
Example:
{
"user_id": "user-123",
"start_date": "2025-10-01T00:00:00Z"
}
zerodb_admin_healthGet system health status (requires admin role).
Parameters:
Returns:
{
"status": "healthy",
"database": "connected",
"storage": "healthy",
"quantum_service": "operational",
"cache": "healthy",
"uptime_seconds": 86400,
"last_check": "timestamp"
}
Example:
{}
zerodb_admin_optimizeOptimize database and storage (requires admin role).
Parameters:
optimization_type (string, required) - "vacuum", "reindex", or "all"tables (array[string], optional) - Specific tables to optimizeReturns:
{
"optimized": true,
"optimization_type": "all",
"duration_ms": 30000,
"space_freed_bytes": 1048576,
"improvements": {
"query_performance": 0.25,
"storage_efficiency": 0.15
}
}
Example:
{
"optimization_type": "all"
}
Dedicated PostgreSQL database operations for advanced SQL workloads.
zerodb_postgres_queryExecute SQL query on your provisioned PostgreSQL instance with comprehensive security validations.
Parameters:
sql (string, required) - SQL query to executeparams (array[string], optional) - Query parameters for prepared statementsread_only (boolean, optional) - Enforce read-only mode (SELECT only), default: falsetimeout_seconds (number, optional) - Query timeout in seconds, default: 30max_rows (number, optional) - Maximum rows to return, default: 1000Returns:
{
"query_id": "q_abc123",
"query_type": "SELECT",
"rows_returned": 10,
"rows_affected": 0,
"execution_time_ms": 45.2,
"columns": ["id", "name", "email"],
"rows": [{"id": 1, "name": "User", "email": "[email protected]"}],
"success": true
}
Security Features:
Example:
{
"sql": "SELECT * FROM users WHERE created_at > $1 LIMIT 10",
"params": ["2025-01-01"],
"read_only": true,
"timeout_seconds": 30
}
zerodb_postgres_schema_infoGet detailed database schema information including tables, columns, indexes, and constraints.
Parameters:
table_name (string, optional) - Specific table to inspect (omit for all tables)include_indexes (boolean, optional) - Include index information, default: trueinclude_constraints (boolean, optional) - Include constraint information, default: trueinclude_stats (boolean, optional) - Include table statistics, default: falseReturns:
{
"schema": "public",
"total_tables": 5,
"database_size_mb": 150.5,
"tables": [
{
"table_name": "users",
"columns": [
{"name": "id", "type": "INTEGER", "nullable": false, "primary_key": true},
{"name": "email", "type": "VARCHAR(255)", "nullable": false, "unique": true}
],
"indexes": [
{"name": "users_pkey", "columns": ["id"], "unique": true},
{"name": "users_email_idx", "columns": ["email"], "unique": true}
],
"row_count": 1000,
"size_mb": 25.5
}
]
}
Example:
{
"table_name": "users",
"include_indexes": true,
"include_constraints": true
}
zerodb_postgres_create_tableCreate a new table with complete schema definition including columns, constraints, and indexes.
Parameters:
table_name (string, required) - Name of the table to createcolumns (array, required) - Column definitions
name (string, required) - Column nametype (string, required) - Column type (e.g., "VARCHAR(255)", "INTEGER", "TIMESTAMP")nullable (boolean, optional) - Allow NULL values, default: trueprimary_key (boolean, optional) - Is primary key, default: falseunique (boolean, optional) - Unique constraint, default: falsedefault (string, optional) - Default valueindexes (array, optional) - Index definitions
name (string, optional) - Index name (auto-generated if not provided)columns (array[string], required) - Columns to indexunique (boolean, optional) - Unique index, default: falseif_not_exists (boolean, optional) - Only create if table doesn't exist, default: trueReturns:
{
"table_name": "products",
"created": true,
"columns_count": 5,
"indexes_created": 2,
"indexes": [
{"index_name": "products_sku_idx", "success": true},
{"index_name": "products_name_idx", "success": true}
]
}
Example:
{
"table_name": "products",
"columns": [
{"name": "id", "type": "SERIAL", "primary_key": true},
{"name": "sku", "type": "VARCHAR(50)", "nullable": false, "unique": true},
{"name": "name", "type": "VARCHAR(255)", "nullable": false},
{"name": "price", "type": "DECIMAL(10,2)", "nullable": false},
{"name": "created_at", "type": "TIMESTAMP", "default": "NOW()"}
],
"indexes": [
{"columns": ["sku"], "unique": true},
{"columns": ["name"]}
]
}
zerodb_postgres_backupTrigger a PostgreSQL backup job with configurable options.
Parameters:
backup_type (string, optional) - "full" or "incremental", default: "full"retention_days (number, optional) - Backup retention in days, default: 7compression (boolean, optional) - Compress backup, default: trueinclude_schema (boolean, optional) - Include schema definition, default: trueinclude_data (boolean, optional) - Include table data, default: trueReturns:
{
"backup_id": "backup_xyz789",
"backup_type": "full",
"status": "initiated",
"estimated_size_mb": 250.0,
"retention_days": 7,
"created_at": "2025-12-07T18:00:00Z"
}
Example:
{
"backup_type": "full",
"retention_days": 30,
"compression": true
}
zerodb_postgres_restoreRestore PostgreSQL database from a backup.
Parameters:
backup_id (string, required) - Backup ID to restore fromrestore_type (string, optional) - "full", "schema_only", or "data_only", default: "full"target_database (string, optional) - Restore to different database nameconfirm_overwrite (boolean, required) - Must be true to confirm overwrite of existing dataReturns:
{
"restore_id": "restore_abc123",
"backup_id": "backup_xyz789",
"status": "in_progress",
"estimated_time_minutes": 5,
"started_at": "2025-12-07T18:05:00Z"
}
Security:
confirm_overwrite: true to prevent accidental data lossExample:
{
"backup_id": "backup_xyz789",
"restore_type": "full",
"confirm_overwrite": true
}
zerodb_postgres_statsGet comprehensive PostgreSQL database statistics including performance metrics.
Parameters:
include_connections (boolean, optional) - Include connection statistics, default: trueinclude_queries (boolean, optional) - Include query performance stats, default: trueinclude_storage (boolean, optional) - Include storage statistics, default: trueinclude_replication (boolean, optional) - Include replication stats, default: falsetime_range (string, optional) - "hour", "day", "week", or "month", default: "day"Returns:
{
"project_id": "proj_123",
"database_size_mb": 150.5,
"table_count": 25,
"active_connections": 5,
"max_connections": 100,
"queries_per_second": 120.5,
"cache_hit_ratio": 0.95,
"avg_query_time_ms": 15.2,
"cpu_usage_percent": 25.0,
"memory_usage_percent": 40.0,
"replication_lag_ms": null
}
Example:
{
"include_connections": true,
"include_queries": true,
"include_storage": true,
"time_range": "day"
}
Entity/relationship graph on top of your ZeroDB memories — create entities, link them, walk the graph, and run hybrid vector+graph search. Requires a core backend version that includes the graph_* MCP operations (AINative-Studio/core#8341); an older backend returns an "operation not recognized" error for these four tools.
zerodb_graph_upsert_entityCreate or update a knowledge graph entity. If an entity with the same canonical_name + entity_type already exists, its aliases are merged and memory_count is incremented instead of creating a duplicate.
Parameters:
canonical_name (string, required) - Entity canonical nameentity_type (string, required) - Entity type, e.g. person, org, tech, conceptaliases (array[string], optional) - Known aliases for the entityproperties (object, optional) - Arbitrary entity propertiesproject_id (string, optional) - When provided, entity_type is checked against that project's ontology; a warning (not a block) is returned if it is not in the allowed listReturns:
{
"id": "ent_abc123",
"canonical_name": "Alice Johnson",
"entity_type": "person",
"aliases": ["Alice"],
"properties": { "role": "engineer" },
"memory_count": 1,
"status": "created"
}
zerodb_graph_create_edgeCreate or strengthen a directed edge (relationship) between two entities that already exist in the graph. Does not create the entities — use zerodb_graph_upsert_entity first.
Parameters:
source_name (string, required) - Source entity canonical name (must already exist)target_name (string, required) - Target entity canonical name (must already exist)predicate (string, required) - Relationship type, e.g. works_at, located_in, depends_onconfidence (number, optional) - Edge confidence 0.0-1.0, default: 0.8properties (object, optional) - Arbitrary edge propertiesExample:
{
"source_name": "Alice Johnson",
"target_name": "Acme Corp",
"predicate": "works_at",
"confidence": 0.9
}
zerodb_graph_traverseMulti-hop traversal of the knowledge graph starting from an entity. Returns nodes, edges, and paths discovered within max_hops.
Parameters:
entity (string, required) - Entity name or ID to start traversal frommax_hops (number, optional) - Maximum traversal depth (1-5), default: 3predicates (array[string], optional) - Only follow edges with these predicate typesmin_confidence (number, optional) - Minimum edge confidence to follow, default: 0.0as_of (string, optional) - ISO timestamp — only return edges valid at this point in timeExample:
{
"entity": "Alice Johnson",
"max_hops": 2
}
zerodb_graph_rag_searchGraphRAG hybrid search — blends vector similarity with knowledge graph proximity. graph_weight=0.0 behaves like pure vector search; graph_weight=1.0 is pure graph proximity ranking; the default 0.3 blends both.
Parameters:
query (string, required) - Search query textlimit (number, optional) - Maximum results to return, default: 10graph_weight (number, optional) - Blend factor: 0=pure vector, 1=pure graph proximity, default: 0.3max_hops (number, optional) - Maximum graph traversal depth for the graph-proximity component, default: 2Example:
{
"query": "pricing strategy",
"limit": 5,
"graph_weight": 0.5
}
zerodb_graph_list_entitiesList knowledge graph entities for the current user, optionally filtered by entity type, paginated by memory_count descending.
Parameters:
entity_type (string, optional) - Filter by entity type, e.g. person, org, tech, conceptlimit (number, optional) - Max results, default: 50offset (number, optional) - Pagination offset, default: 0zerodb_graph_neighborsGet the direct (1-hop) neighbors of an entity, with relationship and entity metadata. Bounded to a single hop — use zerodb_graph_traverse for a deeper walk.
Parameters:
entity_name (string, required) - Entity name to find neighbors of (must already exist)limit (number, optional) - Max neighbors to return, default: 50zerodb_graph_statsGraph analytics for the current user: node count, edge count, density, entity-type and predicate distributions, and top entities by connectivity. No parameters.
zerodb_graph_merge_entitiesMerge duplicate entities into a canonical entity, moving all edges and aliases from the merge targets and deleting the duplicates. Destructive — cannot be undone.
Parameters:
canonical (string, required) - Canonical entity name to keepmerge (array[string], required) - Entity names to merge into the canonical entity and deletezerodb_graph_ontology_getGet the ontology (allowed entity types, predicates per type, constraints) for a project. Returns a not-found error if no ontology is defined yet.
Parameters:
project_id (string, required) - Project UUIDzerodb_graph_ontology_upsertCreate or update a project's ontology. Version is auto-incremented on update.
Parameters:
project_id (string, required) - Project UUIDentity_types (array[string], required) - Allowed entity types for this projectpredicates (object, optional) - Allowed predicates per entity type, e.g. {"customer": {"places": "order"}}constraints (object, optional) - Optional additional constraintszerodb_graph_ontology_inferInfer a candidate ontology from existing graph data by analyzing entity-type and predicate frequency. When project_id is given, also returns a diff against that project's current ontology.
Parameters:
min_entity_count (number, optional) - Minimum entity-type occurrences to suggest it, default: 3min_predicate_count (number, optional) - Minimum predicate occurrences to suggest it, default: 2project_id (string, optional) - Project UUID to diff againstzerodb_graph_ontology_suggestionsHuman-readable, actionable suggestions for improving a project's ontology (reclassify generic-typed entities, missing predicates, undeclared entity types).
Parameters:
project_id (string, optional) - Project UUID to scope suggestions tozerodb_graph_contradictions_listList contradictions: edges superseded because a newer edge contradicted an existing relationship on the same (source, predicate) pair.
Parameters:
limit (number, optional) - Max contradictions to return, default: 50zerodb_graph_contradictions_resolveResolve a contradiction on a superseded edge found via zerodb_graph_contradictions_list.
Parameters:
edge_id (string, required) - UUID of the superseded (old) edge to resolveaction (string, required) - One of accept_new (no-op, keeps current state), keep_both (restores the old edge), reject_new (deletes the new edge and restores the old one)zerodb_graph_centralityEntities ranked by degree centrality (total/in/out degree, hub score, critical-node flag). Requires the graph.compute_centrality background task to have run at least once — returns an empty list otherwise.
Parameters:
entity_type (string, optional) - Filter by entity typelimit (number, optional) - Max entities to return, default: 50critical_only (boolean, optional) - Only return entities flagged as critical infrastructure nodes, default: falsezerodb_graph_exportExport the knowledge graph as JSON (nodes + edges, D3/Cytoscape-compatible). For GEXF (Gephi), use the underlying HTTP export route directly.
Parameters:
entity_type (string, optional) - Filter by entity typelimit (number, optional) - Max entities to export, default: 5000min_confidence (number, optional) - Minimum edge confidence to include, default: 0.0All configuration is done through environment variables. Set these in your MCP server configuration.
* Either ZERODB_API_KEY or both ZERODB_USERNAME and ZERODB_PASSWORD must be provided.
The MCP server supports two authentication methods:
Set ZERODB_API_KEY in your environment. The API key is used as a static Bearer token for all requests -- no login flow, no token renewal needed.
Set ZERODB_USERNAME and ZERODB_PASSWORD. The server authenticates on startup, stores the JWT in memory, and automatically renews it every 25 minutes (tokens expire after 30 minutes). Use zerodb_renew_token to manually renew if needed.
Backward compatibility: If you have
ZERODB_USERNAME/ZERODB_PASSWORDconfigured, it will continue to work. We recommend migrating to API key auth for simplicity and security.
// 1. Create a project for your knowledge base
const project = await zerodb_create_project({
project_name: "Product Documentation KB",
description: "Searchable product documentation"
});
// 2. Upload documentation files
const file = await zerodb_upload_file({
file_name: "user_guide.pdf",
file_data: "base64data...",
content_type: "application/pdf"
});
// 3. Store vectors for semantic search
// (Assume you've generated embeddings from the documentation)
const vector = await zerodb_store_vector({
vector_embedding: [...], // 1536-dimensional vector
document: "How to reset your password: Navigate to Settings...",
metadata: {
source: "user_guide.pdf",
page: 15
}
});
// 4. Search the knowledge base
const results = await zerodb_search_vectors({
query_vector: [...], // User query embedding
limit: 5,
threshold: 0.75
});
// 1. Store conversation in memory
await zerodb_store_memory({
content: "User wants to book a flight to Paris",
role: "user",
session_id: "session-123"
});
await zerodb_store_memory({
content: "I'll help you book a flight to Paris. What dates?",
role: "assistant",
session_id: "session-123"
});
// 2. Later in the conversation, get context
const context = await zerodb_get_context({
session_id: "session-123",
max_tokens: 4096
});
// Context includes all previous messages, token-optimized
// 1. Start RLHF collection for session
await zerodb_rlhf_start({
session_id: "session-456",
collection_config: {
collect_all_interactions: true
}
});
// 2. Collect interactions during conversation
await zerodb_rlhf_interaction({
session_id: "session-456",
user_input: "What's the weather like?",
agent_response: "I don't have access to real-time weather data",
feedback_score: 3,
metadata: {
model: "claude-3-sonnet",
response_time_ms: 800
}
});
// 3. Collect error reports
await zerodb_rlhf_error({
session_id: "session-456",
error_type: "capability_limitation",
error_message: "Agent cannot access real-time data",
user_impact: "medium"
});
// 4. Get RLHF summary
const summary = await zerodb_rlhf_summary({
group_by: "session",
start_date: "2025-10-14T00:00:00Z"
});
// 1. Store vectors with quantum compression
const compressed = await zerodb_quantum_compress({
vector_embedding: [...], // Original 1536 dimensions
compression_ratio: 0.5,
algorithm: "qaoa"
});
// Store compressed version
await zerodb_store_vector({
vector_embedding: compressed.compressed_vector,
document: "Product description...",
metadata: {
compressed: true,
original_dimensions: 1536
}
});
// 2. Perform quantum hybrid search
const results = await zerodb_quantum_hybrid_search({
query_vector: [...],
quantum_weight: 0.7, // Higher weight for quantum similarity
limit: 10
});
// Results include both classical and quantum similarity scores
// 1. Create a table for user profiles
const table = await zerodb_create_table({
table_name: "user_profiles",
schema: {
user_id: "uuid",
name: "string",
email: "string",
preferences: "json",
created_at: "timestamp"
}
});
// 2. Insert user data
await zerodb_insert_rows({
table_id: table.table_id,
rows: [
{
user_id: "user-1",
name: "Alice Smith",
email: "[email protected]",
preferences: { theme: "dark", language: "en" }
}
]
});
// 3. Query users
const users = await zerodb_query_rows({
table_id: table.table_id,
filters: {
email: { $contains: "@example.com" }
}
});
// 4. Update preferences
await zerodb_update_rows({
table_id: table.table_id,
filters: { user_id: "user-1" },
updates: {
preferences: { theme: "light", language: "en" }
}
});
// All operations return structured responses with error handling
try {
const result = await zerodb_store_vector({
vector_embedding: [...],
document: "Sample text"
});
if (result.isError) {
console.error("Operation failed:", result.content[0].text);
// Handle error appropriately
} else {
console.log("Success:", result.content[0].text);
}
} catch (error) {
// Handle unexpected errors
console.error("Unexpected error:", error.message);
}
Password auth (
ZERODB_USERNAME/ZERODB_PASSWORD) is deprecated and will be removed in v3.0. The server will print a deprecation warning on startup if password auth is detected.
zdb_)Old config (deprecated):
{
"mcpServers": {
"zerodb": {
"command": "npx",
"args": ["ainative-zerodb-mcp-server"],
"env": {
"ZERODB_API_URL": "https://api.ainative.studio",
"ZERODB_PROJECT_ID": "your-project-id",
"ZERODB_USERNAME": "[email protected]",
"ZERODB_PASSWORD": "YourPassword123!"
}
}
}
}
New config (recommended):
{
"mcpServers": {
"zerodb": {
"command": "npx",
"args": ["ainative-zerodb-mcp-server"],
"env": {
"ZERODB_API_URL": "https://api.ainative.studio",
"ZERODB_PROJECT_ID": "your-project-id",
"ZERODB_API_KEY": "zdb_your-api-key-here"
}
}
}
}
API Endpoint Consolidation
Impact: No code changes needed if using MCP tools
Tool Naming Convention
zerodb_ prefixzerodb_Migration:
// Old (v1.x)
store_memory(...) → zerodb_store_memory(...)
search_memory(...) → zerodb_search_memory(...)
// New (v2.0)
zerodb_store_memory(...) // Consistent prefix
Parameter Changes
memory_metadata → metadatavector_metadata → metadataMigration:
// Old (v1.x)
{
content: "...",
memory_metadata: { key: "value" }
}
// New (v2.0)
{
content: "...",
metadata: { key: "value" }
}
New Required Environment Variables
ZERODB_PROJECT_ID is now required (was optional in v1.x)Migration: Add to your config:
{
"env": {
"ZERODB_PROJECT_ID": "your-project-id"
}
}
Update Package
npm update ainative-zerodb-mcp-server
# or
npm install -g [email protected]
Update Configuration
ZERODB_PROJECT_ID to environment variableszerodb_ prefixTest Existing Functionality
Gradually Adopt New Features
Error: Authentication failed: Invalid credentials
Solutions:
ZERODB_API_KEY is correct and not expiredZERODB_USERNAME and ZERODB_PASSWORD are correctzerodb_renew_token (username/password auth only)Error: Project not found: [project-id]
Solutions:
ZERODB_PROJECT_ID is correctzerodb_list_projectszerodb_create_projectError: vector must have exactly 1536 dimensions, got 768
Solutions:
text-embedding-3-small (1536 dimensions)text-embedding-ada-002 (1536 dimensions)text-embedding-3-large (3072 dimensions)Error: Token expired or invalid
Solutions:
zerodb_renew_tokenError: Rate limit exceeded
Solutions:
Enable verbose logging by checking stderr output:
# The MCP server logs to stderr
# In Claude Desktop, check: ~/Library/Logs/Claude/mcp*.log
Log messages include:
We welcome contributions! Please see our Contributing Guide for details.
# Clone repository
git clone https://github.com/AINative-Studio/ainative-zerodb-mcp-server.git
cd ainative-zerodb-mcp-server
# Install dependencies
npm install
# Run tests
npm test
# Lint code
npm run lint
# Run security audit
npm run security:audit
# Run tests with coverage
npm test
# Watch mode for development
npm run test:watch
# CI mode
npm run test:ci
MIT License - see LICENSE file for details.
Breaking Changes:
ZERODB_PROJECT_ID environment variablezerodb_ prefix for all tool namesNew Features:
Improvements:
Built with ❤️ by AINative Studio
Powered by ZeroDB - Enterprise Vector Search for AI
AINative ZeroDB MCP Server - 93 operations for vector search, TurboQuant vector compression (PolarQuant + QJL), NoSQL, dedicated PostgreSQL management, files, events, RLHF, knowledge graph (entities,
{ "mcpServers": { "ainative-zerodb-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Übersicht
AINative ZeroDB MCP Server - 93 operations for vector search, TurboQuant vector compression (PolarQuant + QJL), NoSQL, dedicated PostgreSQL management, files, events, RLHF, knowledge graph (entities, edges, traversal, GraphRAG, ontology CRUD, contradictio
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Ainative Zerodb läuft lokal über stdio.
Zuletzt geprüft: 2026-11-15. AINative ZeroDB MCP Server - 93 operations for vector search, TurboQuant vector compression (PolarQuant + QJL), NoSQL, dedicated PostgreSQL management, files, events, RLHF, knowledge graph (entities, edges, traversal, GraphRAG, ontology CRUD, contradictio