delete_document_by_id
Delete a document by ID from a specified scope and collection
Part of the Couchbase MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.
WHEN AI AGENTS USE THIS TOOL
AI agents may call delete_document_by_id to permanently remove or destroy resources in Couchbase. Without a policy, an autonomous agent could delete critical data in a loop with no way to undo the damage. Intercept blocks destructive tools by default and requires explicit human approval before enabling them.
WHY ENFORCE A POLICY ON DELETE_DOCUMENT_BY_ID
Without a policy, an AI agent could call delete_document_by_id in a loop, permanently destroying resources in Couchbase. There is no undo for destructive operations. Intercept blocks this tool by default and only allows it when a human explicitly approves the action.
RECOMMENDED POLICY
Destructive tools permanently remove data. Block by default. Only enable with explicit approval workflows.
tools:
delete_document_by_id:
rules:
- action: deny
reason: "Blocked by default — enable with approval"See the full Couchbase policy for all 23 tools.
DETAILS
Tool Name
delete_document_by_id
Category
Destructive
MCP Server
Couchbase MCP ServerRisk Level
Critical
MORE COUCHBASE TOOLS
get_server_configuration_status Read test_cluster_connection Read get_cluster_health_and_services Read get_buckets_in_cluster Read get_scopes_in_bucket Read get_collections_in_scope Read get_scopes_and_collections_in_bucket Read get_schema_for_collection Read SIMILAR DESTRUCTIVE TOOLS ON OTHER SERVERS
delete_record Airtable delete_session Appium appium_uninstallApp Appium deleteCompassComponent Atlassian Rovo deleteConfluencePage Atlassian Rovo delete_resource AWS RELATED READING
FREQUENTLY ASKED QUESTIONS
What does the delete_document_by_id tool do?
Delete a document by ID from a specified scope and collection. It is categorised as a Destructive tool in the Couchbase MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.
How do I enforce a policy on delete_document_by_id?
Add a rule in your Intercept YAML policy under the tools section for delete_document_by_id. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the Couchbase MCP server.
What risk level is delete_document_by_id?
delete_document_by_id is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.
Can I rate-limit delete_document_by_id?
Yes. Add a rate_limit block to the delete_document_by_id rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
How do I block delete_document_by_id completely?
Set action: deny in the Intercept policy for delete_document_by_id. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
What MCP server provides delete_document_by_id?
delete_document_by_id is provided by the Couchbase MCP server (couchbase-mcp-server). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.
ENFORCE POLICIES ON COUCHBASE
Open source. One binary. Zero dependencies.