Skip to main content
List all branches for a project. Returns feature branches, not the main branch.

Tool details

FieldValue
Namelist_branches
GroupBranches

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    }
  },
  "required": [
    "project_reference"
  ],
  "additionalProperties": false,
  "description": "Input schema for the list_branches tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "branches": {
      "type": "array",
      "items": {
        "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."
          },
          "base_branch_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The base branch id associated with this record."
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Creation timestamp in ISO 8601 format."
          },
          "created_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "The created by associated with this record."
          },
          "merged_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "The merged at associated with this record."
          },
          "merged_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "The merged by associated with this record."
          },
          "version": {
            "type": "number",
            "description": "The version associated with this record."
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "merged",
              "closed"
            ],
            "description": "Lifecycle status for the record."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable description for the record."
          },
          "auto_delete_on_merge": {
            "type": "boolean",
            "description": "The auto delete on merge associated with this record."
          }
        },
        "required": [
          "id",
          "name",
          "project_id",
          "base_branch_id",
          "created_at",
          "created_by",
          "merged_at",
          "merged_by",
          "version",
          "status",
          "description",
          "auto_delete_on_merge"
        ],
        "additionalProperties": false,
        "description": "Structured branch schema for MCP tools."
      },
      "description": "List of branches associated with this record."
    }
  },
  "required": [
    "branches"
  ],
  "additionalProperties": false,
  "description": "Structured list branches output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}