Herramientas · Finanzas
Herramientas MCP para el dinero de la comunidad: resumen de ventas, clientes, extracto, saldo, retiros y la simulación de la comisión, y pedir o cancelar retiros, con confirmación.
La caja de la comunidad: cuánto ha vendido, quién paga, el extracto, el saldo disponible, los retiros y cuánto queda de una venta. Pedir o cancelar un retiro pide tu sí, con un resumen. En los importes solo aparece la comisión de la plataforma.
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 |
|---|---|---|---|
get_sales_summary | Ingresos, serie mensual, ingresos por producto y suscriptores | Administrador o Finanzas | Solo consulta |
list_customers | Quién paga y cuánto ha pagado | Administrador o Finanzas | Solo consulta |
list_ledger_entries | Movimientos del extracto | Administrador o Finanzas | Solo consulta |
get_balance | Saldo total, disponible, retenido y por liberar | Administrador o Finanzas | Solo consulta |
list_payouts | Retiros y su estado | Administrador o Finanzas | Solo consulta |
simulate_fee | Cuánto recibe la comunidad de una venta | Administrador | Solo consulta |
request_payout | Pide un retiro | Administrador | Pide confirmación |
cancel_payout | Cancela un retiro pendiente | Administrador | Pide confirmación |
get_sales_summary
Solo consulta
Resumen de ventas. Los ingresos y los suscriptores de un periodo. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
period | 7d, 30d, 90d, 1y, custom | No | El periodo |
start_date | fecha ISO 8601 | No | Con period: custom |
end_date | fecha ISO 8601 | No | Con period: custom |
Devuelve: los ingresos del periodo, la serie mes a mes, los ingresos por producto y los suscriptores activos, vencidos y cancelados. En importes, solo aparece la comisión de la plataforma.
Pídelo así: "Haz un gráfico de los ingresos de los últimos 12 meses." · "¿Qué producto se vendió más en el trimestre?"
list_customers
Solo consulta
Quién paga y cuánto ha pagado. Los clientes de pago y el total pagado por cada uno. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page, limit | número | No | Paginación |
Devuelve: los clientes, con nombre, correo y total pagado.
Pídelo así: "¿Quiénes son los 10 clientes que más han pagado?"
list_ledger_entries
Solo consulta
Extracto. Los movimientos del extracto, los más nuevos primero. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
entry_type | texto | No | Un tipo de movimiento: SALE_GROSS, SALE_NET, PLATFORM_FEE, INSTALLMENT_INTEREST, REFUND, CHARGEBACK, PAYOUT_REQUESTED… |
page, limit | número | No | Paginación |
Devuelve: los movimientos, con fecha, tipo, descripción e importe. Consulta Saldo y extracto.
Pídelo así: "¿Cuáles han sido los reembolsos de este mes?"
get_balance
Solo consulta
Saldo. El saldo de la comunidad. Rol mínimo: administrador o Finanzas.
Parámetros: ninguno.
Devuelve: el saldo total, el disponible para retirar, el retenido y lo que aún está por liberar.
Pídelo así: "¿Cuánto puedo retirar hoy?"
list_payouts
Solo consulta
Retiros. Los retiros solicitados, con su estado. Rol mínimo: administrador o Finanzas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
status | PENDING, PROCESSING, COMPLETED, FAILED, CANCELED | No | Un solo estado |
page, limit | número | No | Paginación |
Devuelve: los retiros, con el id (que pide cancel_payout), importe, tarifa, estado y fechas.
Pídelo así: "¿Ha fallado algún retiro?"
simulate_fee
Solo consulta
Cuánto recibo de una venta. Simula una venta: el importe, la comisión de la plataforma y lo que recibe la comunidad. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | número | Sí | El importe de la venta, en reales |
payment_method | PIX, CREDIT_CARD, BOLETO | No | El método de pago |
installments | número | No | Número de cuotas con tarjeta |
Devuelve: el importe, la comisión de la plataforma (que no depende del método de pago) y el neto. Consulta Comisión de la plataforma.
Pídelo así: "Si vendo un curso de R$ 297, ¿cuánto le queda a la comunidad?"
request_payout
Pide confirmación
Pedir retiro. Pide un retiro del saldo disponible a la cuenta bancaria registrada. Rol mínimo: administrador; Finanzas solo lee.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | número, en reales | Sí | Hasta el disponible (compruébalo con get_balance) |
El resumen: la acción, el importe y el saldo actual.
Pídelo así: "¿Cuánto tengo disponible? Retira R$ 2.000."
Notas: la tarifa de R$ 3,67 por retiro y las reglas son las del panel. Consulta Retiro.
cancel_payout
Pide confirmación
Cancelar retiro. Cancela un retiro que todavía está pendiente. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
payout_id | id | Sí | De list_payouts |
El resumen: la acción, el importe, el estado y la fecha de la solicitud.
Pídelo así: "Cancela el retiro de R$ 2.000 que pedí hoy."
Lo que no existe
No hay herramienta de reembolso: sigue en el panel. Consulta Problemas comunes.