Werkzeuge · Verkauf und Pläne

MCP-Tools für den Verkauf: Pläne, Produkte und Gutscheine auflisten, Abrechnungsoptionen und Pläne mit Zusatzprodukten als Entwurf anlegen, veröffentlichen und zurückziehen, Preise ändern, Gutscheine und Downsell-Angebote anlegen, bearbeiten und löschen, Produkte und Pläne löschen und die Pläne neu ordnen, mit Bestätigung bei allem, was Geld betrifft.

Was die Community verkauft: Pläne mit Abrechnungsoptionen und Zusatzprodukten, Einzelprodukte, Gutscheine. Alles entsteht als Entwurf und geht erst in den Verkauf, wenn du es sagst; einen Preis ändern, einen Gutschein oder ein Letzte-Chance-Angebot anlegen oder bearbeiten und Löschen brauchen dein Ja, mit einer Zusammenfassung der Beträge. Einen Plan ändern (update_plan) läuft beim ersten Aufruf.

Entwurf vor der Genehmigung

Du kannst alles aufbauen, bevor die Geschäftsinformationen genehmigt sind: Produkte, Optionen, Pläne, Zusatzprodukte, Gutscheine und Downsell-Angebote entstehen als Entwurf und lassen sich beliebig bearbeiten. Auf die Genehmigung wartet nur das Veröffentlichen und Verkaufen:

