> ## 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 · Usuarios

> Herramientas para ver quién usa el script, banear, desactivar, reactivar, ver el historial y pausar el script. Solo el dueño.

Herramientas para ver quién usa el script, banear, desactivar, reactivar, ver el historial y pausar el script. Solo el dueño.

| Herramienta | Qué hace | Tipo |
| - | - | - |
| `list_users` | Quién abrió el script (@username), estado, versión, sitio y usos. Solo el dueño. | Lectura |
| `set_user_status` | banned, disabled (con until opcional) o active. Vale en la próxima apertura. Solo el dueño. | Destructiva |
| `user_history` | Aperturas y acciones (de un usuario o de todos). | Lectura |
| `pause_script` | Pausa o reanuda el script para todos (el dueño sigue pudiendo abrirlo). Solo el dueño. | Destructiva |

## list\_users

**Quién lo usó.** Quién abrió el script (@username), estado, versión, sitio y usos. Solo el dueño.

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

## set\_user\_status

**Banear/desactivar/reactivar.** banned, disabled (con until opcional) o active. Vale en la próxima apertura. Solo el dueño.

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

**user\_id** `string` *required*

ID de la fila en list\_users

**status** `string` *required*

Nuevo estado Valores: `active`, `disabled`, `banned`.

**reason** `string`

Motivo

**until** `string`

Fin de la desactivación (ISO)

### Qué llama en la API

Por baixo, a ferramenta usa `PATCH /scripts/{script_id}/studio/users/{user_id}` 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": "set_user_status",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40",
      "user_id": "d4e6f8a0-2b4c-4e6f-8a0b-1c2d3e4f5a6b",
      "status": "disabled"
    }
  }
}
```

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

## user\_history

**Historial.** Aperturas y acciones (de un usuario o de todos).

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

**user\_id** `string`

ID de la fila (opcional)

### Qué llama en la API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/studio/user-events[/{user_id}]` 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": "user_history",
    "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
  }
}
```

## pause\_script

**Pausar para todos.** Pausa o reanuda el script para todos (el dueño sigue pudiendo abrirlo). Solo el dueño.

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

**paused** `boolean` *required*

—

### Qué llama en la API

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

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