Skip to main content
Create a new branch for a project. Branches allow you to work on features in isolation before merging back to main.

​
Tool details

FieldValue
Namecreate_branch
GroupBranches

​
Playground

​
Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "name": {
      "type": "string",
      "description": "Branch name (e.g., \"feature-new-header\")"
    },
    "base_branch_id": {
      "type": "string",
      "format": "uuid",
      "description": "Base branch ID to create from (null for main branch)"
    }
  },
  "required": [
    "project_reference",
    "name"
  ],
  "additionalProperties": false,
  "description": "Input schema for the create_branch tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

​
Output schema

Output schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the record."
    },
    "project_id": {
      "type": "string",
      "description": "Project identifier associated with the record."
    }
  },
  "required": [
    "id",
    "name",
    "project_id"
  ],
  "additionalProperties": false,
  "description": "Structured create branch output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}