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: 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.
En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
list_subscriptions | Suscripciones con estado, importe y próximo cobro | Administrador o Finanzas | Solo consulta |
cancel_subscription | Cancela la suscripción de un miembro | Administrador o Finanzas | Pide confirmación |
get_subscription | Una suscripción, con cobros y próximo cobro | Administrador o Finanzas | Solo consulta |
create_manual_subscription | Cortesía o cobro futuro, sin checkout | Administrador o Finanzas | Pide confirmación |
update_subscription | Descuento, extender, adicionales, reactivar, enlace de pago | Administrador o Finanzas | Pide confirmación |
export_subscriptions_csv | Las suscripciones en CSV, con los mismos filtros | Administrador o Finanzas | Solo consulta |
list_my_subscriptions | Tus suscripciones | Cualquiera | Solo consulta |
list_my_purchases | Tus compras sueltas | Cualquiera | Solo consulta |
manage_my_subscription | Cancela, pausa, reanuda o reactiva tu suscripción | Cualquiera | Pide confirmación |
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 | Cambia tu plan, ahora o al final del periodo | Cualquiera, sobre su propia suscripción | Pide confirmación |
get_scheduled_plan_change | El cambio de plan programado | Cualquiera | Solo consulta |
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. 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, 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.
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. 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. Para pasar a otro plan o a otra opción de cobro, usa quote_plan_change y 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. 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. 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.