MCP Tool Reference Critical Risk

delete

Delete a data item by ID from a dataset

Part of the Cognee 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 to permanently remove or destroy resources in Cognee. 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

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

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

See the full Cognee policy for all 7 tools.

DETAILS

Tool Name

delete

Category

Destructive

MCP Server

Cognee MCP Server

Risk Level

Critical

MORE COGNEE TOOLS

SIMILAR DESTRUCTIVE TOOLS ON OTHER SERVERS

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the delete tool do?

Delete a data item by ID from a dataset. It is categorised as a Destructive tool in the Cognee 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?

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

What risk level is delete?

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

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

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

delete is provided by the Cognee MCP server (topoteretes/cognee). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON COGNEE

Open source. One binary. Zero dependencies.