MCP Tool Reference Critical Risk

delete_branch

Deletes a development branch

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

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

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

See the full Supabase policy for all 32 tools.

DETAILS

Tool Name

delete_branch

Category

Destructive

MCP Server

Supabase MCP Server

Risk Level

Critical

MORE SUPABASE TOOLS

View all 32 tools →

SIMILAR DESTRUCTIVE TOOLS ON OTHER SERVERS

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the delete_branch tool do?

Deletes a development branch. It is categorised as a Destructive tool in the Supabase 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_branch?

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

What risk level is delete_branch?

delete_branch 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_branch?

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

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

delete_branch is provided by the Supabase MCP server (supabase-community/supabase-mcp). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON SUPABASE

Open source. One binary. Zero dependencies.