> ## 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 · Versões

> Ferramentas para listar, publicar e voltar versões (canais Estável e Beta).

Ferramentas para listar, publicar e voltar versões (canais Estável e Beta).

| Ferramenta | O que faz | Tipo |
| - | - | - |
| `list_releases` | Versões publicadas (live = a que os usuários recebem). | Leitura |
| `publish_release` | Junta src/, compacta, criptografa e publica. Estável sai da principal; Beta de outra branch. Sem proteção pede confirm\_unprotected. | Grava |
| `rollback_release` | Volta o canal para uma versão anterior. | Grava |

## list\_releases

**Listar versões.** Versões publicadas (live = a que os usuários recebem).

> [!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}/studio/releases` 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_releases",
    "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
  }
}
```

## publish\_release

**Publicar versão.** Junta src/, compacta, criptografa e publica. Estável sai da principal; Beta de outra branch. Sem proteção pede confirm\_unprotected.

> [!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)

**version** `string` *required*

Número, ex.: 1.2.0

**notes** `string`

Notas

**channel** `string`

Canal Valores: `stable`, `beta`.

**branch** `string`

Branch (Beta)

**confirm\_unprotected** `boolean`

—

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/releases` 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": "publish_release",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "version": "1.2.0"
    }
  }
}
```

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

## rollback\_release

**Voltar versão.** Volta o canal para uma versão anterior.

> [!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)

**release\_id** `string` *required*

ID da versão

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/releases/{release_id}/rollback` 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": "rollback_release",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "release_id": "c2a4e6f8-1b3d-4f5a-8c7e-9d0b1a2c3e4f"
    }
  }
}
```

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