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.

Couchbase MCP Server

  • concept
Couchbase MCP Server lets AI agents connect to Couchbase clusters, on Capella or self-managed. It provides tools for cluster health, schema discovery, key-value operations, and query performance. Read-only mode and fine-grained tool controls keep it safe to use.

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 MCP server is distributed as a Python Package Index (PyPI) package and via Docker. Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.

Architecture

architecture v1.0
Figure 1. Couchbase MCP Server Architecture

For the component breakdown and request flow, see 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.

Support Policy

Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.

Learn More

Watch the video below for a guided tour of the server.

Video Walkthrough