Werkzeuge · Finanzen
MCP-Tools für das Geld der Community: Verkaufsübersicht, Kunden, Kontoauszug, Guthaben, Auszahlungen und die Gebührensimulation, und Auszahlungen anfordern oder stornieren, mit Bestätigung.
Die Kasse der Community: wie viel verkauft wurde, wer zahlt, der Kontoauszug, das verfügbare Guthaben, die Auszahlungen und was von einem Verkauf übrig bleibt. Eine Auszahlung anfordern oder stornieren braucht dein Ja, mit einer Zusammenfassung. Bei Beträgen erscheint nur die Plattformgebühr.
Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
get_sales_summary | Umsatz, Monatsreihe, Umsatz pro Produkt und Abonnenten | Administrator oder Finanzen | Nur lesen |
list_customers | Wer zahlt und wie viel schon gezahlt wurde | Administrator oder Finanzen | Nur lesen |
list_ledger_entries | Buchungen im Kontoauszug | Administrator oder Finanzen | Nur lesen |
get_balance | Gesamtguthaben, verfügbar, einbehalten und ausstehend | Administrator oder Finanzen | Nur lesen |
list_payouts | Auszahlungen und Status | Administrator oder Finanzen | Nur lesen |
simulate_fee | Wie viel die Community von einem Verkauf erhält | Administrator | Nur lesen |
request_payout | Fordert eine Auszahlung an, mit Bestätigung | Administrator | Mit Bestätigung |
cancel_payout | Storniert eine ausstehende Auszahlung, mit Bestätigung | Administrator | Mit Bestätigung |
get_sales_summary
Nur lesen
Verkaufsübersicht. Umsatz und Abonnenten eines Zeitraums. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
period | 7d, 30d, 90d, 1y, custom | Nein | Der Zeitraum |
start_date | Datum ISO 8601 | Nein | Mit period: custom |
end_date | Datum ISO 8601 | Nein | Mit period: custom |
Liefert: den Umsatz im Zeitraum, die Reihe Monat für Monat, den Umsatz pro Produkt und die aktiven, überfälligen und gekündigten Abonnenten. Bei Beträgen erscheint nur die Plattformgebühr.
Frag so: „Mach ein Diagramm des Umsatzes der letzten 12 Monate." · „Welches Produkt hat im Quartal am meisten verkauft?"
list_customers
Nur lesen
Wer zahlt und wie viel schon. Die zahlenden Kunden und die Gesamtsumme pro Kunde. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
page, limit | Zahl | Nein | Seitenweise Abfrage |
Liefert: die Kunden mit Name, E-Mail und gezahlter Gesamtsumme.
Frag so: „Wer sind die 10 Kunden, die am meisten gezahlt haben?"
list_ledger_entries
Nur lesen
Kontoauszug. Die Buchungen im Kontoauszug, neueste zuerst. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
entry_type | Text | Nein | Eine Buchungsart: SALE_GROSS, SALE_NET, PLATFORM_FEE, INSTALLMENT_INTEREST, REFUND, CHARGEBACK, PAYOUT_REQUESTED … |
page, limit | Zahl | Nein | Seitenweise Abfrage |
Liefert: die Buchungen mit Datum, Art, Beschreibung und Betrag. Siehe Guthaben und Kontoauszug.
Frag so: „Welche Erstattungen gab es diesen Monat?"
get_balance
Nur lesen
Guthaben. Das Guthaben der Community. Mindestrolle: Administrator oder Finanzen.
Parameter: keine.
Liefert: das Gesamtguthaben, das zur Auszahlung verfügbare, das einbehaltene und das noch freizugebende.
Frag so: „Wie viel kann ich heute auszahlen?"
list_payouts
Nur lesen
Auszahlungen. Die angeforderten Auszahlungen mit Status. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
status | PENDING, PROCESSING, COMPLETED, FAILED, CANCELED | Nein | Nur ein Status |
page, limit | Zahl | Nein | Seitenweise Abfrage |
Liefert: die Auszahlungen mit ID (die cancel_payout braucht), Betrag, Gebühr, Status und Datum.
Frag so: „Ist eine Auszahlung fehlgeschlagen?"
simulate_fee
Nur lesen
Wie viel ich von einem Verkauf erhalte. Simuliert einen Verkauf: Betrag, Plattformgebühr und was die Community erhält. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
amount | Zahl | Ja | Der Verkaufsbetrag in Reais |
payment_method | PIX, CREDIT_CARD, BOLETO | Nein | Die Zahlungsmethode |
installments | Zahl | Nein | Anzahl der Raten per Karte |
Liefert: den Betrag, die Plattformgebühr (die nicht von der Zahlungsmethode abhängt) und den Nettobetrag. Siehe Plattformgebühr.
Frag so: „Wenn ich einen Kurs für R$ 297 verkaufe, wie viel bleibt der Community?"
request_payout
Mit Bestätigung
Auszahlung anfordern. Fordert eine Auszahlung vom verfügbaren Guthaben auf das hinterlegte Bankkonto an. Mindestrolle: Administrator; Finanzen liest nur.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
amount | Zahl, in Reais | Ja | Bis zum verfügbaren Betrag (siehe get_balance) |
Die Zusammenfassung: Aktion, Betrag und aktuelles Guthaben.
Frag so: „Wie viel habe ich verfügbar? Zahl R$ 2.000 aus."
Hinweise: Die Gebühr von R$ 3,67 pro Auszahlung und die Regeln sind die des Dashboards. Siehe Auszahlung.
cancel_payout
Mit Bestätigung
Auszahlung stornieren. Storniert eine Auszahlung, die noch aussteht. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
payout_id | ID | Ja | Aus list_payouts |
Die Zusammenfassung: Aktion, Betrag, Status und Datum der Anforderung.
Frag so: „Storniere die Auszahlung über R$ 2.000, die ich heute angefordert habe."
Was es nicht gibt
Es gibt kein Tool für Erstattungen: Das läuft weiter über das Dashboard. Siehe Häufige Probleme.