# 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: <span class="tool-kind tool-kind-read">Solo consulta</span> no cambia nada, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia algo al momento, y <span class="tool-kind tool-kind-confirm">Pide confirmación</span> 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 |
|---|---|---|---|
| [`get_sales_summary`](#get-sales-summary) | Ingresos, serie mensual, ingresos por producto y suscriptores | Administrador o Finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_customers`](#list-customers) | Quién paga y cuánto ha pagado | Administrador o Finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_ledger_entries`](#list-ledger-entries) | Movimientos del extracto | Administrador o Finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_balance`](#get-balance) | Saldo total, disponible, retenido y por liberar | Administrador o Finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_payouts`](#list-payouts) | Retiros y su estado | Administrador o Finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`simulate_fee`](#simulate-fee) | Cuánto recibe la comunidad de una venta | Administrador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`request_payout`](#request-payout) | Pide un retiro | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`cancel_payout`](#cancel-payout) | Cancela un retiro pendiente | Administrador | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |

## `get_sales_summary`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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](/pagamentos/saldo-e-extrato).

**Pídelo así:** *"¿Cuáles han sido los reembolsos de este mes?"*

## `get_balance`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**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](/pagamentos/taxa-da-plataforma).

**Pídelo así:** *"Si vendo un curso de R$ 297, ¿cuánto le queda a la comunidad?"*

## `request_payout`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**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](/pagamentos/saque).

## `cancel_payout`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**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](/mcp/problemas-comuns#lo-que-todavia-no-se-puede-hacer).

## Relacionados

- [Herramientas](/mcp/ferramentas)
- [Recetas](/mcp/receitas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)