> ## 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.

# Herramientas del MCP · Branches

> Herramientas para listar y crear branches, compararlas y fusionar una branch en otra.

Herramientas para listar y crear branches, compararlas y fusionar una branch en otra.

| Herramienta | Qué hace | Tipo |
| - | - | - |
| `list_branches` | Branches con head\_sha. | Lectura |
| `create_branch` | Crea una branch a partir de un commit (por defecto: head de la principal). | Escritura |
| `compare_branches` | Muestra qué cambiaría y si hay conflicto al fusionar source en target (no escribe nada). | Lectura |
| `merge_branch` | Fusiona source en target. Se detiene si hay conflicto. | Escritura |

## list\_branches

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

> [!NOTE]
>
> Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

### Parámetros

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

ID del script (uuid)

### Qué llama en la API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/repo/branches` da [API do Scripts](https://docs.doglytdc.dev/es/scripts/api.md). La respuesta incluye texto y structuredContent, sin secretos.

### Ejemplo

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

```json Respuesta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON de la respuesta... }"
      }
    ],
    "isError": false
  }
}
```

## create\_branch

**Crear branch.** Crea una branch a partir de un commit (por defecto: head de la principal).

> [!NOTE]
>
> Escribe o modifica datos del script. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

### Parámetros

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

ID del script (uuid)

**name** `string` *required*

Nombre

**from** `string`

SHA de origen

### Qué llama en la API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/repo/branches` da [API do Scripts](https://docs.doglytdc.dev/es/scripts/api.md). La respuesta incluye texto y structuredContent, sin secretos.

### Ejemplo

```json Solicitud 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 Respuesta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON de la respuesta... }"
      }
    ],
    "isError": false
  }
}
```

## compare\_branches

**Comparar.** Muestra qué cambiaría y si hay conflicto al fusionar source en target (no escribe nada).

> [!NOTE]
>
> Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

### Parámetros

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

ID del script (uuid)

**source** `string` *required*

Branch de origen

**target** `string`

Destino (por defecto: main)

### Qué llama en la API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/merge` da [API do Scripts](https://docs.doglytdc.dev/es/scripts/api.md). La respuesta incluye texto y structuredContent, sin secretos.

### Ejemplo

```json Solicitud 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 Respuesta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON de la respuesta... }"
      }
    ],
    "isError": false
  }
}
```

## merge\_branch

**Fusionar.** Fusiona source en target. Se detiene si hay conflicto.

> [!NOTE]
>
> Escribe o modifica datos del script. Acción destructiva: revisa en tu cliente de IA antes de confirmar. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

### Parámetros

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

ID del script (uuid)

**source** `string` *required*

Branch de origen

**target** `string`

Destino (por defecto: main)

**message** `string`

Mensaje

### Qué llama en la API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/merge` da [API do Scripts](https://docs.doglytdc.dev/es/scripts/api.md). La respuesta incluye texto y structuredContent, sin secretos.

### Ejemplo

```json Solicitud 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 Respuesta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON de la respuesta... }"
      }
    ],
    "isError": false
  }
}
```


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