publish_product wird in einer Community ohne Genehmigung mit der Meldung von Memberfy abgelehnt: „Um zu veröffentlichen und zu verkaufen, braucht die Community genehmigte Geschäftsinformationen. Bis dahin kannst du alles als Entwurf anlegen und konfigurieren: Fülle sie unter Einstellungen › Geschäftsinformationen aus und reiche sie zur Prüfung ein.“
Bei den zusammengesetzten Tools (create_course, create_event und create_plan mit Veröffentlichen) macht die Ablehnung nichts rückgängig: Kurs, Event, Ticket, Plan und Optionen bleiben als Entwurf, die Antwort nennt den Grund in publish_blocked, und der vorgeschlagene nächste Schritt ist, die Geschäftsinformationen auszufüllen und danach mit publish_product zu veröffentlichen.
Der Preis eines Entwurfs steht in der Währung des Landes aus den Geschäftsinformationen (in jedem Status) oder, ohne sie, in Real. Ist die genehmigte Währung eine andere, wird das Veröffentlichen abgelehnt („Dieses Produkt ist in …, die genehmigten Geschäftsinformationen verwenden aber …“): Passe vorher Währung und Preis an.

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_plans`	Pläne, Optionen und Zusatzprodukte	Administrator oder Finanzen	Nur lesen
`list_products`	Abrechnungsoptionen und Produkte, mit Preis und Status	Administrator oder Finanzen	Nur lesen
`list_coupons`	Gutscheine mit Status und Nutzung	Administrator oder Finanzen	Nur lesen
`create_product`	Legt ein Produkt oder eine Abrechnungsoption als Entwurf an	Administrator	Ändert
`create_plan`	Optionen, Plan und Zusatzprodukte auf einmal	Administrator	Ändert
`publish_product`	Stellt ein Produkt in den Verkauf	Administrator	Ändert
`unpublish_product`	Nimmt ein Produkt aus dem Verkauf	Administrator	Ändert
`update_price`	Ändert einen Preis, mit Bestätigung	Administrator	Mit Bestätigung
`create_coupon`	Legt einen Gutschein an, mit Bestätigung	Administrator	Mit Bestätigung
`update_plan`	Ändert Name, Adresse, Optionen und Zusatzprodukte eines Plans	Administrator	Ändert
`update_product`	Ändert Titel, Bereiche, Bestand, Raten, Testphase und Direktlink	Administrator	Ändert
`update_coupon_status`	Pausiert einen Gutschein oder aktiviert ihn wieder	Administrator	Mit Bestätigung
`update_coupon`	Ändert Name, Rabatt, Dauer, Limits, Gültigkeit und Produkte eines Gutscheins	Administrator	Mit Bestätigung
`delete_coupon`	Löscht einen Gutschein	Administrator	Mit Bestätigung
`get_coupon_usage`	Wer einen Gutschein genutzt hat	Administrator oder Finanzen	Nur lesen
`list_downsell_offers`	Die Last-Chance-Angebote eines Plans, mit Konversion	Administrator	Nur lesen
`create_downsell_offer`	Legt ein Last-Chance-Angebot an	Administrator	Mit Bestätigung
`update_downsell_offer`	Ändert oder pausiert ein Last-Chance-Angebot	Administrator	Mit Bestätigung
`delete_downsell_offer`	Löscht ein Last-Chance-Angebot	Administrator	Mit Bestätigung
`delete_product`	Löscht ein Produkt oder eine Abrechnungsoption	Administrator	Mit Bestätigung
`delete_plan`	Löscht einen Plan	Administrator	Mit Bestätigung
`reorder_plans`	Bringt die Pläne auf der Preisseite in eine neue Reihenfolge	Administrator	Ändert
`get_storefront`	Was ein Shop-Bereich zeigt	Administrator	Nur lesen
`update_storefront`	Wählt die Produkte eines Shops aus	Administrator	Ändert

`list_plans`

Nur lesen

Pläne auflisten. Die Pläne der Community mit ihren Abrechnungsoptionen und Zusatzprodukten. Mindestrolle: Administrator oder Finanzen.

Parameter: keine.

Liefert: die Pläne (ID, Name, Adresse), die Optionen jedes Plans (ID, Titel, Preis, Intervall, Status) und die Zusatzprodukte.

Frag so: „Welche Pläne haben wir, und was kostet jede Option?"

`list_products`

Nur lesen

Abrechnungsoptionen und Produkte auflisten. Alle Produkte: Abo-Optionen, Einzelprodukte, Ratenprodukte und Zusatzprodukte. Mindestrolle: Administrator oder Finanzen.

Parameter: keine.

Liefert: jedes Produkt mit ID, Titel, Typ, Preis, Intervall, Status (Entwurf oder veröffentlicht) und den Bereichen, die es freischaltet. Die ID brauchen create_plan (in add_on_ids), update_price, publish_product und create_coupon.

Frag so: „Welche Produkte sind noch Entwürfe?"

`list_coupons`

Nur lesen

Gutscheine auflisten. Die Gutscheine mit Status und Nutzung. Mindestrolle: Administrator oder Finanzen.

Parameter	Typ	Pflicht	Beschreibung
`status`	`ACTIVE`, `INACTIVE`, `EXPIRED`	Nein	Nur ein Status
`search`	Text	Nein	Teil des Codes oder Namens
`page`, `limit`	Zahl	Nein	Seitenweise Abfrage

Liefert: die Gutscheine mit Code, Typ, Wert, Dauer, Gültigkeit, Limit und Nutzungen.

Frag so: „Welche Gutscheine sind aktiv, und wie oft wurde jeder genutzt?"

`create_product`

Ändert

Abrechnungsoption oder Produkt anlegen. Legt ein Produkt als Entwurf an: eine Abo-Option, ein Einzelprodukt (Ticket, Kurs) oder ein Ratenprodukt. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`title`	Text, 3 bis 255	Ja
`type`	`SUBSCRIPTION`, `ONE_TIME`, `INSTALLMENT`	Ja	Abo-Option, Einzelprodukt oder Ratenprodukt
`price`	Zahl, in der Währung der Community	Ja	Beim Abo der Betrag pro Zyklus; bei Jährlich in Raten der Jahresbetrag
`interval`	`MONTHLY`, `YEARLY`	Nein	Nur bei `SUBSCRIPTION`: monatlich oder jährlich
`max_installments`	1 bis 12	Nein	Bis zu wie vielen Raten per Karte (Einzelprodukt oder jährlich)
`commitment_months`	1 bis 36	Nein	Vertragslaufzeit; nur monatlich
`trial_days`	0 bis 365	Nein	Kostenloser Testzeitraum
`description`	einfacher Text, bis 5.000	Nein	Ohne Formatierung: Markdown-Zeichen werden entfernt
`space_ids`	Liste von IDs	Nein	Die Bereiche, die der Kauf freischaltet
`stock`	Zahl	Nein	Verkaufsmenge (Tickets). Leer: unbegrenzt
`direct_link`	ja oder nein	Nein	Ein Einzelprodukt, das per Direktlink verkauft wird, außerhalb des Shops

Liefert: das angelegte Produkt als Entwurf, mit ID.

Frag so: „Lege das Produkt Einzel-Mentoring an, R$ 450, in bis zu 3 Raten, das den Bereich Mentorings freischaltet. Lass es als Entwurf."

Hinweise: Nichts wird verkauft, bevor publish_product läuft, und das Anlegen hängt nicht von genehmigten Geschäftsinformationen ab (siehe Entwurf vor der Genehmigung). Für einen Plan mit mehreren Optionen macht create_plan alles auf einmal. Die Regeln jedes Felds sind die des Dashboards: siehe Produkte und Abrechnungsoptionen.

`create_plan`

Ändert

Plan mit Optionen und Zusatzprodukten anlegen. Abrechnungsoptionen → Plan mit den Optionen → verknüpfte Zusatzprodukte. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`name`	Text, bis 120	Ja	Der Name des Plans
`description`	einfacher Text	Nein	Ohne Formatierung: Markdown-Zeichen werden entfernt
`slug`	Text, bis 60	Nein	Die Adresse des Plans, für den Link `/pricing/<adresse>`
`options`	Liste, 1 bis 6	Ja	Die Abrechnungsoptionen (siehe unten)
`add_on_ids`	Liste von IDs	Nein	Bestehende monatliche Produkte, die keine Planoption sind, aus `list_products`
`publish`	ja oder nein	Nein	Veröffentlicht alle Optionen. Standard: Entwurf
`idempotency_key`	Text, bis 100	Nein

Jede Option:

Feld	Typ	Beschreibung
`title`	Text, 3 bis 255	Pflicht. Z. B. Mentoring · Monatlich
`price`	Zahl, in der Währung der Community	Pflicht. Bei jährlich der Jahresbetrag
`interval`	`MONTHLY`, `YEARLY`	Standard: `MONTHLY`
`max_installments`	1 bis 12	Bei jährlich: bis zu wie vielen Raten per Karte
`commitment_months`	1 bis 36	Mindestvertrag, bei monatlich
`trial_days`	0 bis 365	Kostenloser Testzeitraum
`description`	einfacher Text	Ohne Formatierung: Markdown-Zeichen werden entfernt
`space_ids`	Liste von IDs	Die Bereiche, die die Option freischaltet

Liefert: den Plan (ID, Name, Adresse), die Optionen (ID, Titel, Preis, Intervall, Status) und die verknüpften Zusatzprodukte.

Frag so: „Lege den Plan Mentoring an, mit monatlich R$ 390 und 6 Monaten Vertrag und jährlich R$ 3.900 in bis zu 12 Raten, beide schalten den Bereich Mentoring frei, und verknüpfe die Einzelsitzung als Zusatzprodukt."

Hinweise: Schlägt ein Schritt fehl, wird der Plan zuletzt rückgängig gemacht, weil Memberfy keinen Plan löscht, der noch Optionen hat. Siehe Pläne, Zusatzprodukte und Jährlich in Raten.

`publish_product`

Ändert

Produkt veröffentlichen (in den Verkauf). Stellt ein Produkt im Entwurf in den Verkauf. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`product_id`	ID	Ja	Aus `list_products` oder einer Erstellung

Liefert: das Produkt, veröffentlicht.

Frag so: „Du kannst das Produkt Excel von Null veröffentlichen."

Hinweise: Veröffentlichen setzt genehmigte Geschäftsinformationen voraus, und das Produkt in der Währung des genehmigten Landes. Fehlt das, lehnt Memberfy ab, und das Produkt bleibt ein bearbeitbarer Entwurf. Siehe Entwurf vor der Genehmigung.

`unpublish_product`

Ändert

Produkt aus dem Verkauf nehmen. Nimmt ein Produkt aus dem Verkauf. Wer schon gekauft hat, behält den Zugriff. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`product_id`	ID	Ja

Liefert: das Produkt, nicht mehr im Verkauf.

Frag so: „Nimm das Ticket für das Oktober-Treffen aus dem Verkauf."

`update_price`

Mit Bestätigung

Preis eines Produkts ändern. Ändert den Preis eines Produkts oder einer Abrechnungsoption. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`product_id`	ID	Ja	Aus `list_products`
`new_price`	Zahl, in Reais	Ja

Die Zusammenfassung: das Produkt, der aktuelle Preis, der neue Preis und der Status (Entwurf oder veröffentlicht).

Frag so: „Erhöhe Growth Monatlich von R$ 129 auf R$ 149."

Hinweise: Bestehende Abonnements folgen den Regeln von Memberfy für Preisänderungen, denselben wie beim Bearbeiten im Dashboard. Siehe Abrechnungsoptionen.

`create_coupon`

Mit Bestätigung

Gutschein anlegen. Legt einen Rabattgutschein an, prozentual oder als fester Betrag, für alle Produkte oder nur für einige. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`code`	Text, 2 bis 50	Ja	Z. B. `PRO20`. Wird in Großbuchstaben gespeichert
`name`	Text, bis 120	Ja	Der interne Name
`type`	`PERCENTAGE`, `FIXED`	Ja	Prozentual oder fester Betrag
`value`	Zahl	Ja	20 = 20 %, oder der Betrag in Reais
`duration`	`ONCE`, `FOREVER`, `REPEATING`	Nein	Bei Abos: nur die 1. Abbuchung (Standard), immer, oder einige Monate
`months`	1 bis 36	Nein	Mit `REPEATING`
`max_uses`	Zahl	Nein	Leer: unbegrenzt
`start_date`	Datum ISO 8601	Nein	Standard: jetzt
`end_date`	Datum ISO 8601	Nein	Leer: ohne Ende
`product_ids`	Liste von IDs	Nein	Nur diese Produkte. Leer: alle

Die Zusammenfassung: Aktion, Code, Rabatt (20% oder R$ 50,00), Dauer, Nutzungslimit, Gültigkeit und Produkte.

Frag so: „Lege den Gutschein BLACK30 an, 30 % nur auf die erste Abbuchung, für die Growth-Pläne, bis zu 100 Nutzungen, gültig bis 30.11."

Siehe Gutscheine.

`update_plan`

Ändert

Plan bearbeiten. Ändert Name, Beschreibung, Adresse, ob er aktiv ist, die Abrechnungsoptionen und die Zusatzprodukte eines Plans. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link (`/pricing/…`)	Ja
`name`, `description`, `slug`	Text	Nein
`active`	ja oder nein	Nein
`option_ids`	Liste von IDs	Nein	Die vollständige Liste der Optionen des Plans
`add_on_ids`	Liste von IDs	Nein	Die vollständige Liste der Zusatzprodukte

Frag so: „Nimm die Jahresoption aus dem Plan Growth und lass nur die monatliche.“

Hinweise: Ändert sofort, was verkauft wird, ohne Bestätigung. Den Preis änderst du mit update_price, das nach deinem Ja fragt.

`update_product`

Ändert

Produkt bearbeiten. Ändert Titel, Beschreibungen, freigeschaltete Bereiche, Bestand, Raten, Testphase oder Direktlink. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`product`	ID oder Slug	Ja
`title`, `description`, `short_description`	Text	Nein
`space_ids`	Liste von IDs	Nein	Die Bereiche, die der Kauf freischaltet
`stock`	Zahl	Nein
`max_installments`	Zahl	Nein
`trial_days`	Zahl	Nein
`direct_link`	ja oder nein	Nein

Frag so: „Erhöhe den Ticketbestand auf 120.“

Hinweise: Den Preis änderst du mit update_price, das eine Bestätigung braucht.

`update_coupon_status`

Mit Bestätigung

Gutschein pausieren oder reaktivieren. Pausiert einen Gutschein oder aktiviert ihn wieder. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`coupon`	ID oder Code	Ja
`status`	`ACTIVE`, `INACTIVE`	Ja	Reaktivieren oder pausieren

Frag so: „Pausiere den Gutschein BLACK30.“

`update_coupon`

Mit Bestätigung

Gutschein bearbeiten. Ändert einen bestehenden Gutschein. Nur, was gesendet wird, ändert sich; pausieren geht mit update_coupon_status. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`coupon`	ID oder Code	Ja
`name`, `description`	Text	Nein
`value`	Zahl	Nein	Prozentsatz (20 = 20 %) oder Betrag, je nach Typ des Gutscheins
`duration`	`ONCE`, `FOREVER`, `REPEATING`	Nein	Einmal, für immer oder für einige Monate
`months`	1 bis 36	Nein	Mit `REPEATING`
`max_uses`, `max_uses_per_person`	Zahl	Nein	Nutzungslimits
`start_date`, `end_date`	Datum	Nein	Die Gültigkeit
`product_ids`	Liste von IDs	Nein	Die Produkte, für die der Gutschein gilt

Liefert: beim ersten Aufruf den Code und was sich ändert, sowie den Bestätigungscode.

Frag so: „Erhöhe BLACK30 auf 40 % und verlängere ihn bis Sonntag.“

Siehe Gutscheine.

`delete_coupon`

Mit Bestätigung

Gutschein löschen. Bereits gewährte Rabatte gelten weiter. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`coupon`	ID oder Code	Ja

Liefert: beim ersten Aufruf den Code und wie oft er genutzt wurde, sowie den Bestätigungscode.

`get_coupon_usage`

Nur lesen

Nutzung eines Gutscheins ansehen. Wer ihn genutzt hat, wann und mit wie viel Rabatt. Mindestrolle: Administrator oder Finanzen.

Parameter	Typ	Pflicht	Beschreibung
`coupon`	ID oder Code	Ja
`page`	Zahl	Nein

Frag so: „Wer hat den Gutschein BLACK30 genutzt?“

`list_downsell_offers`

Nur lesen

Downsell-Angebote eines Plans. Die Rabattangebote auf Zusatzprodukte nach dem Kauf eines Plans, mit wie oft sie gezeigt und angenommen wurden. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link	Ja

Frag so: „Wie gut konvertiert das Last-Chance-Angebot für die Coworking-Erweiterung?“

`create_downsell_offer`

Mit Bestätigung

Downsell-Angebot anlegen. Legt ein Rabattangebot auf ein Zusatzprodukt an, das nach der Zahlung des Plans angezeigt wird. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link	Ja
`add_on_id`	ID	Ja	Das Zusatzprodukt des Plans
`discount_percent`	Zahl	Nein
`timing`	`IMMEDIATE`, `DELAYED`	Nein	Sofort (Standard) oder nach einer Weile
`delay_minutes`	Zahl	Nein	Mit `DELAYED`
`price_duration`	`FOREVER`, `FIRST_CHARGE`, `CYCLES`	Nein	Rabatt für immer, nur bei der ersten Abbuchung oder für einige Zyklen
`cycles`	Zahl	Nein	Mit `CYCLES`
`ttl_minutes`	Zahl	Nein	Wie lange das Angebot gilt

Frag so: „Biete 30 % auf die Coworking-Erweiterung für alle, die Growth ohne sie abonnieren, für die ersten 3 Abbuchungen.“

Siehe Downsell.

`update_downsell_offer`

Mit Bestätigung

Downsell-Angebot bearbeiten. Ändert ein Last-Chance-Angebot eines Plans oder pausiert es. Nur, was gesendet wird, ändert sich. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link	Ja
`offer_id`	ID	Ja	Aus `list_downsell_offers`
`discount_percent`, `timing`, `delay_minutes`, `price_duration`, `cycles`, `ttl_minutes`		Nein	Dieselben wie bei `create_downsell_offer`
`active`	ja oder nein	Nein	Mit nein wird das Angebot pausiert

Frag so: „Pausiere das Angebot für die Coworking-Erweiterung bis Monatsende.“

`delete_downsell_offer`

Mit Bestätigung

Downsell-Angebot löschen. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link	Ja
`offer_id`	ID	Ja	Aus `list_downsell_offers`

`delete_product`

Mit Bestätigung

Produkt löschen. Löscht ein Produkt oder eine Abrechnungsoption. Wer gekauft hat, behält den Zugriff. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`product`	ID oder Slug	Ja	Aus `list_products`

Liefert: beim ersten Aufruf Titel, Preis und Status sowie den Bestätigungscode.

Hinweise: Um nur den Verkauf zu stoppen, nimm lieber unpublish_product. Siehe Produkte.

`delete_plan`

Mit Bestätigung

Plan löschen. Bestehende Abonnements werden nicht gekündigt. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan`	ID oder Link (`/pricing/…`)	Ja

