> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas do MCP · Branches

> Ferramentas para listar e criar branches, comparar e mesclar uma branch em outra.

Ferramentas para listar e criar branches, comparar e mesclar uma branch em outra.

| Ferramenta | O que faz | Tipo |
| - | - | - |
| `list_branches` | Branches com head\_sha. | Leitura |
| `create_branch` | Cria uma branch a partir de um commit (padrão: head da principal). | Grava |
| `compare_branches` | Mostra o que mudaria e se há conflito ao mesclar source em target (não grava nada). | Leitura |
| `merge_branch` | Mescla source em target. Para se houver conflito. | Grava |

## list\_branches

**Listar branches.** Branches com head\_sha.

> [!NOTE]
>
> Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

### Parâmetros

**script\_id** `string` *required*

ID do script (uuid)

### O que chama na API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/repo/branches` da [API do Scripts](https://docs.doglytdc.dev/pt-BR/scripts/api.md). A resposta inclui texto e structuredContent, com segredos removidos.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_branches",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## create\_branch

**Criar branch.** Cria uma branch a partir de um commit (padrão: head da principal).

> [!NOTE]
>
> Grava ou muda dados do script. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

### Parâmetros

**script\_id** `string` *required*

ID do script (uuid)

**name** `string` *required*

Nome

**from** `string`

SHA de origem

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/repo/branches` da [API do Scripts](https://docs.doglytdc.dev/pt-BR/scripts/api.md). A resposta inclui texto e structuredContent, com segredos removidos.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_branch",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "name": "nova-tela"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## compare\_branches

**Comparar.** Mostra o que mudaria e se há conflito ao mesclar source em target (não grava nada).

> [!NOTE]
>
> Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

### Parâmetros

**script\_id** `string` *required*

ID do script (uuid)

**source** `string` *required*

Branch de origem

**target** `string`

Destino (padrão: main)

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/merge` da [API do Scripts](https://docs.doglytdc.dev/pt-BR/scripts/api.md). A resposta inclui texto e structuredContent, com segredos removidos.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_branches",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "source": "nova-tela"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## merge\_branch

**Mesclar.** Mescla source em target. Para se houver conflito.

> [!NOTE]
>
> Grava ou muda dados do script. Ação destrutiva: confira antes de aprovar. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

### Parâmetros

**script\_id** `string` *required*

ID do script (uuid)

**source** `string` *required*

Branch de origem

**target** `string`

Destino (padrão: main)

**message** `string`

Mensagem

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/merge` da [API do Scripts](https://docs.doglytdc.dev/pt-BR/scripts/api.md). A resposta inclui texto e structuredContent, com segredos removidos.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "merge_branch",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "source": "nova-tela"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.