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

> Ferramentas para o backend do script: listar, criar a partir de modelos, publicar e testar funções.

Ferramentas para o backend do script: listar, criar a partir de modelos, publicar e testar funções.

| Ferramenta | O que faz | Tipo |
| - | - | - |
| `list_functions` | Funções do backend do script. | Leitura |
| `create_function` | Grava supabase/functions/\<name>.js a partir de um modelo (hello, save, ai, access). Depois use deploy\_functions. | Grava |
| `deploy_functions` | Publica o backend a partir da branch principal. | Grava |
| `test_function` | Chama a função como você; body vira request.body. | Grava |

## list\_functions

**Listar funções.** Funções do backend do script.

> [!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}/functions` 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_functions",
    "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\_function

**Criar função de modelo.** Grava supabase/functions/\<name>.js a partir de um modelo (hello, save, ai, access). Depois use deploy\_functions.

> [!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 (a-z, 0-9, - e \_)

**template** `string` *required*

Modelo Valores: `hello`, `save`, `ai`, `access`.

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

head\_sha da principal

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/repo/commits` 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_function",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "name": "hello",
      "template": "hello",
      "expected_head": "3b1f0e9c2a7d4b6e8f0a1c3d5e7f9a1b2c3d4e5f"
    }
  }
}
```

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

## deploy\_functions

**Publicar funções.** Publica o backend a partir da branch principal.

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

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/deploy` 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": "deploy_functions",
    "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
  }
}
```

## test\_function

**Testar função.** Chama a função como você; body vira request.body.

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

**name** `string` *required*

Nome

**body** `object`

—

### O que chama na API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/functions/{name}` 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": "test_function",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "name": "hello"
    }
  }
}
```

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