# Cobros recurrentes

> Herramientas del MCP para consultar planes recurrentes, suscriptores y sus pagos, y para pausar, reactivar o eliminar un suscriptor.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-09-02
- url: https://www.tilopay.com/developers/agentes/mcp/recurrentes

## Qué cubre [#que-cubre]

Cuatro herramientas de lectura sobre los planes de cobro recurrente y sus suscriptores, y una sensible que pausa, reactiva o elimina un suscriptor. Esa última afecta cobros futuros: pedí confirmación humana antes de ejecutarla.

## Herramientas [#herramientas]

### Listar planes de cobro recurrente [#tilopay-recurring-list-plans]

- `tilopay_recurring_list_plans`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/getPlansRepeat`

Lista los planes de cobro recurrente configurados en Tilopay.

**Parámetros**

Sin parámetros.

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Detalle de un plan recurrente [#tilopay-recurring-get-plan]

- `tilopay_recurring_get_plan`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/getPlanRepeat`

Obtiene el detalle de un plan de cobro recurrente por su ID.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | ID del plan |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Detalle de un suscriptor [#tilopay-recurring-get-subscriber]

- `tilopay_recurring_get_subscriber`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/getSuscriptorRepeat`

Obtiene el detalle de un suscriptor de un plan recurrente por su ID.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | ID del suscriptor |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Pagos de un suscriptor [#tilopay-recurring-subscriber-payments]

- `tilopay_recurring_subscriber_payments`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/getSuscriptorPayments`

Lista los pagos realizados por un suscriptor recurrente.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | ID del suscriptor |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Pausar, reactivar o eliminar un suscriptor [#tilopay-recurring-manage-subscriber]

- `tilopay_recurring_manage_subscriber`
- Acceso: Sensible
- Operación del API: `POST /api/v1/pauseSuscriptorRepeat, /reactiveSuscriptorRepeat o /deleteSuscriptorRepeat`

Pausa, reactiva o elimina un suscriptor de un plan recurrente en Tilopay. Operación sensible: afecta cobros futuros.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `idSubscriber` | string | sí | ID del suscriptor |
| `action` | string (pause | reactivate | delete) | sí | Acción a realizar |

**Devuelve**

`{ result }`

Respuesta cruda del endpoint correspondiente a la acción: pause, reactivate o delete.