# Cuenta, comercio y equipo

> Herramientas del MCP para vincular o desvincular la cuenta, elegir el comercio activo, gestionar empleados del asistente y consultar usuarios del panel y métodos de pago habilitados.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-10-07
- url: https://tilopay.com/developers/agentes/mcp/cuenta

## Qué cubre [#que-cubre]

Este grupo cubre la cuenta de Tilopay vinculada al asistente: vincularla o desvincularla, elegir el
comercio activo cuando hay varios, dar o quitar acceso a empleados, y consultar los usuarios del
panel web y los métodos de pago y monedas habilitados. Desvincular la cuenta y quitar el acceso a un
empleado están marcadas como sensibles y piden confirmación explícita antes de ejecutarse.

## Herramientas [#herramientas]

### Comercio seleccionado [#tilopay-switch-commerce]

- `tilopay_switch_commerce`
- Acceso: Escritura

Muestra el comercio activo de la cuenta de Tilopay vinculada y permite cambiarlo cuando la cuenta tiene varios.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `commerce_id` | string | — | Comercio que se quiere activar. Si se omite, solo se muestra el actual. |

**Devuelve**



### Desvincular mi cuenta [#tilopay-unlink-account]

- `tilopay_unlink_account`
- Acceso: Sensible

Desvincula la cuenta de Tilopay del asistente: revoca TODO el acceso (WhatsApp, Claude y otras aplicaciones), borra las claves guardadas (incluidas las del banco) y cierra las sesiones bancarias. Antes de llamarla con confirm=true, repítele al comercio ese alcance y pide confirmación. Úsela cuando el comercio pida desvincular, desconectar o quitar tu cuenta del asistente.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `confirm` | boolean | sí | Debe ser true: el comercio confirmó que quiere desvincular tu cuenta. |
| `all_channels` | boolean | — | true solo si el comercio pidió expresamente desvincular también el otro canal (WhatsApp y clientes MCP). |

**Devuelve**



### Vincular mi cuenta [#tilopay-send-link-flow]

- `tilopay_send_link_flow`
- Acceso: Escritura

Envía al WhatsApp del comercio el botón para vincular (o volver a vincular) tu cuenta de Tilopay con el asistente. Úsela ante cualquier petición de vincular, conectar o activar el asistente con la cuenta de Tilopay.

**Parámetros**

Sin parámetros.

**Devuelve**



### Dar acceso a un empleado [#tilopay-invite-employee]

- `tilopay_invite_employee`
- Acceso: Escritura

Invita a un empleado a usar el asistente con su propio usuario de Tilopay (solo el dueño). Pide nombre y teléfono de WhatsApp del empleado. Devuelve un enlace wa.me para que el dueño le envíe la invitación. En tu respuesta, repite primero la línea `prerequisito` tal cual y luego entrega el enlace. El empleado puede consultar ventas, crear cobros y enviar comprobantes; no puede reembolsar, cobrar tarjetas guardadas, crear o borrar productos, cambiar precios ni cambiar la configuración.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `name` | string | sí | Nombre del empleado |
| `phone` | string | sí | WhatsApp del empleado, ej. 8888-8888 |

**Devuelve**



### Ver mis empleados [#tilopay-list-employees]

- `tilopay_list_employees`
- Acceso: Sólo lectura

Lista los empleados con acceso al asistente y las invitaciones pendientes (solo el dueño).

**Parámetros**

Sin parámetros.

**Devuelve**



### Quitar acceso a un empleado [#tilopay-remove-employee]

- `tilopay_remove_employee`
- Acceso: Sensible

Quita el acceso de un empleado al asistente (solo el dueño): revoca toda su sesión, o cancela la invitación si no se había vinculado. Antes de llamarla con confirm=true, confirma con el dueño a quién se quita.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `name` | string | — | Nombre del empleado |
| `phone` | string | — | Teléfono del empleado |
| `confirm` | boolean | sí | true: el dueño confirmó quitarle el acceso |

**Devuelve**



### Métodos de pago y monedas habilitados [#tilopay-accepted-payment-methods]

- `tilopay_accepted_payment_methods`
- Acceso: Sólo lectura

Métodos de pago que el comercio tiene habilitados en Tilopay (marcas de tarjeta, SINPE, etc.), monedas configuradas y configuración PayFac. Úsala para «¿qué tarjetas acepto?», «¿tengo SINPE activo?», «¿puedo cobrar en dólares?».

**Parámetros**

Sin parámetros.

**Devuelve**



### Usuarios del panel de Tilopay [#tilopay-panel-users]

- `tilopay_panel_users`
- Acceso: Sólo lectura

Usuarios que tienen acceso al panel web de Tilopay del comercio y sus módulos. Distinto de los empleados del asistente (tilopay_list_employees).

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `page` | integer | — | Página (por defecto 1) |
| `limit` | integer | — | Registros por página (por defecto 20) |
| `search` | string | — | Texto a buscar |

**Devuelve**