> ## 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 · Código

> Herramientas para leer el árbol de archivos, leer un archivo, escribir commits y buscar texto en el código.

Herramientas para leer el árbol de archivos, leer un archivo, escribir commits y buscar texto en el código.

| Herramienta | Qué hace | Tipo |
| - | - | - |
| `get_presentation` | Lê a apresentação validada, commit aplicado e erros, sem publicar o executável. | Lectura |
| `validate_presentation` | Valida ui/site/ de uma branch ou commit. Não aplica branches de trabalho. | Lectura |
| `ensure_presentation_files` | Adiciona apenas arquivos ui/site/ ausentes ao repositório antigo. Não sobrescreve o executável. Exige expected\_head. | Escritura |
| `read_tree` | Lista los archivos de una branch o commit. | Lectura |
| `read_file` | Contenido de un archivo. | Lectura |
| `write_files` | Escribe un commit. Lee el head de la branch en list\_branches y envíalo en expected\_head. content null borra el archivo. | Escritura |
| `search_code` | Busca un texto en todos los archivos de un ref (hasta 50 resultados). | Lectura |

## get\_presentation

**Ver apresentação aplicada.** Lê a apresentação validada, commit aplicado e erros, sem publicar o executável.

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

### Ejemplo

```json Solicitud theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_presentation",
    "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
  }
}
```

## validate\_presentation

**Validar cartão e popup.** Valida ui/site/ de uma branch ou commit. Não aplica branches de trabalho.

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

**ref** `string`

Branch ou commit

### Ejemplo

```json Solicitud theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "validate_presentation",
    "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
  }
}
```

## ensure\_presentation\_files

**Preparar apresentação.** Adiciona apenas arquivos ui/site/ ausentes ao repositório antigo. Não sobrescreve o executável. Exige expected\_head.

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

**expected\_head** `string | null` *required*

—

### Ejemplo

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

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

## read\_tree

**Leer árbol.** Lista los archivos de una branch o commit.

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

**ref** `string`

Branch o SHA (por defecto: principal)

### Qué llama en la API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/repo/tree` 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": "read_tree",
    "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
  }
}
```

## read\_file

**Leer archivo.** Contenido de un archivo.

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

**path** `string` *required*

Ruta, ej.: src/script.js

**ref** `string`

Branch o SHA

### Qué llama en la API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/repo/files/{path}` 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": "read_file",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "path": "src/script.js"
    }
  }
}
```

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

## write\_files

**Escribir archivos.** Escribe un commit. Lee el head de la branch en list\_branches y envíalo en expected\_head. content null borra el archivo.

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

**branch** `string`

Branch (por defecto: principal)

**expected\_head** `string` *required*

head\_sha actual de la branch

**message** `string` *required*

Mensaje del commit

**changes** `object[]` *required*

Lista de elementos.

**campos de cada elemento**

**path** `string` *required*

Campo del elemento.

**content** `string | null` *required*

Campo del elemento.

### Qué llama en la API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/repo/commits` 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": "write_files",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "expected_head": "3b1f0e9c2a7d4b6e8f0a1c3d5e7f9a1b2c3d4e5f",
      "message": "Atualiza o botão",
      "changes": [
        {
          "path": "src/script.js",
          "content": "// novo conteúdo"
        }
      ]
    }
  }
}
```

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

## search\_code

**Buscar en el código.** Busca un texto en todos los archivos de un ref (hasta 50 resultados).

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

**query** `string` *required*

Texto

**ref** `string`

Branch o SHA

### Qué llama en la API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/repo/tree`, `GET /scripts/{script_id}/repo/files/{path}` 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": "search_code",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "query": "createCard"
    }
  }
}
```

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