---
title: "corestack_deployments_branches_list"
url: https://docs.corefinity.com/mcp/tools/corestack_deployments_branches_list
type: tool
last_updated: 2026-11-13
feature: deployments
related:
  - https://docs.corefinity.com/api/reference/deployments/list-site-deployment-branches.md
  - https://docs.corefinity.com/guides/sites/code-and-deployments/connect-a-repository.md
---
# corestack_deployments_branches_list

**Branches.** The branches of a repository one of the company's Git connections can deploy from. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

The branches of a repository one of the Git connections you may use on the site can deploy from.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `connection` (integer, ≥ 1, required): A Git connection's id (corestack_deployments_get lists the ones you may use).
- `repo` (string, up to 200 characters, required): owner/name, as corestack_deployments_repositories_list answers it.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "connection": {
      "minimum": 1,
      "type": "integer"
    },
    "repo": {
      "description": "owner/name, as corestack_deployments_repositories_list answers it.",
      "maxLength": 200,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "connection",
    "repo"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: the connection is not one you may use on this site — another company's, or one belonging to an agency that manages the site (its accounts are the agency's people's).
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_deployments_branches_list",
  "arguments": {
    "site_id": 4211,
    "connection": 12,
    "repo": "corefinity/example-shop"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_deployments_branches_list with site_id 4211, connection 12, repo corefinity/example-shop. (Branches.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/deployments/branches](https://docs.corefinity.com/api/reference/deployments/list-site-deployment-branches.md)
- Guide: [Connect a repository](https://docs.corefinity.com/guides/sites/code-and-deployments/connect-a-repository.md)
