insert_document_by_id
Insert a new document by ID (fails if document exists)
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 use insert_document_by_id to create or modify resources in Couchbase. Write operations carry medium risk because an autonomous agent could trigger bulk unintended modifications. Rate limits prevent a single agent session from making hundreds of changes in rapid succession. Argument validation ensures the agent passes expected values.
WHY ENFORCE A POLICY ON INSERT_DOCUMENT_BY_ID
Without a policy, an AI agent could call insert_document_by_id repeatedly, creating or modifying resources faster than any human could review. Intercept's rate limiting ensures write operations happen at a controlled pace, and argument validation catches malformed or unexpected inputs before they reach Couchbase.
RECOMMENDED POLICY
Write tools can modify data. A rate limit prevents runaway bulk operations from AI agents.
tools:
insert_document_by_id:
rules:
- action: allow
rate_limit:
max: 30
window: 60See the full Couchbase policy for all 23 tools.
DETAILS
MORE COUCHBASE TOOLS
upsert_document_by_id Write replace_document_by_id Write 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 SIMILAR WRITE TOOLS ON OTHER SERVERS
RELATED READING
FREQUENTLY ASKED QUESTIONS
What does the insert_document_by_id tool do?
Insert a new document by ID (fails if document exists). It is categorised as a Write tool in the Couchbase MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
How do I enforce a policy on insert_document_by_id?
Add a rule in your Intercept YAML policy under the tools section for insert_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 insert_document_by_id?
insert_document_by_id is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Can I rate-limit insert_document_by_id?
Yes. Add a rate_limit block to the insert_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 insert_document_by_id completely?
Set action: deny in the Intercept policy for insert_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 insert_document_by_id?
insert_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.