Liefert: beim ersten Aufruf den Namen des Plans und seine Optionen sowie den Bestätigungscode.

`reorder_plans`

Ändert

Pläne neu ordnen. Bringt die Pläne auf der Preisseite in eine neue Reihenfolge, vom ersten bis zum letzten. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`plan_ids`	Liste von IDs	Ja	Aus `list_plans`, in der neuen Reihenfolge

Frag so: „Setz auf der Preisseite Growth vor Starter.“

`get_storefront`

Nur lesen

Shop ansehen. Was ein Shop-Bereich zeigt: alle Produkte oder nur die ausgewählten. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`space`	ID oder Link	Ja	Der Shop-Bereich

`update_storefront`

Ändert

Produkte des Shops auswählen. Legt fest, was ein Shop-Bereich verkauft. Mindestrolle: Administrator.

Parameter	Typ	Pflicht	Beschreibung
`space`	ID oder Link	Ja
`mode`	`all`, `selected`	Ja	Alle veröffentlichten Produkte, oder nur die ausgewählten
`product_ids`	Liste von IDs	Nein	Mit `selected`, aus `list_products`

Frag so: „Lass im Shop nur die einzelnen Kurse.“

Siehe Shop.

#Entwurf vor der Genehmigung

#Kurz gesagt

#list_plans

#list_products

#list_coupons

#create_product

#create_plan

#publish_product

#unpublish_product

#update_price

#create_coupon

#update_plan

#update_product

#update_coupon_status

#update_coupon

#delete_coupon

#get_coupon_usage

#list_downsell_offers

#create_downsell_offer

#update_downsell_offer

#delete_downsell_offer

#delete_product

#delete_plan

#reorder_plans

#get_storefront

#update_storefront

#Verwandte Artikel

Entwurf vor der Genehmigung

Kurz gesagt

`list_plans`

`list_products`

`list_coupons`

`create_product`

`create_plan`

`publish_product`

`unpublish_product`

`update_price`

`create_coupon`

`update_plan`

`update_product`

`update_coupon_status`

`update_coupon`

`delete_coupon`

`get_coupon_usage`

`list_downsell_offers`

`create_downsell_offer`

`update_downsell_offer`

`delete_downsell_offer`

`delete_product`

`delete_plan`

`reorder_plans`

`get_storefront`

`update_storefront`

Verwandte Artikel