MCP Tool Reference Critical Risk

chroma_delete_documents

Delete specific documents from a collection

Part of the ChromaDB MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.

chroma-mcp Destructive

WHEN AI AGENTS USE THIS TOOL

AI agents may call chroma_delete_documents to permanently remove or destroy resources in ChromaDB. 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 CHROMA_DELETE_DOCUMENTS

Without a policy, an AI agent could call chroma_delete_documents in a loop, permanently destroying resources in ChromaDB. 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.

chromadb.yaml 
tools:
  chroma_delete_documents:
    rules:
      - action: deny
        reason: "Blocked by default — enable with approval"

See the full ChromaDB policy for all 12 tools.

DETAILS

Tool Name

chroma_delete_documents

Category

Destructive

MCP Server

ChromaDB MCP Server

Risk Level

Critical

MORE CHROMADB TOOLS

chroma_delete_collection Destructive
Delete a collection
chroma_list_collections Read
List all collections with pagination support
chroma_peek_collection Read
View a sample of documents in a collection
chroma_get_collection_info Read
Get detailed information about a collection
chroma_get_collection_count Read
Get the number of documents in a collection
chroma_query_documents Read
Query documents using semantic search with advanced filtering
chroma_get_documents Read
Retrieve documents by IDs or filters with pagination
chroma_create_collection Write
Create a new collection with optional HNSW configuration

View all 12 tools →

SIMILAR DESTRUCTIVE TOOLS ON OTHER SERVERS

delete_record Airtable
Remove a record
delete_session Appium
Delete the current session and clean up
appium_uninstallApp Appium
Uninstall an app from the device
deleteCompassComponent Atlassian Rovo
Delete a Compass component
deleteConfluencePage Atlassian Rovo
Delete a Confluence page
delete_resource AWS
Delete AWS resources

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the chroma_delete_documents tool do?

Delete specific documents from a collection. It is categorised as a Destructive tool in the ChromaDB 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 chroma_delete_documents?

Add a rule in your Intercept YAML policy under the tools section for chroma_delete_documents. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the ChromaDB MCP server.

What risk level is chroma_delete_documents?

chroma_delete_documents 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 chroma_delete_documents?

Yes. Add a rate_limit block to the chroma_delete_documents 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 chroma_delete_documents completely?

Set action: deny in the Intercept policy for chroma_delete_documents. 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 chroma_delete_documents?

chroma_delete_documents is provided by the ChromaDB MCP server (chroma-mcp). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON CHROMADB

Open source. One binary. Zero dependencies.

VIEW ON GITHUB Full ChromaDB policy →