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

# MCP tools · Versions

> Tools to list, publish and roll back versions (Stable and Beta channels).

Tools to list, publish and roll back versions (Stable and Beta channels).

| Tool | What it does | Type |
| - | - | - |
| `list_releases` | Published versions (live = the one users receive). | Read |
| `publish_release` | Bundles src/, minifies, encrypts and publishes. Stable comes from main; Beta from another branch. Without protection it requires confirm\_unprotected. | Write |
| `rollback_release` | Rolls the channel back to an earlier version. | Write |

## list\_releases

**List versions.** Published versions (live = the one users receive).

> [!NOTE]
>
> Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

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

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/studio/releases` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

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

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

## publish\_release

**Publish version.** Bundles src/, minifies, encrypts and publishes. Stable comes from main; Beta from another branch. Without protection it requires confirm\_unprotected.

> [!NOTE]
>
> Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

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

Script ID (uuid)

**version** `string` *required*

Number, e.g. 1.2.0

**notes** `string`

Notes

**channel** `string`

Channel Values: `stable`, `beta`.

**branch** `string`

Branch (Beta)

**confirm\_unprotected** `boolean`

—

### What it calls in the API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/releases` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

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

## rollback\_release

**Roll back version.** Rolls the channel back to an earlier version.

> [!NOTE]
>
> Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

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

Script ID (uuid)

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

Version ID

### What it calls in the API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/studio/releases/{release_id}/rollback` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

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


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