Home / Servers / Supabase Management API / v1_delete_a_branch
Delete a database branch
An MCP tool from the Supabase Management API server, hosted on mcp.hjlabs.in.
Delete a database branch Deletes the specified database branch. By default, deletes immediately. Use force=false to schedule deletion with 1-hour grace period (only when soft deletion is enabled). [DELETE /v1/branches/{branch_id_or_ref}]
Name on the gateway: supabase_api__v1_delete_a_branch · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
branch_id_or_ref required | string | Branch ref or deprecated branch ID |
force | string | If set to false, schedule deletion with 1-hour grace period (only when soft… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "supabase_api__v1_delete_a_branch",
"arguments": {
"branch_id_or_ref": "…"
}
}Or connect the Supabase Management API server directly, which lists 167 tools including this one:
claude mcp add --transport http hj-supabase-api https://mcp.hjlabs.in/mcp/supabase-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the delete a database branch tool with branch_id_or_ref set to ….