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 for Operational Insights

  • concept
Couchbase MCP Server lets AI agents connect to a self-managed Couchbase Operational Insights endpoint. It provides tools for database and schema discovery and running analytics queries. Read-only mode keeps it safe to use.

Couchbase MCP Server is a self-hosted MCP Server that allows AI agents to connect to and interact with a Couchbase Operational Insights endpoint.

The Operational Insights MCP server supports only self-managed deployments. Capella-hosted Operational Insights is not supported.

It provides tools for database, scope, and collection discovery, schema inference, and running and managing SQL++ queries — with safety controls via read-only mode. It supports both STDIO and Streamable HTTP transports.

The Couchbase MCP server ships as a Python Package Index (PyPI) package and via Docker. Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane. This license also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.

Get Started

To set up the server, see Prerequisites, then follow the Quick Start.

Tools

The server exposes several tools across multiple categories.

See the Tools page for full details.

Category Tools

Server Status

get_server_configuration_status

Data Model & Schema Discovery

operational_insights_get_databases_in_cluster, operational_insights_get_scopes_in_database, operational_insights_get_collections_in_scope, operational_insights_get_schema_for_collection

Query and Index

operational_insights_list_indexes, operational_insights_explain_query, operational_insights_run_query_sync, operational_insights_run_query_async, operational_insights_get_async_query_results, operational_insights_discard_async_query_results, operational_insights_create_index, operational_insights_cancel_async_query