{"report":"{\"v\":1,\"package\":\"ainative-zerodb-mcp-server\",\"version\":\"2.5.2\",\"ranAt\":\"2026-11-16T11:48:09.203Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-HbMsDSEP0yg+Q49Oj2TTgGz2Rawrrc7ucAsBSYn3ax0XRF+2jmkkxmqNbsVu4+0tJL4sRxjFdSsPGo1okgdHpA==\",\"deps\":155,\"scripts\":[\"ainative-design-system-mcp-server\"],\"bins\":[\"ainative-zerodb-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18.0.0\",\"repository\":\"https://github.com/AINative-Studio/ainative-zerodb-mcp-server.git\",\"bin\":\"ainative-zerodb-mcp\"},\"start\":{\"ok\":true,\"ms\":636,\"serverName\":\"zerodb-mcp\",\"serverVersion\":\"2.4.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"\\n  No credentials found — provisioning a free ZeroDB instance...\\n  ✅ Auto-provisioned! Project: d51afac0-56a3-4645-a452-9a5c32adb89d\\n  API Key: tmp_ZKXWaJFgW5at...\\n  Expires: 2026-11-19T11:48:15.421802+00:00\\n  Claim at: https://www.ainative.studio/claim?token=K4SW52OnQk0UpkNFt8u62_fLEgAcTPJC&project=d51afac0-56a3-4645-a452-9a5c32adb89d\\n\\nZeroDB MCP Server v2.3.5 running on stdio\\nAPI URL: https://api.ainative.studio\\nProject ID: d51afac0-56a3-4645-a452-9a5c32adb89d\\nOperations: 77 (includes 7 dedicated PostgreSQL management tools, all annotated with MCP hints)\\n✅ Auth: API key (recommended)\\nToken expires: Unknown\\nExecuting operation: list_vectors\\nExecuting operation: vector_stats\\nExecuting operation: list_tables\\nExecuting operation: list_files\\nExecuting operation: list_events\\n\"},\"tools\":[{\"name\":\"zerodb_generate_embeddings\",\"description\":\"Generate embeddings using specified model (384/768/1024 dimensions). Supports BAAI/bge-small-en-v1.5 (384-dim, default), BAAI/bge-base-en-v1.5 (768-dim), BAAI/bge-large-en-v1.5 (1024-dim). Use when you need raw embedding vectors without storing them. Does not persist data — for embed + store in one step, use zerodb_embed_and_store instead.\",\"params\":[\"texts\",\"model\"]},{\"name\":\"zerodb_embed_and_store\",\"description\":\"Generate embeddings and store in ZeroDB in one step. Auto-detects dimension based on model and routes to correct storage. Use when you want to embed text and persist the vectors in a single call. Combines zerodb_generate_embeddings + zerodb_upsert_vector.\",\"params\":[\"texts\",\"model\",\"namespace\",\"metadata\"]},{\"name\":\"zerodb_semantic_search\",\"description\":\"Semantic search using text query (auto-embeds query text). Searches vectors in the same dimension as the model used. Use when searching vectors using a text query (auto-embeds the text). Unlike zerodb_search_vectors which requires a raw vector, this accepts plain text. Unlike zerodb_search_memory which searches agent conversation memory, this searches the general vector store.\",\"params\":[\"query_text\",\"model\",\"namespace\",\"limit\",\"threshold\",\"filter_metadata\"]},{\"name\":\"zerodb_store_memory\",\"description\":\"Store agent memory in ZeroDB for persistent context. Use when the agent needs to persist conversation turns, decisions, or observations for later recall. Stores with role, session, and agent metadata for filtered retrieval.\",\"params\":[\"content\",\"role\",\"session_id\",\"agent_id\",\"metadata\"]},{\"name\":\"zerodb_search_memory\",\"description\":\"Search agent memory using semantic similarity. Use when searching agent conversation memory by natural language. Unlike zerodb_search_vectors which requires a raw vector, and zerodb_semantic_search which searches the general vector store, this searches agent-specific memory entries filtered by session/agent/role.\",\"params\":[\"query\",\"session_id\",\"agent_id\",\"role\",\"limit\"]},{\"name\":\"zerodb_get_context\",\"description\":\"Get agent context window for current session. Use when the agent needs to retrieve its recent conversation context within token limits. Returns the most recent memories for a session, bounded by max_tokens.\",\"params\":[\"session_id\",\"agent_id\",\"max_tokens\"]},{\"name\":\"zerodb_upsert_vector\",\"description\":\"Store or update a vector embedding with metadata. Supports 384, 768, 1024, or 1536 dimensions. Dimension is auto-detected and validated. Use when you have a pre-computed embedding vector to store or update. For embedding text and storing in one step, use zerodb_embed_and_store instead.\",\"params\":[\"vector_embedding\",\"document\",\"metadata\",\"namespace\",\"vector_id\"]},{\"name\":\"zerodb_batch_upsert_vectors\",\"description\":\"Batch upsert multiple vectors for efficiency. Use when storing many vectors at once to reduce API round-trips. Accepts an array of vector objects and processes them in a single request.\",\"params\":[\"vectors\",\"namespace\"]},{\"name\":\"zerodb_search_vectors\",\"description\":\"Search vectors using semantic similarity. Supports 384, 768, 1024, or 1536 dimension query vectors. Auto-detects dimension. Use when searching raw vector embeddings by similarity with a query vector. Unlike zerodb_semantic_search which accepts text (auto-embeds), this requires a pre-computed vector. Unlike zerodb_search_memory which searches agent memory, this searches the general vector store.\",\"params\":[\"query_vector\",\"namespace\",\"limit\",\"threshold\",\"filter_metadata\"]},{\"name\":\"zerodb_delete_vector\",\"description\":\"Delete a specific vector by ID. Use when removing a single vector embedding from the store. WARNING: This operation is irreversible.\",\"params\":[\"vector_id\",\"namespace\"]},{\"name\":\"zerodb_get_vector\",\"description\":\"Retrieve a specific vector by ID. Use when you need to inspect a particular vector's metadata or embedding values. Optionally includes the full embedding array.\",\"params\":[\"vector_id\",\"namespace\",\"include_embedding\"]},{\"name\":\"zerodb_list_vectors\",\"description\":\"List vectors in a project/namespace with pagination. Use when the agent needs to browse or enumerate stored vectors, or answer \\\"what vectors exist?\\\". Supports filtering by namespace and metadata.\",\"params\":[\"namespace\",\"limit\",\"offset\",\"filter_metadata\"]},{\"name\":\"zerodb_vector_stats\",\"description\":\"Get vector statistics for a project. Use when checking how many vectors are stored, their dimensions, and namespace distribution. Returns counts, dimension breakdowns, and optionally detailed statistics.\",\"params\":[\"namespace\",\"detailed\"]},{\"name\":\"zerodb_create_vector_index\",\"description\":\"Create optimized index for vector search. Use when search performance needs improvement on large vector collections. Supports IVF, HNSW, and flat index types with configurable distance metrics.\",\"params\":[\"namespace\",\"index_type\",\"distance_metric\",\"index_params\"]},{\"name\":\"zerodb_optimize_vectors\",\"description\":\"Optimize vector storage for better performance. Use when vector search is slow or storage needs compaction. Supports compress, reindex, and deduplicate operations. Use dry_run to preview changes first.\",\"params\":[\"namespace\",\"optimize_type\",\"dry_run\"]},{\"name\":\"zerodb_export_vectors\",\"description\":\"Export vectors to various formats (JSON, CSV, Parquet). Use when you need to download or migrate vector data out of ZeroDB. Supports filtering by namespace and metadata.\",\"params\":[\"namespace\",\"format\",\"filter_metadata\",\"include_embeddings\"]},{\"name\":\"zerodb_quantum_compress\",\"description\":\"Compress vector using TurboQuant (PolarQuant + QJL) algorithm from Google Research (ICLR 2026). Achieves ~3.5x compression with 0.9999+ cosine similarity preservation. Data-oblivious — no calibration needed. Returns base64-encoded compressed data.\",\"params\":[\"vector_embedding\",\"compression_ratio\",\"preserve_similarity\",\"precision\",\"method\"]},{\"name\":\"zerodb_quantum_decompress\",\"description\":\"Decompress a TurboQuant-compressed vector back to original dimensions. Reconstructs the full vector from the base64-encoded compressed data returned by zerodb_quantum_compress.\",\"params\":[\"compressed_vector\",\"original_dimensions\",\"compression_metadata\"]},{\"name\":\"zerodb_quantum_hybrid_search\",\"description\":\"Hybrid similarity search combining cosine similarity with metadata boosting. Returns ranked results with configurable weighting between similarity score and metadata relevance.\",\"params\":[\"query_vector\",\"namespace\",\"quantum_weight\",\"classical_weight\",\"limit\"]},{\"name\":\"zerodb_quantum_optimize\",\"description\":\"Analyze vector space characteristics for optimal TurboQuant compression settings. Reports sparsity, magnitude distribution, and recommended precision level.\",\"params\":[\"namespace\",\"optimization_level\",\"target_backend\"]},{\"name\":\"zerodb_quantum_feature_map\",\"description\":\"Transform vector into feature space for enhanced similarity computation. Applies configurable feature mapping for dimensionality transformation.\",\"params\":[\"vector_embedding\",\"feature_map_type\",\"num_qubits\",\"reps\"]},{\"name\":\"zerodb_quantum_kernel\",\"description\":\"Calculate kernel similarity between two vectors. Supports fidelity (normalized dot product squared) and swap_test kernel types for measuring vector similarity.\",\"params\":[\"vector_a\",\"vector_b\",\"kernel_type\",\"shots\"]},{\"name\":\"zerodb_create_table\",\"description\":\"Create a new NoSQL table with schema. Use when you need to set up a new data structure for storing structured records. Define fields and indexes for the table schema.\",\"params\":[\"table_name\",\"schema\",\"description\"]},{\"name\":\"zerodb_list_tables\",\"description\":\"List all NoSQL tables in the project with their schemas. Use when the agent needs to discover available data structures or answer \\\"what tables exist?\\\". Returns table names, row counts, and field definitions.\",\"params\":[\"limit\",\"offset\"]},{\"name\":\"zerodb_get_table\",\"description\":\"Get table details and schema. Use when you need to inspect a specific table's structure, field types, indexes, and optionally row count statistics.\",\"params\":[\"table_id\",\"include_stats\"]},{\"name\":\"zerodb_delete_table\",\"description\":\"Delete a table and all its data. Use when a table is no longer needed and should be permanently removed. Requires confirm flag. WARNING: This operation is irreversible.\",\"params\":[\"table_id\",\"confirm\"]},{\"name\":\"zerodb_insert_rows\",\"description\":\"Insert rows into a table. Use when adding new records to a NoSQL table. Accepts an array of row objects and optionally returns inserted IDs.\",\"params\":[\"table_id\",\"rows\",\"return_ids\"]},{\"name\":\"zerodb_query_rows\",\"description\":\"Query rows from a table with filters. Use when reading data from a NoSQL table. Supports MongoDB-style filters, sorting, pagination, and field projection.\",\"params\":[\"table_id\",\"filter\",\"sort\",\"limit\",\"offset\",\"projection\"]},{\"name\":\"zerodb_update_rows\",\"description\":\"Update rows in a table. Use when modifying existing records in a NoSQL table. Supports MongoDB-style update operators ($set, $inc, etc.) and optional upsert behavior.\",\"params\":[\"table_id\",\"filter\",\"update\",\"upsert\"]},{\"name\":\"zerodb_delete_rows\",\"description\":\"Delete rows from a table matching a filter. Use when removing specific records from a NoSQL table. Supports MongoDB-style filters. WARNING: This operation is irreversible.\",\"params\":[\"table_id\",\"filter\",\"limit\"]},{\"name\":\"zerodb_upload_file\",\"description\":\"Upload file to ZeroDB storage. Use when you need to store a file (base64-encoded) in the project's S3-compatible object storage. Supports metadata and virtual folder organization.\",\"params\":[\"file_name\",\"file_content\",\"content_type\",\"metadata\",\"folder\"]},{\"name\":\"zerodb_download_file\",\"description\":\"Download file from ZeroDB storage. Use when you need to retrieve a previously uploaded file by its ID. Returns base64-encoded content by default.\",\"params\":[\"file_id\",\"return_base64\"]},{\"name\":\"zerodb_list_files\",\"description\":\"List files in project storage. Use when the agent needs to discover available files or answer \\\"what files are stored?\\\". Supports filtering by folder and MIME type with pagination.\",\"params\":[\"folder\",\"content_type\",\"limit\",\"offset\"]},{\"name\":\"zerodb_delete_file\",\"description\":\"Delete file from storage. Use when a file is no longer needed and should be permanently removed. WARNING: This operation is irreversible.\",\"params\":[\"file_id\"]},{\"name\":\"zerodb_get_file_metadata\",\"description\":\"Get file metadata without downloading content. Use when you need to check a file's size, type, upload date, or custom metadata without fetching the actual file data.\",\"params\":[\"file_id\"]},{\"name\":\"zerodb_generate_presigned_url\",\"description\":\"Generate presigned URL for file access. Use when you need a temporary URL to share file access with external systems. Supports download and upload operations with configurable expiration.\",\"params\":[\"file_id\",\"expiration_seconds\",\"operation\"]},{\"name\":\"zerodb_create_event\",\"description\":\"Create an event in the event stream. Use when you need to publish an event for tracking, auditing, or triggering downstream workflows. Supports event types, payloads, and correlation IDs.\",\"params\":[\"event_type\",\"event_data\",\"source\",\"correlation_id\"]},{\"name\":\"zerodb_list_events\",\"description\":\"List events with filtering. Use when you need to browse or query the event stream by type, source, or time range. Supports pagination for large result sets.\",\"params\":[\"event_type\",\"source\",\"start_time\",\"end_time\",\"limit\",\"offset\"]},{\"name\":\"zerodb_get_event\",\"description\":\"Get event details by ID. Use when you need to inspect a specific event's full payload, timestamps, and metadata.\",\"params\":[\"event_id\"]},{\"name\":\"zerodb_subscribe_events\",\"description\":\"Subscribe to event stream (returns subscription ID). Use when you need to set up real-time event notifications. Supports filtering by event type and optional webhook delivery.\",\"params\":[\"event_types\",\"filter\",\"webhook_url\"]},{\"name\":\"zerodb_event_stats\",\"description\":\"Get event stream statistics. Use when you need to understand event volume, frequency, and distribution over time. Supports filtering by event type and time range.\",\"params\":[\"event_type\",\"time_range\"]},{\"name\":\"zerodb_create_project\",\"description\":\"Create a new ZeroDB project. Use when you need to set up a new isolated workspace for storing vectors, tables, files, and events. Projects are the top-level organizational unit.\",\"params\":[\"project_name\",\"description\",\"settings\"]},{\"name\":\"zerodb_get_project\",\"description\":\"Get project details. Use when you need to inspect a project's configuration, settings, and enabled features. Uses the configured project ID by default.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_list_projects\",\"description\":\"List all accessible projects. Use when the agent needs to discover available projects or answer \\\"what projects do I have access to?\\\". Returns project names, IDs, and basic info.\",\"params\":[\"limit\",\"offset\"]},{\"name\":\"zerodb_update_project\",\"description\":\"Update project settings. Use when you need to modify a project's name, description, or configuration settings.\",\"params\":[\"project_id\",\"project_name\",\"description\",\"settings\"]},{\"name\":\"zerodb_delete_project\",\"description\":\"Delete a project and all its data. Use when a project is no longer needed. Removes all vectors, tables, files, and events within the project. Requires confirm flag. WARNING: This operation is irreversible.\",\"params\":[\"project_id\",\"confirm\"]},{\"name\":\"zerodb_get_project_stats\",\"description\":\"Get project usage statistics. Use when you need to check storage consumption, vector counts, API call volumes, and other usage metrics for a project.\",\"params\":[\"project_id\",\"include_details\"]},{\"name\":\"zerodb_enable_database\",\"description\":\"Enable database features for a project. Use when you need to activate specific capabilities (vectors, compression, nosql, files, events) on a project that does not yet have them enabled.\",\"params\":[\"project_id\",\"features\"]},{\"name\":\"zerodb_rlhf_interaction\",\"description\":\"Collect user interaction for RLHF training. Use when recording a prompt-response pair with optional feedback score for reinforcement learning. Each call creates a new training data point.\",\"params\":[\"prompt\",\"response\",\"feedback\",\"context\",\"agent_id\"]},{\"name\":\"zerodb_rlhf_agent_feedback\",\"description\":\"Collect agent-level feedback. Use when recording user satisfaction signals (thumbs up/down, ratings) for a specific agent. Useful for tracking agent quality over time.\",\"params\":[\"agent_id\",\"feedback_type\",\"rating\",\"comment\",\"context\"]},{\"name\":\"zerodb_rlhf_workflow\",\"description\":\"Collect workflow-level feedback. Use when recording the outcome of a multi-step workflow including success status, duration, and steps completed.\",\"params\":[\"workflow_id\",\"success\",\"duration_ms\",\"steps_completed\",\"feedback\"]},{\"name\":\"zerodb_rlhf_error\",\"description\":\"Collect error report for RLHF improvement. Use when recording errors encountered during agent operation to improve future behavior. Include sanitized stack traces and severity levels.\",\"params\":[\"error_type\",\"error_message\",\"stack_trace\",\"context\",\"severity\"]},{\"name\":\"zerodb_rlhf_status\",\"description\":\"Get RLHF collection status. Use when you need to check whether RLHF data collection is active and how many interactions have been recorded for a session.\",\"params\":[\"session_id\"]},{\"name\":\"zerodb_rlhf_summary\",\"description\":\"Get RLHF data summary and statistics. Use when you need an overview of collected RLHF data including interaction counts, average feedback scores, and trends over time.\",\"params\":[\"time_range\",\"agent_id\"]},{\"name\":\"zerodb_rlhf_start\",\"description\":\"Start RLHF data collection for session. Use when initiating RLHF tracking at the beginning of an agent session. Safe to call multiple times — idempotent for the same session.\",\"params\":[\"session_id\",\"config\"]},{\"name\":\"zerodb_rlhf_stop\",\"description\":\"Stop RLHF data collection for session. Use when ending RLHF tracking at the end of an agent session. Optionally exports collected data before stopping.\",\"params\":[\"session_id\",\"export_data\"]},{\"name\":\"zerodb_rlhf_session\",\"description\":\"Get RLHF interactions for a session. Use when reviewing all recorded interactions within a specific RLHF session for analysis or export.\",\"params\":[\"session_id\",\"limit\"]},{\"name\":\"zerodb_rlhf_broadcast\",\"description\":\"Broadcast RLHF event to subscribers. Use when sending RLHF-related notifications to specific agents or all subscribers. Supports targeted delivery to specific agent IDs.\",\"params\":[\"event_type\",\"event_data\",\"target_agents\"]},{\"name\":\"zerodb_admin_system_stats\",\"description\":\"Get system-wide statistics (admin only). Use when you need a global view of platform performance and usage metrics. Requires admin privileges.\",\"params\":[\"include_performance\",\"include_usage\"]},{\"name\":\"zerodb_admin_list_projects\",\"description\":\"List all projects system-wide (admin only). Use when you need to see all projects across all users for administrative purposes. Supports filtering by user ID. Requires admin privileges.\",\"params\":[\"limit\",\"offset\",\"filter_user\"]},{\"name\":\"zerodb_admin_user_usage\",\"description\":\"Get user usage statistics (admin only). Use when you need to inspect a specific user's resource consumption and API usage. Requires admin privileges.\",\"params\":[\"user_id\",\"time_range\"]},{\"name\":\"zerodb_admin_health\",\"description\":\"Get system health status (admin only). Use when you need to check the health of all system components (database, storage, search). Requires admin privileges.\",\"params\":[\"include_components\"]},{\"name\":\"zerodb_admin_optimize\",\"description\":\"Run database optimization (admin only). Use when the database needs maintenance such as vacuum, reindex, or analyze operations. Supports dry_run to preview changes. Requires admin privileges.\",\"params\":[\"optimization_type\",\"project_id\",\"dry_run\"]},{\"name\":\"zerodb_postgres_query\",\"description\":\"Execute SQL query on provisioned PostgreSQL instance with security validations. Use when you need to run arbitrary SQL (SELECT, INSERT, UPDATE, DELETE) against the dedicated PostgreSQL database. Supports parameterized queries and read-only mode enforcement.\",\"params\":[\"sql\",\"params\",\"read_only\",\"timeout_seconds\",\"max_rows\"]},{\"name\":\"zerodb_postgres_schema_info\",\"description\":\"Get database schema information (tables, columns, indexes). Use when you need to discover or inspect the PostgreSQL schema structure. Returns table definitions, column types, indexes, and constraints.\",\"params\":[\"table_name\",\"include_indexes\",\"include_constraints\",\"include_stats\"]},{\"name\":\"zerodb_postgres_create_table\",\"description\":\"Create new PostgreSQL table with schema definition. Use when you need to define a new relational table with typed columns, constraints, and indexes. Supports if_not_exists for idempotent creation.\",\"params\":[\"table_name\",\"columns\",\"indexes\",\"if_not_exists\"]},{\"name\":\"zerodb_postgres_backup\",\"description\":\"Trigger PostgreSQL backup job. Use when you need to create a point-in-time backup of the database. Supports full and incremental backups with configurable retention and compression.\",\"params\":[\"backup_type\",\"retention_days\",\"compression\",\"include_schema\",\"include_data\"]},{\"name\":\"zerodb_postgres_restore\",\"description\":\"Restore PostgreSQL database from backup. Use when you need to recover data from a previous backup. Supports full, schema-only, and data-only restore types. WARNING: This operation is irreversible — it overwrites existing data when confirm_overwrite is true.\",\"params\":[\"backup_id\",\"restore_type\",\"target_database\",\"confirm_overwrite\"]},{\"name\":\"zerodb_postgres_stats\",\"description\":\"Get PostgreSQL database statistics (size, connections, query performance). Use when you need to monitor database health, connection pool usage, storage consumption, and query performance metrics.\",\"params\":[\"include_connections\",\"include_queries\",\"include_storage\",\"include_replication\",\"time_range\"]},{\"name\":\"zerodb_lakehouse_query\",\"description\":\"Execute a read-only (SELECT/WITH only) SQL query against the project lakehouse via DuckDB over Parquet files in object storage. Use when you need to analyze or inspect data that has been ingested into the lakehouse. Destructive SQL (INSERT/UPDATE/DELETE/DROP/etc.) is rejected.\",\"params\":[\"project_id\",\"sql\",\"max_rows\"]},{\"name\":\"zerodb_lakehouse_list_tables\",\"description\":\"List the lakehouse tables (sensor-type partitions) available for a project, with file counts, total bytes, and last-modified time. Use when you need to discover what data exists in the lakehouse before querying it.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_lakehouse_catalog_list\",\"description\":\"List all partitions in the public lakehouse data catalog, with file counts and sizes. Use when you need a platform-wide overview of available lakehouse data, independent of any single project. No project_id required.\",\"params\":[]},{\"name\":\"zerodb_lakehouse_catalog_search\",\"description\":\"Search the public lakehouse data catalog by partition name. Use when you need to find which lakehouse partitions match a keyword (e.g. \\\"weather\\\", \\\"ais\\\") before querying them.\",\"params\":[\"q\"]},{\"name\":\"zerodb_provision_postgres\",\"description\":\"Provision a dedicated PostgreSQL instance via Railway with dedicated resources. Use when you need to spin up a new managed PostgreSQL database. Choose instance size based on workload requirements and budget.\",\"params\":[\"project_id\",\"instance_size\",\"postgres_version\",\"tags\"]},{\"name\":\"zerodb_get_postgres_status\",\"description\":\"Get status and health metrics for dedicated PostgreSQL instance. Use when you need to check if your PostgreSQL instance is running, its uptime, and health indicators.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_get_postgres_connection\",\"description\":\"Get connection credentials for PostgreSQL instance (database_url, host, port, etc.). Use when you need connection details to configure applications or tools. Supports primary, readonly, and admin credential types.\",\"params\":[\"project_id\",\"credential_type\"]},{\"name\":\"zerodb_get_postgres_usage\",\"description\":\"Get usage statistics and billing information for PostgreSQL instance. Use when you need to review compute usage, storage consumption, and cost breakdown for your dedicated instance.\",\"params\":[\"project_id\",\"hours\"]},{\"name\":\"zerodb_get_postgres_logs\",\"description\":\"Get SQL query logs with performance metrics and credit consumption. Use when you need to audit queries, debug slow operations, or review credit usage. Supports filtering by query type.\",\"params\":[\"project_id\",\"limit\",\"query_type\"]},{\"name\":\"zerodb_restart_postgres\",\"description\":\"Restart the dedicated PostgreSQL instance (completes in 30-60 seconds). Use when the instance needs a restart due to configuration changes or performance issues. Does not lose data.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_delete_postgres\",\"description\":\"Delete the PostgreSQL instance and all data (requires confirmation). Use when the instance is no longer needed. Requires confirm=true. WARNING: This operation is irreversible.\",\"params\":[\"project_id\",\"confirm\"]},{\"name\":\"zerodb_graph_upsert_entity\",\"description\":\"Create or update a knowledge graph entity. Use when you need to add a person, organization, technology, or concept to the context graph, or refresh an existing one. If the entity already exists (matched by canonical_name + entity_type), aliases are merged and memory_count is incremented rather than duplicating the entity.\",\"params\":[\"canonical_name\",\"entity_type\",\"aliases\",\"properties\",\"project_id\"]},{\"name\":\"zerodb_graph_create_edge\",\"description\":\"Create or strengthen a directed edge (relationship) between two existing entities in the knowledge graph. Use when you have identified a relationship between two entities you have already created with zerodb_graph_upsert_entity. Both entities must already exist — this does not create them. Unlike zerodb_graph_traverse which reads the graph, this writes to it.\",\"params\":[\"source_name\",\"target_name\",\"predicate\",\"confidence\",\"properties\"]},{\"name\":\"zerodb_graph_traverse\",\"description\":\"Multi-hop traversal of the knowledge graph starting from an entity. Use when you need to discover what is connected to an entity, directly or transitively, up to a bounded depth. Returns nodes, edges, and paths discovered within max_hops. Unlike zerodb_graph_rag_search which ranks results by relevance to a text query, this is a pure structural walk from a known starting entity.\",\"params\":[\"entity\",\"max_hops\",\"predicates\",\"min_confidence\",\"as_of\"]},{\"name\":\"zerodb_graph_rag_search\",\"description\":\"GraphRAG hybrid search — blends vector similarity with knowledge graph proximity. Use when you want search results that are both semantically relevant to a query AND structurally connected in the entity graph, rather than relying on vector similarity alone. graph_weight=0.0 behaves like pure vector search (same as zerodb_semantic_search); graph_weight=1.0 is pure graph proximity ranking; the default 0.3 blends both.\",\"params\":[\"query\",\"limit\",\"graph_weight\",\"max_hops\"]},{\"name\":\"zerodb_graph_list_entities\",\"description\":\"List knowledge graph entities for the current user, optionally filtered by entity type, paginated by memory_count descending. Use when you need to browse or audit what entities already exist in the graph rather than looking up one specific entity by name (use zerodb_graph_resolve-style lookup via traverse/neighbors for that).\",\"params\":[\"entity_type\",\"limit\",\"offset\"]},{\"name\":\"zerodb_graph_neighbors\",\"description\":\"Get the direct (1-hop) neighbors of a knowledge graph entity, with relationship and entity metadata. Use when you need everything directly connected to one entity without a deeper multi-hop walk. Unlike zerodb_graph_traverse, this is bounded to a single hop and does not support predicate/confidence filtering.\",\"params\":[\"entity_name\",\"limit\"]},{\"name\":\"zerodb_graph_stats\",\"description\":\"Get knowledge graph analytics for the current user: node count, edge count, graph density, entity-type and predicate distributions, and top entities by connectivity. Use for a high-level health/size check of the graph before deciding whether to traverse, export, or run centrality analysis.\",\"params\":[]},{\"name\":\"zerodb_graph_merge_entities\",\"description\":\"Merge duplicate entities into a single canonical entity, moving all edges and aliases from the merge targets onto the canonical entity and deleting the duplicates. Use when you have discovered that two or more entities in the graph actually refer to the same real-world thing (e.g. \\\"Acme\\\" and \\\"Acme Inc\\\"). This is destructive to the merged (non-canonical) entities — it cannot be undone.\",\"params\":[\"canonical\",\"merge\"]},{\"name\":\"zerodb_graph_ontology_get\",\"description\":\"Get the ontology definition (allowed entity types, predicates per type, and constraints) for a project. Use before creating entities/edges in a project that has an ontology, so you know which entity_type and predicate values are expected. Returns a not-found error if the project has no ontology defined yet — use zerodb_graph_ontology_infer to propose one from existing data.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_graph_ontology_upsert\",\"description\":\"Create or update the ontology for a project: the allowed entity types, allowed predicates per entity type, and optional constraints. Use when you are defining or revising the schema that governs what entities/relationships are expected in a project's graph. Version is auto-incremented on update — this does not retroactively reclassify existing entities (use zerodb_graph_ontology_infer + applying its output for that).\",\"params\":[\"project_id\",\"entity_types\",\"predicates\",\"constraints\"]},{\"name\":\"zerodb_graph_ontology_infer\",\"description\":\"Infer a candidate ontology from the user's existing graph data by analyzing entity-type and predicate frequency patterns. Use when a project has no ontology yet, or you want to propose updates based on what has actually been recorded in the graph so far. When project_id is given, also returns a diff against that project's current ontology (new types/predicates not yet captured). Filters out generic placeholder types (object, thing, unknown).\",\"params\":[\"min_entity_count\",\"min_predicate_count\",\"project_id\"]},{\"name\":\"zerodb_graph_ontology_suggestions\",\"description\":\"Get human-readable, actionable suggestions for improving a project's ontology: entities with generic types that should be reclassified, frequently-used predicates missing from the ontology, and entity types present in the data but not yet declared. Use this when you want a quick, readable punch list rather than the raw inference output from zerodb_graph_ontology_infer.\",\"params\":[\"project_id\"]},{\"name\":\"zerodb_graph_contradictions_list\",\"description\":\"List contradictions in the knowledge graph: edges that were superseded because a newer edge contradicted an existing relationship on the same (source, predicate) pair. Use this to audit where the graph has recorded conflicting facts over time, before deciding how to resolve each one with zerodb_graph_contradictions_resolve.\",\"params\":[\"limit\"]},{\"name\":\"zerodb_graph_contradictions_resolve\",\"description\":\"Resolve a contradiction on a superseded edge, found via zerodb_graph_contradictions_list. action=\\\"accept_new\\\" keeps the current state (default/no-op — the old edge stays superseded); action=\\\"keep_both\\\" restores the old edge so both are active simultaneously; action=\\\"reject_new\\\" deletes the new edge and restores the old one. Use this once you have determined which version of a contradicted fact is correct.\",\"params\":[\"edge_id\",\"action\"]},{\"name\":\"zerodb_graph_centrality\",\"description\":\"Get entities ranked by degree centrality (total/in/out degree, hub score, critical-node flag). Use to find the most structurally important or connected entities in the graph. Requires the graph.compute_centrality background task to have run at least once for this user — returns an empty list otherwise, not an error.\",\"params\":[\"entity_type\",\"limit\",\"critical_only\"]},{\"name\":\"zerodb_graph_export\",\"description\":\"Export the knowledge graph as JSON (nodes + edges, D3/Cytoscape-compatible shape). Use when you need the whole graph (or a filtered slice of it) to hand to a visualization, external analysis tool, or another agent, rather than exploring it interactively via traverse/neighbors. For the GEXF (Gephi) format, use the underlying HTTP export route directly — this tool only returns the JSON shape.\",\"params\":[\"entity_type\",\"limit\",\"min_confidence\"]},{\"name\":\"zerodb_renew_token\",\"description\":\"Manually renew authentication token. Use when the current auth token has expired or is about to expire and you need to force a refresh before the next API call.\",\"params\":[]}],\"toolsHash\":\"b81e17b3cdb0a766d30aac21080c2bb5c128a7d6e2e3353ff94efe3777732a46\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:48:17.705Z\",\"calls\":[{\"tool\":\"zerodb_list_vectors\",\"ok\":true,\"ms\":142,\"bytes\":122},{\"tool\":\"zerodb_vector_stats\",\"ok\":true,\"ms\":137,\"bytes\":95},{\"tool\":\"zerodb_list_tables\",\"ok\":true,\"ms\":228,\"bytes\":39},{\"tool\":\"zerodb_list_files\",\"ok\":true,\"ms\":140,\"bytes\":37},{\"tool\":\"zerodb_list_events\",\"ok\":false,\"ms\":159,\"bytes\":0,\"error\":\"tool reported an error: Operation failed: {\\n  \\\"message\\\": \\\"DatabaseService.list_events() missing 1 required positional argument: 'topic'\\\",\\n  \\\"type\\\": \\\"TypeError\\\"\\n}\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"api.ainative.studio\",\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmRhNjVkZDg5NmQ4ODg5NTk0MWJmZDdjNzhiOGVhNWRlMDgzZjBhMTBjODdjYTgzM2NhODk0ODliOGQyNDRiNWEiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTUxMyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgzMDAwNCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk3MDQsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZWRiMzNiMjQtNmM5Mi00YmRiLTkyMDAtZjc4NzM3N2Y3OWUxIiwibmJmIjoxNzk0ODI5NDA0LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.JmoXZ89mM25SgdzNB6B8yqh2weQZTEoXiiQUb9PcavqcEKIIvtAwF2fFCt5WyJJpaxievmhplzq2vFv6pKBo_8THIu-KHh4-JGUMJrcX0mAxEMHYbkOqfa9dvP1a2L2kbCabuMrsZz8LEYWccdVEzN2bl0AebieVO4DzvpIblANesEpWuCPGizx4c24sWNDbY3mifIn7xztZiADMaOEoQ9glgH3q-UMoc0vjvBV0tWGhkQBleAiUuYSz38IviylMSlnAa1PENG8qZ1lz5VkNC2Z16UQsXixBdwjUALQYCkPJkKwdRiEfiTJ5XKz6Vx8qEZv_uiAElrp74ocAQTluvA"}