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.

Release Notes

  • reference
Version history and release notes for the Couchbase MCP Server.

Version History

The list below covers each release, newest first.

v1.0.1 (August 2026)

A maintenance release with new tools, OAuth and logging enhancements, and bug fixes, organized by category below.

New Features

  • Tools: The following tools were added: lookup_subdocument, mutate_subdocument, create_scope, delete_scope, create_collection, delete_collection, create_index, build_index, drop_index.

Enhancements

  • OAuth Authentication: This release introduces scope labels to let operators remap the couchbase-mcp:read/couchbase-mcp:write scope strings to match the naming convention used by their IdP.

  • Logging: This release introduces enhanced logging capabilities for the Couchbase MCP Server, providing better log retention control, granular size management per log level, and persistent environment logging.

Bug Fixes

Bugs:

  • DA-1945: Fixes a SQL++ parser error that incorrectly rejected the WITHIN keyword.

  • DA-1997: Resolves underlying issues with the Lark parser.

  • DA-2002: Addresses security vulnerability findings reported for the MCP Server.

Other Issues:

  • Fixed a potential SQL++ identifier injection vulnerability in get_schema_for_collection.

  • Addressed an issue where disabled_tools fails silently instead of blocking.

  • Fixed non-portability of the Capella root CA path.

  • Prevent silent fallback to password authentication when client-certificate configuration is incomplete.

  • Ensures KV write tools return failure reasons rather than just a boolean.

  • Correct inconsistent operator matching during EXPLAIN evaluation.

  • Enable previously inactive Bandit security rules.

Deprecations

  • CB_MCP_LOG_MAX_BYTES is deprecated. While the functionality continues to be supported, it’s recommended to use CB_MCP_LOG_ROTATION_MAX_SIZE_MB.

Removals

  • None in this release.

v1.0.0 (June 30, 2026)

The first 1.0 release, organized by category below.

New Features

  • OAuth Authentication: Secure the Streamable HTTP endpoint with OAuth 2.1 JWT token verification and scope-based authorization (couchbase-mcp:read / couchbase-mcp:write), with optional Protected Resource Metadata (PRM) for Dynamic Client Registration. See OAuth.

  • Logging: Configurable structured logging with log levels (CB_MCP_LOG_LEVEL), multiple output sinks (CB_MCP_LOG_SINKS — console, file, or both), and file output (CB_MCP_LOG_FILE). See Logging.

Enhancements

  • None in this release.

Bug Fixes

  • None in this release.

Deprecations

  • None in this release.

Removals

  • Removed CB_MCP_READ_ONLY_QUERY_MODE: The previously deprecated read-only query mode has been removed. Use CB_MCP_READ_ONLY_MODE instead, which blocks all write operations (KV and SQL++). See Read-Only Mode.

  • Removed SSE transport: The previously deprecated Server-Sent Events (SSE) transport has been removed. Use the Streamable HTTP transport (CB_MCP_TRANSPORT=http) instead.

v0.8.0 (May 27, 2026)

  • Python 3.14 Support: The Couchbase MCP Server is now compatible with Python 3.14, allowing users to take advantage of the latest features and improvements in the Python ecosystem.

  • List Indexes Tool: List indexes tool will be powered by SQL++ for Couchbase Server versions 8.0 and above. Users can set return_raw_index_stats=true to return the unprocessed index information.

  • Migrate to FastMCP SDK: The server has been updated to use the native FastMCP SDK instead of the native MCP SDK.

  • Docker Base Image Update: The base images for the prebuilt Docker images have been updated to python:3.13-slim-trixie for security and performance improvements.

v0.7.1 (April 9, 2026)

  • Fix for test_cluster_connection Tool: Resolved an issue where the test_cluster_connection tool could cause an exception with the latest Couchbase SDK (4.6.0). The tool now accurately reflects the connection status in its response.

  • Update Development Dependencies: Updated development dependencies for pytest and pytest-asyncio to latest versions.

v0.7.0 (April 1, 2026)

  • Explain Query Tool: New explain_sql_plus_plus_query tool returns query execution plans for LLM analysis and optimization.

  • Elicitation for Tool Calls: New CB_MCP_CONFIRMATION_REQUIRED_TOOLS setting enables user confirmation prompts for specified tools before execution.

Note: The tool call for test_cluster_connection has a bug with the Couchbase Python SDK 4.6.0. The solution is to downgrade the SDK version in the MCP server to 4.5.0 or upgrade the MCP server to version 0.7.1.

v0.6.1 (February 6, 2026)

  • Read-Only Mode: New CB_MCP_READ_ONLY_MODE setting disables all write operations (KV write tools not loaded, SQL++ write queries blocked). Enabled by default for safety.

  • Tool Disabling: Disable individual tools via CB_MCP_DISABLED_TOOLS (comma-separated list or file path).

  • Expanded CRUD Support: Added insert_document_by_id, replace_document_by_id, and delete_document_by_id tools in addition to existing get and upsert operations.

  • IDE Support: Added support for VS Code and JetBrains IDEs (AI Assistant and Junie plugins).

v0.5.3 (December 10, 2025)

  • Query Performance Analysis: Added 7 tools for identifying slow-running queries, frequently executed queries, primary index usage, non-covering indexes, non-selective queries, large response sizes, and large result counts.

v0.5.2 (November 13, 2025)

  • MCP Registry Support: MCP server added to the MCP Registry for easier discovery and installation by clients.

v0.5.1 (November 3, 2025)

  • List Indexes: New list_indexes tool with optional filtering by bucket, scope, collection, and index name.

  • Index Recommendations: New get_index_advisor_recommendations tool using the Couchbase Index Advisor.

  • Cluster Health: New get_cluster_health_and_services tool for monitoring cluster status and service latency.

Upcoming Features

  • Search-Based Tools: Tools for Full Text Search (FTS).

Checking Your Version

uvx couchbase-mcp-server --version

Installation Channels

Channel Update Method

PyPI

uvx couchbase-mcp-server always runs the latest version

Docker Hub

Pull the latest tag: docker pull couchbase/mcp-server:latest

Source

git pull and uv sync