Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Capella MCP Server

  • concept

Couchbase MCP Server is a self-hosted MCP Server that allows AI agents to connect to and interact with data in Couchbase clusters, whether hosted on Capella or self-managed. It provides tools across categories including Cluster Health, Data Schema, Key-Value, Query, and Performance — with safety controls via read-only mode and fine-grained tool disabling. It supports both STDIO and Streamable HTTP transports.

Couchbase distributes MCP Server as a Python Package Index (PyPI) package and via Docker. A Couchbase AI Data Plane license provides enterprise support for Couchbase MCP Server, and also includes use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.

For the complete MCP Server Documentation, see https://mcp-server.couchbase.com/.
architecture v1.0
Figure 1. MCP Server Architecture

Tools

The server exposes several tools across multiple categories.

See the Tools page for full details.

Category Tools

Cluster Setup & Health

get_server_configuration_status, test_cluster_connection, get_cluster_health_and_services

Data Model & Schema Discovery

get_buckets_in_cluster, get_scopes_in_bucket, get_collections_in_scope, get_scopes_and_collections_in_bucket, get_schema_for_collection

Document KV Operations

get_document_by_id, upsert_document_by_id, insert_document_by_id, replace_document_by_id, delete_document_by_id

Query and Indexing

run_sql_plus_plus_query, explain_sql_plus_plus_query, list_indexes, get_index_advisor_recommendations

Query Performance Analysis

get_longest_running_queries, get_most_frequent_queries, get_queries_not_selective, get_queries_not_using_covering_index, get_queries_using_primary_index, get_queries_with_largest_response_sizes, get_queries_with_large_result_count

Releases

The latest release is available on PyPI and Docker Hub.

See the Release Notes for version history and details.