Strumenti · Finanze
Strumenti MCP per il denaro della community: riepilogo delle vendite, clienti, estratto conto, saldo, prelievi e la simulazione della commissione, e richiedere o annullare prelievi, con conferma.
La cassa della community: quanto ha venduto, chi paga, l'estratto conto, il saldo disponibile, i prelievi, e quanto resta di una vendita. Richiedere o annullare un prelievo chiede il tuo sì, con un riepilogo. Negli importi compare solo la commissione della piattaforma.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
get_sales_summary | Ricavi, serie mensile, ricavi per prodotto e abbonati | Admin o Finanza | Solo lettura |
list_customers | Chi paga e quanto ha già pagato | Admin o Finanza | Solo lettura |
list_ledger_entries | Movimenti dell'estratto conto | Admin o Finanza | Solo lettura |
get_balance | Saldo totale, disponibile, trattenuto e da liberare | Admin o Finanza | Solo lettura |
list_payouts | Prelievi e stato | Admin o Finanza | Solo lettura |
simulate_fee | Quanto riceve la community da una vendita | Admin | Solo lettura |
request_payout | Richiede un prelievo, con conferma | Admin | Chiede conferma |
cancel_payout | Annulla un prelievo in sospeso, con conferma | Admin | Chiede conferma |
get_sales_summary
Solo lettura
Riepilogo vendite. I ricavi e gli abbonati di un periodo. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
period | 7d, 30d, 90d, 1y, custom | No | Il periodo |
start_date | data ISO 8601 | No | Con period: custom |
end_date | data ISO 8601 | No | Con period: custom |
Restituisce: i ricavi del periodo, la serie mese per mese, i ricavi per prodotto e gli abbonati attivi, in ritardo e annullati. Negli importi compare solo la commissione della piattaforma.
Chiedi così: "Fai un grafico dei ricavi degli ultimi 12 mesi." · "Quale prodotto ha venduto di più nel trimestre?"
list_customers
Solo lettura
Chi paga e quanto ha già pagato. I clienti paganti e il totale pagato da ciascuno. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
page, limit | numero | No | Paginazione |
Restituisce: i clienti, con nome, e-mail e totale pagato.
Chiedi così: "Chi sono i 10 clienti che hanno pagato di più?"
list_ledger_entries
Solo lettura
Estratto conto. I movimenti dell'estratto conto, dai più recenti. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
entry_type | testo | No | Un tipo di movimento: SALE_GROSS, SALE_NET, PLATFORM_FEE, INSTALLMENT_INTEREST, REFUND, CHARGEBACK, PAYOUT_REQUESTED… |
page, limit | numero | No | Paginazione |
Restituisce: i movimenti, con data, tipo, descrizione e importo. Vedi Saldo ed estratto conto.
Chiedi così: "Quali sono stati i rimborsi di questo mese?"
get_balance
Solo lettura
Saldo. Il saldo della community. Ruolo minimo: Admin o Finanza.
Parametri: nessuno.
Restituisce: il saldo totale, il disponibile per il prelievo, il trattenuto e ciò che deve ancora essere liberato.
Chiedi così: "Quanto posso prelevare oggi?"
list_payouts
Solo lettura
Prelievi. I prelievi richiesti, con lo stato. Ruolo minimo: Admin o Finanza.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
status | PENDING, PROCESSING, COMPLETED, FAILED, CANCELED | No | Un solo stato |
page, limit | numero | No | Paginazione |
Restituisce: i prelievi, con id (che chiede cancel_payout), importo, commissione, stato e date.
Chiedi così: "Qualche prelievo è fallito?"
simulate_fee
Solo lettura
Quanto ricevo da una vendita. Simula una vendita: l'importo, la commissione della piattaforma e ciò che riceve la community. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
amount | numero | Sì | L'importo della vendita, in reais |
payment_method | PIX, CREDIT_CARD, BOLETO | No | Il metodo di pagamento |
installments | numero | No | Numero di rate con carta |
Restituisce: l'importo, la commissione della piattaforma (che non dipende dal metodo di pagamento) e il netto. Vedi Commissione della piattaforma.
Chiedi così: "Se vendo un corso da R$ 297, quanto resta alla community?"
request_payout
Chiede conferma
Richiedere un prelievo. Richiede un prelievo dal saldo disponibile verso il conto bancario registrato. Ruolo minimo: Admin; il ruolo Finanza può solo leggere.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
amount | numero, in reais | Sì | Fino al disponibile (vedilo con get_balance) |
Il riepilogo: l'azione, l'importo e il saldo attuale.
Chiedi così: "Quanto ho disponibile? Preleva R$ 2.000."
Note: la commissione di R$ 3,67 per prelievo e le regole sono quelle del pannello. Vedi Prelievo.
cancel_payout
Chiede conferma
Annullare un prelievo. Annulla un prelievo ancora in sospeso. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
payout_id | id | Sì | Da list_payouts |
Il riepilogo: l'azione, l'importo, lo stato e la data della richiesta.
Chiedi così: "Annulla il prelievo da R$ 2.000 che ho chiesto oggi."
Cosa non esiste
Non c'è uno strumento di rimborso: si continua dal pannello. Vedi Problemi comuni.