Herramientas · Ventas y planes
Herramientas MCP para vender: listar planes, productos y cupones, crear opciones de cobro y planes con adicionales en borrador, publicar y retirar de la venta, cambiar precios, crear, editar y eliminar cupones y ofertas de downsell, eliminar productos y planes y reordenar los planes, con confirmación en lo que toca al dinero.
Lo que vende la comunidad: planes con las opciones de cobro y los adicionales, productos sueltos, cupones. Todo nace en borrador y solo sale a la venta cuando tú lo pides; cambiar un precio, crear o editar un cupón, crear o editar una oferta de última oportunidad y eliminar piden tu sí, con un resumen de los importes. Cambiar un plan (update_plan) se ejecuta en la primera llamada.
Borrador antes de la aprobación
Puedes montarlo todo antes de que se apruebe la información empresarial: los productos, las opciones, los planes, los adicionales, los cupones y las ofertas de downsell nacen en borrador y se pueden editar a voluntad. Lo que espera la aprobación es publicar y vender:
publish_producten una comunidad sin aprobación se rechaza con el mensaje de Memberfy: "Para publicar y empezar a vender, la comunidad necesita tener la información empresarial aprobada. Mientras tanto, puedes crear y configurar todo como borrador: complétala en Configuración › Información Empresarial y envíala a revisión."- En las compuestas (
create_course,create_eventycreate_plancon publicar), el rechazo no deshace nada: el curso, el evento, la entrada, el plan y las opciones quedan en borrador, la respuesta trae el motivo enpublish_blocked, y el siguiente paso sugerido es completar la información empresarial y después publicar conpublish_product. - El precio de un borrador queda en la moneda del país de la información empresarial (en cualquier estado) o, si no la hay, en reales. Si la moneda aprobada es otra, la publicación se rechaza ("Este producto está en …, pero la moneda de la información empresarial aprobada es …"): ajusta antes la moneda y el precio.
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_plans | Planes, opciones y adicionales | Administrador o Finanzas | Solo consulta |
list_products | Opciones de cobro y productos, con precio y estado | Administrador o Finanzas | Solo consulta |
list_coupons | Cupones con estado y uso | Administrador o Finanzas | Solo consulta |
create_product | Crea un producto u opción de cobro, en borrador | Administrador | Modifica |
create_plan | Opciones, plan y adicionales, de una vez | Administrador | Modifica |
publish_product | Pone un producto a la venta | Administrador | Modifica |
unpublish_product | Retira un producto de la venta | Administrador | Modifica |
update_price | Cambia un precio | Administrador | Pide confirmación |
create_coupon | Crea un cupón | Administrador | Pide confirmación |
update_plan | Cambia nombre, dirección, opciones y adicionales de un plan | Administrador | Modifica |
update_product | Cambia título, espacios, stock, cuotas, prueba y enlace directo | Administrador | Modifica |
update_coupon_status | Pausa o reactiva un cupón | Administrador | Pide confirmación |
update_coupon | Cambia el nombre, el descuento, la duración, los límites, la validez y los productos de un cupón | Administrador | Pide confirmación |
delete_coupon | Elimina un cupón | Administrador | Pide confirmación |
get_coupon_usage | Quién usó un cupón | Administrador o Finanzas | Solo consulta |
list_downsell_offers | Las ofertas de última oportunidad de un plan, con conversión | Administrador | Solo consulta |
create_downsell_offer | Crea una oferta de última oportunidad | Administrador | Pide confirmación |
update_downsell_offer | Cambia o pausa una oferta de última oportunidad | Administrador | Pide confirmación |
delete_downsell_offer | Elimina una oferta de última oportunidad | Administrador | Pide confirmación |
delete_product | Elimina un producto o una opción de cobro | Administrador | Pide confirmación |
delete_plan | Elimina un plan | Administrador | Pide confirmación |
reorder_plans | Pone los planes en un orden nuevo en la página de precios | Administrador | Modifica |
get_storefront | Lo que muestra un espacio de Tienda | Administrador | Solo consulta |
update_storefront | Elige los productos de una Tienda | Administrador | Modifica |
list_plans
Solo consulta
Listar planes. Los planes de la comunidad, con las opciones de cobro y los adicionales de cada uno. Rol mínimo: administrador o Finanzas.
Parámetros: ninguno.
Devuelve: los planes (id, nombre, dirección), las opciones de cada uno (id, título, precio, intervalo, estado) y los adicionales.
Pídelo así: "¿Qué planes tenemos y cuánto cuesta cada opción?"
list_products
Solo consulta
Listar opciones de cobro y productos. Todos los productos: opciones de suscripción, sueltos, a plazos y adicionales. Rol mínimo: administrador o Finanzas.
Parámetros: ninguno.
Devuelve: cada producto con id, título, tipo, precio, intervalo, estado (borrador o publicado) y los espacios a los que da acceso. El id es el que piden create_plan (en add_on_ids), update_price, publish_product y create_coupon.
Pídelo así: "¿Qué productos están en borrador?"
list_coupons
Solo consulta
Listar cupones. Los cupones, con estado y uso. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
status | ACTIVE, INACTIVE, EXPIRED | No | Un solo estado |
search | texto | No | Parte del código o del nombre |
page, limit | número | No | Paginación |
Devuelve: los cupones, con código, tipo, valor, duración, validez, límite y usos.
Pídelo así: "¿Qué cupones están activos y cuántas veces se ha usado cada uno?"
create_product
Modifica
Crear opción de cobro o producto. Crea un producto en borrador: una opción de suscripción, un producto suelto (entrada, curso) o uno a plazos. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
title | texto, de 3 a 255 | Sí | |
type | SUBSCRIPTION, ONE_TIME, INSTALLMENT | Sí | Opción de suscripción, suelto o a plazos |
price | número, en la moneda de la comunidad | Sí | En la suscripción, el importe de cada ciclo; en el anual en cuotas, el importe del año |
interval | MONTHLY, YEARLY | No | Solo en SUBSCRIPTION: mensual o anual |
max_installments | 1 a 12 | No | Hasta cuántas cuotas con tarjeta (suelto, o anual) |
commitment_months | 1 a 36 | No | Duración del contrato; solo en el mensual |
trial_days | 0 a 365 | No | Prueba gratuita |
description | texto simple, hasta 5.000 | No | Sin formato: las marcas de Markdown se eliminan |
space_ids | lista de ids | No | Los espacios a los que da acceso la compra |
stock | número | No | Cantidad a la venta (entradas). Vacío: sin límite |
direct_link | sí o no | No | Un producto suelto vendible por enlace directo, fuera de la Tienda |
Devuelve: el producto creado, en borrador, con el id.
Pídelo así: "Crea el producto Mentoría suelta, R$ 450, en hasta 3 cuotas, que da acceso al espacio Mentorías. Déjalo en borrador."
Notas: no se vende nada hasta publish_product, y crear no depende de que la información empresarial esté aprobada (consulta Borrador antes de la aprobación). Para un plan con varias opciones, create_plan lo hace todo de una vez. Las reglas de cada campo son las del panel: consulta Productos y Opciones de cobro.
create_plan
Modifica
Crear plan con opciones y adicionales. Opciones de cobro → plan con las opciones → adicionales vinculados. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | texto, hasta 120 | Sí | El nombre del plan |
description | texto simple | No | Sin formato: las marcas de Markdown se eliminan |
slug | texto, hasta 60 | No | La dirección del plan, para el enlace /pricing/<dirección> |
options | lista, de 1 a 6 | Sí | Las opciones de cobro (ver más abajo) |
add_on_ids | lista de ids | No | Productos mensuales que ya existen y no son opción de ningún plan, de list_products |
publish | sí o no | No | Publica todas las opciones. Por defecto: borrador |
idempotency_key | texto, hasta 100 | No |
Cada opción:
| Campo | Tipo | Descripción |
|---|---|---|
title | texto, de 3 a 255 | Obligatorio. P. ej.: Mentoría · Mensual |
price | número, en la moneda de la comunidad | Obligatorio. En el anual, el importe del año |
interval | MONTHLY, YEARLY | Por defecto: MONTHLY |
max_installments | 1 a 12 | En el anual, hasta cuántas cuotas con tarjeta |
commitment_months | 1 a 36 | Contrato mínimo, en el mensual |
trial_days | 0 a 365 | Prueba gratuita |
description | texto simple | Sin formato: las marcas de Markdown se eliminan |
space_ids | lista de ids | Los espacios a los que da acceso la opción |
Devuelve: el plan (id, nombre, dirección), las opciones (id, título, precio, intervalo, estado) y los adicionales vinculados.
Pídelo así: "Crea el plan Mentoría con mensual de R$ 390 con contrato de 6 meses y anual de R$ 3.900 en hasta 12 cuotas, los dos con acceso al espacio Mentoría, y vincula la Sesión individual como adicional."
Notas: si un paso falla, el plan se deshace el último, porque Memberfy no borra un plan que aún tiene opciones. Consulta Planes, Adicionales y Anual en cuotas.
publish_product
Modifica
Publicar producto (ponerlo a la venta). Pone a la venta un producto en borrador. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
product_id | id | Sí | De list_products o de una creación |
Devuelve: el producto, publicado.
Pídelo así: "Ya puedes publicar el producto Excel desde Cero."
Notas: publicar exige la información empresarial aprobada, y el producto en la moneda del país aprobado. Si no, Memberfy lo rechaza y el producto sigue en borrador, editable. Consulta Borrador antes de la aprobación.
unpublish_product
Modifica
Retirar producto de la venta. Retira un producto de la venta. Quien ya lo compró mantiene el acceso. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
product_id | id | Sí |
Devuelve: el producto, fuera de la venta.
Pídelo así: "Retira de la venta la entrada del encuentro de octubre."
update_price
Pide confirmación
Cambiar el precio de un producto. Cambia el precio de un producto o de una opción de cobro. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
product_id | id | Sí | De list_products |
new_price | número, en reales | Sí |
El resumen: el producto, el precio actual, el precio nuevo y el estado (borrador o publicado).
Pídelo así: "Sube el Growth Mensual de R$ 129 a R$ 149."
Notas: las suscripciones que ya existen siguen las reglas de Memberfy para los cambios de precio, las mismas que al editar desde el panel. Consulta Opciones de cobro.
create_coupon
Pide confirmación
Crear cupón. Crea un cupón de descuento, porcentual o de importe fijo, para todos los productos o solo para algunos. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | texto, de 2 a 50 | Sí | P. ej.: PRO20. Se guarda en mayúsculas |
name | texto, hasta 120 | Sí | El nombre interno |
type | PERCENTAGE, FIXED | Sí | Porcentual o importe fijo |
value | número | Sí | 20 = 20 %, o el importe en reales |
duration | ONCE, FOREVER, REPEATING | No | En suscripciones: solo el 1.er cobro (por defecto), siempre, o durante unos meses |
months | 1 a 36 | No | Con REPEATING |
max_uses | número | No | Vacío: sin límite |
start_date | fecha ISO 8601 | No | Por defecto: ahora |
end_date | fecha ISO 8601 | No | Vacío: sin fin |
product_ids | lista de ids | No | Solo estos productos. Vacío: todos |
El resumen: la acción, el código, el descuento (20% o R$ 50,00), la duración, el límite de usos, la validez y los productos.
Pídelo así: "Crea el cupón BLACK30, 30 % solo en el primer cobro, para los planes Growth, hasta 100 usos, válido hasta el 30/11."
Consulta Cupones.
update_plan
Modifica
Editar plan. Cambia el nombre, la descripción, la dirección, si está activo, las opciones de cobro y los adicionales de un plan. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace (/pricing/…) | Sí | |
name, description, slug | texto | No | |
active | sí o no | No | |
option_ids | lista de ids | No | La lista completa de opciones del plan |
add_on_ids | lista de ids | No | La lista completa de adicionales |
Pídelo así: "Quita la opción anual del plan Growth y deja solo la mensual."
Notas: cambia lo que se vende al momento, sin confirmación. El precio se cambia con update_price, que pide tu sí.
update_product
Modifica
Editar producto. Cambia título, descripciones, espacios que libera, stock, cuotas, prueba gratuita o enlace directo. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
product | id o slug | Sí | |
title, description, short_description | texto | No | |
space_ids | lista de ids | No | Los espacios que libera la compra |
stock | número | No | |
max_installments | número | No | |
trial_days | número | No | |
direct_link | sí o no | No |
Pídelo así: "Sube el stock de la entrada a 120."
Notas: el precio se cambia con update_price, que pide confirmación.
update_coupon_status
Pide confirmación
Pausar o reactivar cupón. Pausa o reactiva un cupón. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
coupon | id o código | Sí | |
status | ACTIVE, INACTIVE | Sí | Reactivar o pausar |
Pídelo así: "Pausa el cupón BLACK30."
update_coupon
Pide confirmación
Editar cupón. Cambia un cupón que ya existe. Solo cambia lo que se envía; para pausarlo, update_coupon_status. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
coupon | id o código | Sí | |
name, description | texto | No | |
value | número | No | Porcentaje (20 = 20 %) o importe, según el tipo del cupón |
duration | ONCE, FOREVER, REPEATING | No | Una vez, para siempre o durante algunos meses |
months | 1 a 36 | No | Con REPEATING |
max_uses, max_uses_per_person | número | No | Límites de uso |
start_date, end_date | fecha | No | La validez |
product_ids | lista de ids | No | Los productos en los que vale el cupón |
Devuelve: en la primera llamada, el código y lo que cambia, y el código de confirmación.
Pídelo así: "Sube el BLACK30 al 40 % y amplíalo hasta el domingo."
Consulta Cupones.
delete_coupon
Pide confirmación
Eliminar cupón. Los descuentos ya concedidos siguen vigentes. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
coupon | id o código | Sí |
Devuelve: en la primera llamada, el código y cuántas veces se ha usado, y el código de confirmación.
get_coupon_usage
Solo consulta
Ver el uso de un cupón. Quién lo usó, cuándo y cuánto descuento. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
coupon | id o código | Sí | |
page | número | No |
Pídelo así: "¿Quién ha usado el cupón BLACK30?"
list_downsell_offers
Solo consulta
Ofertas de downsell de un plan. Las ofertas de descuento en adicionales después de la compra de un plan, con cuántas veces se mostraron y convirtieron. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace | Sí |
Pídelo así: "¿Cuánto convierte la oferta de última oportunidad de la Extensión Coworking?"
create_downsell_offer
Pide confirmación
Crear oferta de downsell. Crea una oferta de descuento en un adicional, que se muestra después del pago del plan. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace | Sí | |
add_on_id | id | Sí | El adicional del plan |
discount_percent | número | No | |
timing | IMMEDIATE, DELAYED | No | Al momento (por defecto) o después de un tiempo |
delay_minutes | número | No | Con DELAYED |
price_duration | FOREVER, FIRST_CHARGE, CYCLES | No | Descuento para siempre, solo en el primer cobro o durante algunos ciclos |
cycles | número | No | Con CYCLES |
ttl_minutes | número | No | Cuánto tiempo vale la oferta |
Pídelo así: "Ofrece un 30% en la Extensión Coworking a quien se suscriba a Growth sin ella, en los 3 primeros cobros."
Consulta Downsell.
update_downsell_offer
Pide confirmación
Editar oferta de downsell. Cambia una oferta de última oportunidad de un plan, o la pausa. Solo cambia lo que se envía. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace | Sí | |
offer_id | id | Sí | De list_downsell_offers |
discount_percent, timing, delay_minutes, price_duration, cycles, ttl_minutes | No | Los mismos de create_downsell_offer | |
active | sí o no | No | Con no, pausa la oferta |
Pídelo así: "Pausa la oferta de la Extensión Coworking hasta final de mes."
delete_downsell_offer
Pide confirmación
Eliminar oferta de downsell. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace | Sí | |
offer_id | id | Sí | De list_downsell_offers |
delete_product
Pide confirmación
Eliminar producto. Elimina un producto o una opción de cobro. Quien lo compró conserva el acceso. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
product | id o slug | Sí | De list_products |
Devuelve: en la primera llamada, el título, el precio y el estado, y el código de confirmación.
Notas: si solo quieres dejar de vender, mejor unpublish_product. Consulta Productos.
delete_plan
Pide confirmación
Eliminar plan. No se cancela a quien ya está suscrito. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan | id o enlace (/pricing/…) | Sí |
Devuelve: en la primera llamada, el nombre del plan y sus opciones, y el código de confirmación.
reorder_plans
Modifica
Reordenar planes. Pone los planes en un orden nuevo en la página de precios, del primero al último. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
plan_ids | lista de ids | Sí | De list_plans, en el orden nuevo |
Pídelo así: "En la página de precios, pon Growth antes de Starter."
get_storefront
Solo consulta
Ver tienda. Lo que muestra un espacio de Tienda: todos los productos o solo los elegidos. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | El espacio de Tienda |
update_storefront
Modifica
Elegir los productos de la tienda. Define lo que vende un espacio de Tienda. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
mode | all, selected | Sí | Todos los productos publicados, o solo los elegidos |
product_ids | lista de ids | No | Con selected, de list_products |
Pídelo así: "Deja en la tienda solo los cursos sueltos."
Consulta Tienda.