# Herramientas · Suscripciones
> Herramientas MCP para suscripciones: listar quién está suscrito a qué, exportar el CSV, ver una suscripción, cortesías, descuentos, extensiones y cancelaciones, con confirmación; y, para cualquier miembro, sus propias suscripciones y compras, con cancelar, pausar, reanudar, reactivar y cambiar de plan.
Las suscripciones de la comunidad, como en [Miembros › Suscripciones](/pagamentos/gestao-de-assinaturas): quién está suscrito, cuánto paga, quién va con retraso, y las acciones del equipo sobre cada suscripción, siempre con tu confirmación. Y el lado de quien está suscrito: cualquier miembro ve sus propias suscripciones y compras, gestiona su suscripción y cambia de plan desde la conversación.
Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao).
## En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
| [`list_subscriptions`](#list-subscriptions) | Suscripciones con estado, importe y próximo cobro | Administrador o Finanzas | Solo consulta |
| [`cancel_subscription`](#cancel-subscription) | Cancela la suscripción de un miembro | Administrador o Finanzas | Pide confirmación |
| [`get_subscription`](#get-subscription) | Una suscripción, con cobros y próximo cobro | Administrador o Finanzas | Solo consulta |
| [`create_manual_subscription`](#create-manual-subscription) | Cortesía o cobro futuro, sin checkout | Administrador o Finanzas | Pide confirmación |
| [`update_subscription`](#update-subscription) | Descuento, extender, adicionales, reactivar, enlace de pago | Administrador o Finanzas | Pide confirmación |
| [`export_subscriptions_csv`](#export-subscriptions-csv) | Las suscripciones en CSV, con los mismos filtros | Administrador o Finanzas | Solo consulta |
| [`list_my_subscriptions`](#list-my-subscriptions) | Tus suscripciones | Cualquiera | Solo consulta |
| [`list_my_purchases`](#list-my-purchases) | Tus compras sueltas | Cualquiera | Solo consulta |
| [`manage_my_subscription`](#manage-my-subscription) | Cancela, pausa, reanuda o reactiva tu suscripción | Cualquiera | Pide confirmación |
| [`quote_plan_change`](#quote-plan-change) | Cuánto cuesta y qué cambia al pasar a otro plan | Cualquiera, sobre su propia suscripción | Solo consulta |
| [`change_my_plan`](#change-my-plan) | Cambia tu plan, ahora o al final del periodo | Cualquiera, sobre su propia suscripción | Pide confirmación |
| [`get_scheduled_plan_change`](#get-scheduled-plan-change) | El cambio de plan programado | Cualquiera | Solo consulta |
| [`cancel_scheduled_plan_change`](#cancel-scheduled-plan-change) | Deshace el cambio programado | Cualquiera, sobre su propia suscripción | Pide confirmación |
## `list_subscriptions`
Solo consulta
**Listar suscripciones.** Las suscripciones, como en [Miembros › Suscripciones](/pagamentos/gestao-de-assinaturas). *Rol mínimo: administrador o Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `status` | `ACTIVE`, `TRIALING`, `PAST_DUE`, `PAUSED`, `CANCELING`, `CANCELED`, `EXPIRED`, `COMPLIMENTARY` | No | Un solo estado |
| `plan_id` | id | No | Un solo plan |
| `option_id` | id | No | Una sola opción de cobro |
| `from`, `to` | fecha ISO 8601 | No | Fecha de inicio de la suscripción |
| `search` | texto | No | Nombre o correo del miembro |
| `page`, `limit` | número | No | Paginación |
**Devuelve:** cada suscripción con el id (que pide `cancel_subscription`), miembro, plan, opción, estado, importe, descuento, adicionales, forma de pago y próximo cobro.
**Pídelo así:** *"¿Quién tiene la suscripción vencida?"* · *"¿Cuántos suscriptores tiene el plan Growth?"*
## `cancel_subscription`
Pide confirmación
**Cancelar la suscripción de un miembro.** Cancela la suscripción de un miembro, al final del periodo pagado (por defecto) o ahora. *Rol mínimo: administrador o Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription_id` | id | Sí | De `list_subscriptions` |
| `immediate` | sí o no | No | Por defecto: no (cancela al final del periodo pagado) |
| `reason` | texto, hasta 500 | No | Queda en la cronología de la suscripción |
**El resumen:** la acción (*Cancelar no fim do período pago* o *Cancelar a assinatura agora*), el miembro, el plan, la opción, el estado, el importe y el final del periodo.
**Pídelo así:** *"Cancela la suscripción de Ana Souza al final del periodo, motivo: lo pidió por correo."*
**Notas:** la acción aparece en la cronología de la suscripción, en [Gestión de suscripciones](/pagamentos/gestao-de-assinaturas), como hecha por ti. No se reembolsa nada de lo ya pagado.
## `get_subscription`
Solo consulta
**Ver suscripción.** Una suscripción con miembro, plan, importe, adicionales, cobros y próximo cobro. *Rol mínimo: Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription` | id o enlace (`/billing?subscription=…`) | Sí | |
**Pídelo así:** *"Enséñame la suscripción de Ana: cuánto paga y cuándo es el próximo cobro."*
## `create_manual_subscription`
Pide confirmación
**Crear suscripción manual.** Da una suscripción a un miembro sin pasar por el checkout: de cortesía o con cobro a partir de una fecha. *Rol mínimo: propietario, administrador o Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `member` | id de perfil | Sí | De `list_members` |
| `option_id` | id | Sí | La opción de cobro, de `list_products` |
| `mode` | `COMPLIMENTARY`, `FUTURE_CHARGE` | Sí | Cortesía, sin cobro, o cobro futuro |
| `complimentary_until` | fecha ISO 8601 | No | El fin de la cortesía; vacío, sin fin |
| `charge_starts_at` | fecha ISO 8601 | No | Con `FUTURE_CHARGE` |
| `payment_method` | `PIX`, `BOLETO`, `CREDIT_CARD` | No | Con `FUTURE_CHARGE` |
| `note` | texto | No | Queda en la línea de tiempo |
**Pídelo así:** *"Dale al ponente Bruno el plan Growth de cortesía hasta el 31/12."*
**Notas:** queda en la auditoría de suscripciones. Consulta [Gestión de suscripciones](/pagamentos/gestao-de-assinaturas).
## `update_subscription`
Pide confirmación
**Cambiar una suscripción.** Las acciones del equipo en una suscripción. *Rol mínimo: propietario, administrador o Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription` | id o enlace | Sí | |
| `action` | `discount`, `remove_discount`, `extend`, `add_add_on`, `remove_add_on`, `reactivate`, `send_payment_link` | Sí | Descuento, quitar descuento, extender, añadir adicional, quitar adicional, reactivar, enviar enlace de pago |
| `percent` | número | No | Para `discount` |
| `until` | fecha ISO 8601 | No | El fin del descuento, o hasta cuándo extender |
| `days` | número, de 1 a 3.650 | No | Para `extend` |
| `add_on_id` | id | No | El adicional (para incluirlo) o la suscripción del adicional (para quitarlo) |
**Pídelo así:** *"Aplica un 20% de descuento a la suscripción de Ana hasta fin de año."* · *"Envíale a Bruno el enlace de pago."*
**Notas:** todas las acciones piden tu sí y quedan en la auditoría. Incluir un adicional o extender no cobra ahora. Para cancelar, usa `cancel_subscription`.
## `export_subscriptions_csv`
Solo consulta
**Exportar suscripciones (CSV).** El mismo archivo del botón **Exportar CSV** de **Miembros › Suscripciones**. *Rol mínimo: administrador o Finanzas.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `status` | uno de los estados | No | |
| `plan_id`, `option_id` | id | No | |
| `from`, `to` | fecha ISO 8601 | No | Fecha de inicio de la suscripción |
**Devuelve:** cuántas filas y el contenido del CSV. Un archivo muy grande llega recortado, con el aviso `truncated`; usa los filtros.
**Pídelo así:** *"Exporta las suscripciones activas de Growth para mandárselas a finanzas."*
## `list_my_subscriptions`
Solo consulta
**Mis suscripciones.** Tus propias suscripciones en la comunidad: plan, opción, estado, importe y próximo cobro. *Rol mínimo: cualquiera.*
Parámetros: ninguno.
**Pídelo así:** *"¿Cuándo vence mi próxima mensualidad?"*
## `list_my_purchases`
Solo consulta
**Mis compras.** Tus compras sueltas en la comunidad (entradas, cursos, productos) y el estado de cada una. *Rol mínimo: cualquiera.*
Parámetros: ninguno.
## `manage_my_subscription`
Pide confirmación
**Gestionar mi suscripción.** Cancela, pausa, reanuda o reactiva tu propia suscripción, como en [Facturación](/pagamentos/faturamento-do-membro). *Rol mínimo: cualquiera, sobre su propia suscripción.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription_id` | id | Sí | De `list_my_subscriptions` |
| `action` | `cancel`, `pause`, `resume`, `reactivate` | Sí | Reactivar solo antes de que termine el periodo |
| `immediately` | sí o no | No | Solo en `cancel`: termina ahora en lugar de al final del periodo |
| `reason` | texto, hasta 500 | No | Solo en `cancel` |
**Devuelve:** en la primera llamada, la opción, el estado, el importe y lo que va a pasar, y el código de confirmación.
**Pídelo así:** *"Cancela mi suscripción al final del periodo."*
**Notas:** cambia lo que pagas, por eso pide tu sí. Consulta [Cancelación](/pagamentos/faturamento-do-membro). Para pasar a otro plan o a otra opción de cobro, usa [`quote_plan_change`](#quote-plan-change) y [`change_my_plan`](#change-my-plan).
## Cambiar tu plan
Las cuatro herramientas de abajo hacen desde la conversación lo mismo que **Facturación › Cambiar de plan** en la pantalla, con las mismas reglas. Consulta [Cambiar de plan](/pagamentos/faturamento-do-membro#cambiar-de-plan). Solo quien está suscrito cambia su propio plan: el equipo no tiene herramienta para cambiar el plan de un miembro.
**El plan de destino** se puede indicar de tres formas, en el parámetro `target`:
| Forma | Ejemplo |
|---|---|
| El nombre del plan y la periodicidad | *"el Growth anual"* (`target: "Growth"`, `billing: "YEARLY"`) |
| El enlace copiado de la página de precios | `…/pricing/growth/anual` |
| El id de la opción | cuando ya lo tienes (el equipo lo encuentra en `list_plans`) |
Si el plan tiene más de una opción y la petición no dice cuál, el asistente pregunta, con la lista de opciones.
El prompt **Cambiar mi plan** (`change_plan`) lleva la conversación entera: compara los planes, muestra cuánto cuesta y solo cambia después de tu sí.
## `quote_plan_change`
Solo consulta
**Simular cambio de plan.** Qué pasa si pasas a otra opción, sin cambiar nada. *Rol mínimo: cualquiera, sobre su propia suscripción.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `target` | id, enlace de la página de precios o nombre del plan | Sí | La opción a la que pasar |
| `billing` | `MONTHLY`, `YEARLY`, o el nombre de la opción | No | Qué opción del plan, cuando tiene más de una |
| `subscription_id` | id | No | De `list_my_subscriptions`. Por defecto: tu suscripción de plan en esta comunidad |
| `immediate` | sí o no | No | Solo para una opción más cara. Por defecto: sí (se aplica ahora); no la deja para el final del periodo |
**Devuelve:** si el cambio se aplica ahora o queda programado (y por qué), cuánto se cobra ahora y en hasta cuántas cuotas, el próximo cobro y el total, qué pasa con cada extensión, el contrato, si el cupón deja de aplicarse y si reemplaza un cambio ya programado.
**Pídelo así:** *"¿Cuánto cuesta pasarme al Growth anual?"*
## `change_my_plan`
Pide confirmación
**Cambiar mi plan.** Pasa tu suscripción a otra opción. Una opción más cara, con la misma periodicidad, se aplica ahora y cobra al momento la diferencia proporcional en tu **tarjeta predeterminada**; una más barata, del mismo precio, de otra periodicidad o que dejaría fuera una extensión queda para el final del periodo. *Rol mínimo: cualquiera, sobre su propia suscripción.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `target`, `billing`, `subscription_id`, `immediate` | | | Los mismos de `quote_plan_change` |
| `installments` | número, de 1 a 12 | No | Cuotas del cobro de ahora, hasta el máximo que mostró la simulación. Por defecto: 1 |
**El resumen:** es la simulación: el importe ahora y la tarjeta, cuándo se aplica el cambio, el próximo cobro, las extensiones, el contrato y el cupón.
**Pídelo así:** *"Cambia mi plan al Growth mensual."*
**Notas:** mueve dinero, por eso pide tu sí. Sin tarjeta guardada, un cambio que se aplica ahora se rechaza; añade una en [Facturación](/pagamentos/faturamento-do-membro). Si la tarjeta se rechaza, nada cambia y no se cobra nada.
## `get_scheduled_plan_change`
Solo consulta
**Ver cambio programado.** El cambio de plan que espera al final del periodo: de qué opción a cuál, el tipo y la fecha. *Rol mínimo: cualquiera, sobre su propia suscripción; propietario y administrador también leen el de un miembro.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription_id` | id | No | Por defecto: tu suscripción de plan |
**Pídelo así:** *"¿Tengo un cambio programado?"*
## `cancel_scheduled_plan_change`
Pide confirmación
**Deshacer cambio programado.** Cancela el cambio de plan programado; la suscripción se renueva en la opción actual. *Rol mínimo: cualquiera, solo sobre su propia suscripción.*
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `subscription_id` | id | No | Por defecto: tu suscripción de plan |
**Pídelo así:** *"Deshaz el cambio."*
**Notas:** se rechaza cuando el PIX o el boleto de la renovación ya se generó con el precio del plan nuevo; el cambio se aplica cuando se pague.
## Relacionados
- [Herramientas](/mcp/ferramentas)
- [Recetas](/mcp/receitas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)