Create a database branch

An MCP tool from the Supabase Management API server, hosted on mcp.hjlabs.in.

Create a database branch Creates a database branch from the specified project. [POST /v1/projects/{ref}/branches]

Name on the gateway: supabase_api__v1_create_a_branch · may change things.

Parameters

Name	Type	Description
`ref` required	`string`	Project ref
`branch_name` required	`string`
`git_branch`	`string`
`is_default`	`boolean`
`persistent`	`boolean`
`region`	`string`
`desired_instance_size`	`pico \| nano \| micro \| small \| medium \| large \| xlarge \| 2xlarge \| 4xlarge \| 8xlarge \| 12xlarge \| 16xlarge \| 24xlarge \| 24xlarge_optimized_memory \| 24xlarge_optimized_cpu \| 24xlarge_high_memory \| 48xlarge \| 48xlarge_optimized_memory \| 48xlarge_optimized_cpu \| 48xlarge_high_memory`
`release_channel`	`internal \| alpha \| beta \| ga \| withdrawn \| preview`	Release channel. If not provided, GA will be used.
`postgres_engine`	`15 \| 17 \| 17-oriole`	Postgres engine version. If not provided, the latest version will be used.
`secrets`	`object`
`with_data`	`boolean`
`notify_url`	`string`	HTTP endpoint to receive branch status updates.

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "supabase_api__v1_create_a_branch",
  "arguments": {
    "ref": "…",
    "branch_name": "…"
  }
}

Or connect the Supabase Management API server directly, which lists 167 tools including this one:

Run in your terminal

claude mcp add --transport http hj-supabase-api https://mcp.hjlabs.in/mcp/supabase-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the create a database branch tool with ref set to ….