get_cluster_health_and_services
Get cluster health status and list of all running services
How to use it
get_cluster_health_and_services is exposed by the MCP Server Couchbase MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_cluster_health_and_services tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install MCP Server Couchbase
uvx couchbase-mcp-server --disabled-tools upsert_document_by_id, delete_document_by_idOther tools in MCP Server Couchbase (32)
Trigger the build of all deferred indexes on a collection. Disabled by default when CBMCPREADONLYMODE=true.
Create a new collection in an existing scope (Couchbase Server 7.6+ and Capella). Disabled by default when CBMCPREADONLYMODE=true.
Create a scalar (non-vector) GSI secondary index on a collection. Deferred by default — call buildindex afterward to build it. Disabled by default when CBMCPREADONLYMODE=true.
Create a new scope in a bucket (Couchbase Server 7.6+ and Capella). Disabled by default when CBMCPREADONLYMODE=true.
Delete a collection and all its documents from a scope — permanent. Disabled by default when CBMCPREADONLYMODE=true.
Delete a document by ID from a specified scope and collection. Disabled by default when CBMCPREADONLYMODE=true.
Delete a scope and all its collections from a bucket — permanent. Disabled by default when CBMCPREADONLYMODE=true.
Drop a GSI index (scalar or vector) from a collection. Disabled by default when CBMCPREADONLYMODE=true.
Generate and evaluate an EXPLAIN plan for a SQL++ query. Returns query metadata, extracted plan, and plan evaluation findings.
Get a list of all the buckets in the cluster
Get a list of all the collections in a specified scope and bucket. Note that this tool requires the cluster to have Query service.
Get a document by ID from a specified scope and collection
Get index recommendations from Couchbase Index Advisor for a given SQL++ query to optimize query performance
Get longest running queries by average service time
Get most frequently executed queries
Get queries that are not selective (index scans return many more documents than final result)
Get queries that don't use a covering index
Get queries that use a primary index (potential performance concern)
Get queries with the largest result counts
Get queries with the largest response sizes
Get the structure for a collection
Get a list of all the scopes and collections in the specified bucket
Get a list of all the scopes in the specified bucket
Get the server status and configuration without connecting to the cluster — reports read-only mode, disabled/confirmation-required tools, OAuth settings, and the resolved logging configuration
Insert a new document by ID (fails if document exists). Disabled by default when CBMCPREADONLYMODE=true.
List all indexes in the cluster with their definitions, with optional filtering by bucket, scope, collection and index name. Set returnrawindexstats=true to return the unprocessed index information.
Look up parts of a document (specific fields, existence checks, or array/object counts) by path without fetching the whole document
Modify parts of an existing document (upsert, insert, replace, remove, array ops, counters) by path without rewriting the whole document. Disabled by default when CBMCPREADONLYMODE=true.
Replace an existing document by ID (fails if document doesn't exist). Disabled by default when CBMCPREADONLYMODE=true.
Run a SQL++ query on a specified scope.<br><br>Queries are automatically scoped to the specified bucket and scope, so use collection names directly (e.g., SELECT FROM users instead of SELECT FROM bucket.scope.users).<br><br>CBMCPREADONLYMODE is true by default, which means that all write operations
Check the cluster credentials by connecting to the cluster
Upsert a document by ID to a specified scope and collection. Disabled by default when CBMCPREADONLYMODE=true.