delete_document_by_id
Remove a specific document from a Couchbase database by providing its unique identifier, bucket, scope, and collection details.
Instructions
Delete a document by its ID. Returns True on success, False on failure.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_name | Yes | ||
| scope_name | Yes | ||
| collection_name | Yes | ||
| document_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/tools/kv.py:62-80 (handler)Core implementation of the delete_document_by_id tool. Deletes the document from Couchbase using the provided bucket, scope, collection, and ID. Returns True on success, False otherwise.
def delete_document_by_id( ctx: Context, bucket_name: str, scope_name: str, collection_name: str, document_id: str, ) -> bool: """Delete a document by its ID. Returns True on success, False on failure.""" cluster = get_cluster_connection(ctx) bucket = connect_to_bucket(cluster, bucket_name) try: collection = bucket.scope(scope_name).collection(collection_name) collection.remove(document_id) logger.info(f"Successfully deleted document {document_id}") return True except Exception as e: logger.error(f"Error deleting document {document_id}: {e}") return False - src/tools/__init__.py:11-15 (registration)Imports delete_document_by_id from kv.py into the tools package, making it available for registration.
from .kv import ( delete_document_by_id, get_document_by_id, upsert_document_by_id, ) - src/tools/__init__.py:42-64 (registration)Includes delete_document_by_id in ALL_TOOLS list, which is used to batch-register all tools with the MCP server.
ALL_TOOLS = [ get_buckets_in_cluster, get_server_configuration_status, test_cluster_connection, get_scopes_and_collections_in_bucket, get_collections_in_scope, get_scopes_in_bucket, get_document_by_id, upsert_document_by_id, delete_document_by_id, get_schema_for_collection, run_sql_plus_plus_query, get_index_advisor_recommendations, list_indexes, get_cluster_health_and_services, get_queries_not_selective, get_queries_not_using_covering_index, get_queries_using_primary_index, get_queries_with_large_result_count, get_queries_with_largest_response_sizes, get_longest_running_queries, get_most_frequent_queries, ] - src/mcp_server.py:175-178 (registration)Loop that registers every tool in ALL_TOOLS (including delete_document_by_id) to the FastMCP server instance.
# Register all tools for tool in ALL_TOOLS: mcp.add_tool(tool)