Werkzeuge · Abonnements
MCP-Tools für Abonnements: auflisten, wer was abonniert, die CSV exportieren, ein Abonnement ansehen, Gratis-Abos, Rabatte, Verlängerungen und Kündigungen, mit Bestätigung; und für jedes Mitglied die eigenen Abonnements und Käufe, mit Kündigen, Pausieren, Fortsetzen, Reaktivieren und Planwechsel.
Die Abonnements der Community, wie unter Mitglieder › Abonnements: wer abonniert, wie viel gezahlt wird, wer im Rückstand ist, und die Aktionen des Teams an jedem Abonnement, immer mit deiner Bestätigung. Und die Seite der Abonnenten: Jedes Mitglied sieht seine eigenen Abonnements und Käufe kümmert sich im Gespräch um sein eigenes Abonnement und wechselt den Plan.
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 |
|---|---|---|---|
list_subscriptions | Abonnements mit Status, Betrag und nächster Abbuchung | Administrator oder Finanzen | Nur lesen |
cancel_subscription | Kündigt das Abonnement eines Mitglieds, mit Bestätigung | Administrator oder Finanzen | Mit Bestätigung |
get_subscription | Ein Abonnement, mit Abbuchungen und nächster Abbuchung | Administrator oder Finanzen | Nur lesen |
create_manual_subscription | Gratis-Abo oder spätere Abbuchung, ohne Checkout | Administrator oder Finanzen | Mit Bestätigung |
update_subscription | Rabatt, Verlängerung, Zusatzprodukte, Reaktivierung, Zahlungslink | Administrator oder Finanzen | Mit Bestätigung |
export_subscriptions_csv | Die Abonnements als CSV, mit denselben Filtern | Administrator oder Finanzen | Nur lesen |
list_my_subscriptions | Deine Abonnements | Alle | Nur lesen |
list_my_purchases | Deine Einzelkäufe | Alle | Nur lesen |
manage_my_subscription | Kündigt, pausiert, setzt fort oder reaktiviert dein Abonnement | Alle | Mit Bestätigung |
quote_plan_change | Was ein Wechsel in einen anderen Plan kostet und was sich ändert | Alle, beim eigenen Abonnement | Nur lesen |
change_my_plan | Wechselt deinen Plan, sofort oder am Ende des Zeitraums | Alle, beim eigenen Abonnement | Mit Bestätigung |
get_scheduled_plan_change | Der geplante Planwechsel | Alle | Nur lesen |
cancel_scheduled_plan_change | Macht den geplanten Wechsel rückgängig | Alle, beim eigenen Abonnement | Mit Bestätigung |
list_subscriptions
Nur lesen
Abonnements auflisten. Die Abonnements, wie unter Mitglieder › Abonnements. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
status | ACTIVE, TRIALING, PAST_DUE, PAUSED, CANCELING, CANCELED, EXPIRED, COMPLIMENTARY | Nein | Nur ein Status |
plan_id | ID | Nein | Nur ein Plan |
option_id | ID | Nein | Nur eine Abrechnungsoption |
from, to | Datum ISO 8601 | Nein | Startdatum des Abonnements |
search | Text | Nein | Name oder E-Mail des Mitglieds |
page, limit | Zahl | Nein | Seitenweise Abfrage |
Liefert: jedes Abonnement mit ID (die cancel_subscription braucht), Mitglied, Plan, Option, Status, Betrag, Rabatt, Zusatzprodukten, Zahlungsart und nächster Abbuchung.
Frag so: „Wer ist mit dem Abonnement im Rückstand?" · „Wie viele Abonnenten hat der Plan Growth?"
cancel_subscription
Mit Bestätigung
Abonnement eines Mitglieds kündigen. Kündigt das Abonnement eines Mitglieds, zum Ende des bezahlten Zeitraums (Standard) oder sofort. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription_id | ID | Ja | Aus list_subscriptions |
immediate | ja oder nein | Nein | Standard: nein (Kündigung zum Ende des bezahlten Zeitraums) |
reason | Text, bis 500 | Nein | Steht in der Zeitleiste des Abonnements |
Die Zusammenfassung: die Aktion (Zum Ende des bezahlten Zeitraums kündigen oder Abonnement sofort kündigen), das Mitglied, der Plan, die Option, der Status, der Betrag und das Ende des Zeitraums.
Frag so: „Kündige das Abonnement von Ana Souza zum Ende des Zeitraums, Grund: per E-Mail angefragt."
Hinweise: Die Aktion erscheint in der Zeitleiste des Abonnements unter Abonnementverwaltung als von dir ausgeführt. Bereits Gezahltes wird nicht erstattet.
get_subscription
Nur lesen
Abonnement ansehen. Ein Abonnement mit Mitglied, Plan, Betrag, Zusatzprodukten, Abbuchungen und nächster Abbuchung. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription | ID oder Link (/billing?subscription=…) | Ja |
Frag so: „Zeig mir Anas Abonnement: wie viel sie zahlt und wann die nächste Abbuchung ist.“
create_manual_subscription
Mit Bestätigung
Manuelles Abonnement anlegen. Gibt einem Mitglied ein Abonnement ohne Checkout: als Gratis-Abo oder mit Abbuchung ab einem Datum. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
member | Profil-ID | Ja | Aus list_members |
option_id | ID | Ja | Die Abrechnungsoption, aus list_products |
mode | COMPLIMENTARY, FUTURE_CHARGE | Ja | Gratis-Abo ohne Abbuchung, oder spätere Abbuchung |
complimentary_until | Datum ISO 8601 | Nein | Das Ende des Gratis-Abos; leer, ohne Ende |
charge_starts_at | Datum ISO 8601 | Nein | Mit FUTURE_CHARGE |
payment_method | PIX, BOLETO, CREDIT_CARD | Nein | Mit FUTURE_CHARGE |
note | Text | Nein | Bleibt im Verlauf |
Frag so: „Gib dem Speaker Bruno den Plan Growth gratis bis 31.12.“
Hinweise: Bleibt im Audit der Abonnements. Siehe Abonnementverwaltung.
update_subscription
Mit Bestätigung
Ein Abonnement ändern. Die Aktionen des Teams an einem Abonnement. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription | ID oder Link | Ja | |
action | discount, remove_discount, extend, add_add_on, remove_add_on, reactivate, send_payment_link | Ja | |
percent | Zahl | Nein | Für discount |
until | Datum ISO 8601 | Nein | Das Ende des Rabatts, oder bis wann verlängert wird |
days | Zahl, 1 bis 3.650 | Nein | Für extend |
add_on_id | ID | Nein | Das Zusatzprodukt (zum Hinzufügen) oder das Abonnement des Zusatzprodukts (zum Entfernen) |
Frag so: „Gib Ana bis Jahresende 20 % Rabatt auf ihr Abonnement.“ · „Schick Bruno den Zahlungslink.“
Hinweise: Alle Aktionen brauchen dein Ja und bleiben im Audit. Ein Zusatzprodukt hinzufügen oder verlängern bucht jetzt nichts ab. Zum Kündigen nimm cancel_subscription.
export_subscriptions_csv
Nur lesen
Abonnements exportieren (CSV). Dieselbe Datei wie die Schaltfläche CSV exportieren unter Mitglieder › Abonnements. Mindestrolle: Administrator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
status | einer der Status | Nein | |
plan_id, option_id | ID | Nein | |
from, to | Datum ISO 8601 | Nein | Startdatum des Abonnements |
Liefert: die Zeilenzahl und den Inhalt der CSV. Eine sehr große Datei kommt gekürzt, mit dem Hinweis truncated; nutze die Filter.
Frag so: „Exportiere die aktiven Abonnements von Growth, damit ich sie an die Buchhaltung schicken kann.“
list_my_subscriptions
Nur lesen
Meine Abonnements. Deine eigenen Abonnements in der Community: Plan, Option, Status, Betrag und nächste Abbuchung. Mindestrolle: alle.
Parameter: keine.
Frag so: „Wann ist mein nächster Monatsbeitrag fällig?“
list_my_purchases
Nur lesen
Meine Käufe. Deine Einzelkäufe in der Community (Tickets, Kurse, Produkte) und der Status jedes Kaufs. Mindestrolle: alle.
Parameter: keine.
manage_my_subscription
Mit Bestätigung
Mein Abonnement verwalten. Kündigt, pausiert, setzt fort oder reaktiviert dein eigenes Abonnement, wie in der Abrechnung. Mindestrolle: alle, beim eigenen Abonnement.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription_id | ID | Ja | Aus list_my_subscriptions |
action | cancel, pause, resume, reactivate | Ja | Reaktivieren nur, bevor der Zeitraum endet |
immediately | ja oder nein | Nein | Nur bei cancel: beendet sofort statt am Ende des Zeitraums |
reason | Text, bis 500 | Nein | Nur bei cancel |
Liefert: beim ersten Aufruf Option, Status, Betrag und was passieren wird, sowie den Bestätigungscode.
Frag so: „Kündige mein Abonnement zum Ende des Zeitraums.“
Hinweise: Das ändert, was du zahlst, deshalb fragt es nach deinem Ja. Siehe Kündigung. Um in einen anderen Plan oder eine andere Abrechnungsoption zu wechseln, nutze quote_plan_change und change_my_plan.
Deinen Plan wechseln
Die vier Tools unten tun im Gespräch, was Abrechnung › Plan wechseln auf dem Bildschirm tut, mit denselben Regeln. Siehe Plan wechseln. Nur wer abonniert, wechselt den eigenen Plan: Das Team hat kein Tool, um den Plan eines Mitglieds zu wechseln.
Den Zielplan kannst du im Parameter target auf drei Arten angeben:
| Art | Beispiel |
|---|---|
| Der Name des Plans und der Abrechnungszeitraum | „Growth jährlich“ (target: "Growth", billing: "YEARLY") |
| Der von der Preisseite kopierte Link | …/pricing/growth/anual |
| Die ID der Option | wenn du sie schon hast (das Team findet sie in list_plans) |
Hat der Plan mehr als eine Option und sagt die Anfrage nicht, welche, fragt der Assistent nach und listet die Optionen auf.
Der Prompt Meinen Plan wechseln (change_plan) führt durch das ganze Gespräch: Er vergleicht die Pläne, zeigt, was der Wechsel kostet, und wechselt erst nach deinem Ja.
quote_plan_change
Nur lesen
Planwechsel simulieren. Was passiert, wenn du in eine andere Option wechselst, ohne etwas zu ändern. Mindestrolle: alle, beim eigenen Abonnement.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
target | ID, Link der Preisseite oder Name des Plans | Ja | Die Option, zu der du wechselst |
billing | MONTHLY, YEARLY oder der Name der Option | Nein | Welche Option des Plans, wenn er mehr als eine hat |
subscription_id | ID | Nein | Aus list_my_subscriptions. Standard: dein Plan-Abonnement in dieser Community |
immediate | ja oder nein | Nein | Nur für eine teurere Option. Standard: ja (gilt sofort); nein legt den Wechsel auf das Ende des Zeitraums |
Liefert: ob der Wechsel sofort gilt oder geplant wird (und warum), was jetzt abgebucht wird und in bis zu wie vielen Raten, die nächste Abbuchung und den Gesamtbetrag, was mit jeder Erweiterung passiert, den Vertrag, ob der Gutschein entfällt und ob ein bereits geplanter Wechsel ersetzt wird.
Frag so: „Was kostet der Wechsel auf Growth jährlich?“
change_my_plan
Mit Bestätigung
Meinen Plan wechseln. Wechselt dein Abonnement in eine andere Option. Eine teurere Option im selben Abrechnungszeitraum gilt sofort und bucht die anteilige Differenz gleich von deiner Standardkarte ab; eine günstigere, gleich teure, mit anderem Abrechnungszeitraum oder eine, bei der eine Erweiterung wegfallen würde, wird auf das Ende des Zeitraums gelegt. Mindestrolle: alle, beim eigenen Abonnement.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
target, billing, subscription_id, immediate | Dieselben wie bei quote_plan_change | ||
installments | Zahl, von 1 bis 12 | Nein | Raten für die Abbuchung jetzt, bis zum Maximum aus der Simulation. Standard: 1 |
Die Zusammenfassung: ist die Simulation: der Betrag jetzt und die Karte, wann der Wechsel gilt, die nächste Abbuchung, die Erweiterungen, der Vertrag und der Gutschein.
Frag so: „Wechsle meinen Plan auf Growth monatlich.“
Hinweise: Es geht um Geld, deshalb fragt es nach deinem Ja. Ohne gespeicherte Karte wird ein Wechsel, der sofort gilt, abgelehnt; hinterlege eine in der Abrechnung. Wird die Karte abgelehnt, ändert sich nichts und es wird nichts abgebucht.
get_scheduled_plan_change
Nur lesen
Geplanten Wechsel ansehen. Der Planwechsel, der auf das Ende des Zeitraums wartet: von welcher Option zu welcher, die Art und das Datum. Mindestrolle: alle, beim eigenen Abonnement; Eigentümer und Administrator lesen auch den eines Mitglieds.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription_id | ID | Nein | Standard: dein Plan-Abonnement |
Frag so: „Habe ich einen geplanten Wechsel?“
cancel_scheduled_plan_change
Mit Bestätigung
Geplanten Wechsel rückgängig machen. Storniert den geplanten Planwechsel; das Abonnement verlängert sich in der aktuellen Option. Mindestrolle: alle, nur beim eigenen Abonnement.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
subscription_id | ID | Nein | Standard: dein Plan-Abonnement |
Frag so: „Mach den Wechsel rückgängig.“
Hinweise: Wird abgelehnt, wenn der PIX oder das Boleto der Verlängerung bereits zum Preis des neuen Plans erzeugt wurde; der Wechsel gilt, sobald es bezahlt ist.