MemberPress AI Foundation MCP-Tools – Referenz

Der MemberPress AI Foundation MCP-Server stellt einen Katalog von Tools bereit, die ein KI-Client aufruft, um MemberPress-Daten zu lesen und zu verwalten. Jedes Tool verfügt über einen Namen, ein JSON-Eingabeschema sowie Anmerkungen, die es als schreibgeschützt, schreibbar oder destruktiv klassifizieren.

Diese Übersicht listet alle Tools nach Anwendungsbereich geordnet auf und enthält Angaben zu ihrem Zweck, den wichtigsten Parametern, dem erforderlichen Umfang sowie den erforderlichen WordPress-Fähigkeiten. Sie ist die Ergänzung zur Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter, in dem erläutert wird, wie Gültigkeitsbereiche, Berechtigungen und der Bestätigungsablauf durchgesetzt werden.

So funktioniert die Werkzeugliste

Ein Client ruft den Katalog ab, indem er die Funktion Tools/Liste Methode für den MCP-Endpunkt. Zwei Faktoren bestimmen, welche Tools in der Antwort angezeigt werden:

1. Zugriffsebene der Verbindung (Bereichsfilterung). Der Server gibt nur die Werkzeuge zurück, die der Geltungsbereich der Verbindung zulässt. Bei einer schreibgeschützten Verbindung (einschließlich aller Verbindungen mit Anwendungskennwort) werden nur Lese-Werkzeuge angezeigt. Bei einer Verbindung mit Schreibberechtigung werden zusätzlich die Schreib- und Lösch-Werkzeuge angezeigt, die unter ihren Geltungsbereichen fallen. Ein Werkzeug wird außerdem ausgeblendet, wenn dem Token-Besitzer die erforderliche WordPress-Berechtigung fehlt — memberpress_delete_member wird für einen Benutzer ohne delete_users.
2. Aktive Add-ons (Add-on-Gating). Werkzeuge, die zu einem Add-on gehören, werden nur registriert, solange dieses Add-on aktiv ist. Eine Website ohne „MemberPress Courses“ stellt beispielsweise die Kurswerkzeuge nicht zur Verfügung.

Aufgrund dieser beiden Faktoren variiert die Anzahl der Tools, die eine Website bereitstellt. Der Katalog wächst mit jedem Add-on:

Anmeldung	Authentifizierte Werkzeuge	Öffentliche Tools
Kern (ohne Erweiterungen)	41	2
+ MemberPress-Kurse	+8	+2
+ Firmenkonten	+3	—
+ Downloads	+2	—
Alles aktiv	54 (39 Lesevorgänge, 9 nicht-destruktive Schreibvorgänge, 6 destruktive Schreibvorgänge)	4

Anmerkung: Die Anzahl der Tools, die für eine bestimmte Verbindung angezeigt wird, ist keine feste Zahl. Sie spiegelt die Zugriffsebene dieser Verbindung sowie die aktiven Add-ons der Website wider. Eine geringere Anzahl ist normal und kein Anzeichen für eine fehlerhafte Installation.

Werkzeugklassifizierungen

Jedes Werkzeug ist mit Anmerkungen versehen, die es klassifizieren:

Klassifizierung	Anmerkung	Verhalten
Lesen Sie	readOnlyHint: true	Ruft Daten ab. Ändert niemals den Status. Für jede Verbindung verfügbar.
Zerstörungsfreies Schreiben	readOnlyHint: false, destructiveHint: false	Erstellt oder aktualisiert. Standardmäßig wird eine Vorschau angezeigt; übergebe ausführen: true um live zu gehen.
Zerstörerisch	readOnlyHint: false, destructiveHint: true	Löscht, erstattet, storniert oder setzt zurück. Erfordert den zweistufigen Bestätigungs-Token-Ablauf.

Die Mechanismen für das Schreiben und die destruktive Ausführung sind in der Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter. Diese Übersicht konzentriert sich darauf, was die einzelnen Werkzeuge sind und welche Eingaben sie akzeptieren.

Format der Tool-Antwort

Ein Client führt ein Tool mit dem tools/call Methode. Das Ergebnis wird im Standard-MCP-Umschlag zurückgegeben: ein result.content Ein Array, dessen erstes Element ein Textblock ist. Dieser Block Text Das Feld enthält die Daten des Werkzeugs als JSON-Zeichenkette die der Client auswerten muss. Dies unterscheidet sich von der Tools/Liste Form, die Werkzeugdefinitionen direkt zurückgibt.

Der Umschlag von einem Mitgliederliste_Mitglieder Aufruf:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
 { "type": "text", "text": "{ ...escaped JSON string... }" }
    ]
  }
}

Das Parsen des Text Die Zeichenkette liefert die Nutzlast – eine Mitglieder Array mit gleichrangigen Paginierungsfeldern:

{
  "mitglieder": [
    {
 "id": 50,
 "E-Mail": "member@example.com",
 "Benutzername": "member50",
      "Vorname": "Beispiel",
 "Nachname": "Mitglied",
 "registriert_am": "21.08.2023 17:18:31",
      "active_memberships": [ { "id": 2332, "title": "Basis-Mitgliedschaft" } ]
    }
  ],
  "total": 8,
  "page": 1,
  "per_page": 3,
  "pages": 3
}

Paginierungsfelder (insgesamt, Seite, pro_Seite, Seiten) befinden sich neben dem Datenarray und nicht innerhalb eines Wrapper-Objekts.

Anmerkung: memberpress_smart_query ist ein Tool zum Abrufen von Kontextinformationen und kein Tool zur Beantwortung von Fragen. Es liefert strukturierte Website-Kontextdaten – Zahlen, Produkte, aktuelle Umsätze – als Grundlage für die Schlussfolgerungen des aufrufenden KI-Clients, nicht jedoch eine schriftliche Antwort. Die Form seiner Nutzdaten ist { "question": "...", "context": { ... } }.

Tools lesen

Lese-Tools rufen Daten ab und ändern niemals den Status. Sie stehen bei jeder Verbindung zur Verfügung, auch bei Verbindungen mit schreibgeschütztem Anwendungskennwort. Alle Lese-Tools verfügen über readOnlyHint: true, destructiveHint: false, idempotentHint: true, und erfordern lediglich die lesen Geltungsbereich (wird immer gewährt).

Parameter, dargestellt als erforderlich müssen angegeben werden. Listen-Tools weisen ein einheitliches Paginierungsmuster auf: Seite (Standardwert 1) und pro_Seite (Standardwert 20, Maximalwert 100).

Mitglieder

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_member	Alle Details zu einem Mitglied, einschließlich aktiver Abonnements und verfügbarer Mitgliedschaften.	Bezeichner (Mitgliedsnummer oder E-Mail-Adresse); include_transactions (bool, Standardwert: false)
Mitgliederliste_Mitglieder	Liste der Mitglieder mit Filterfunktion. Paginiert.	Suche, Status (aktiv/inaktiv/alle), mitgliedschaft_id, Seite, pro_Seite
memberpress_export_members	Mitglieder als paginiertes JSON-Array exportieren.	mitgliedschaft_id, Status, date_from, date_to, Seite, pro_Seite (Standardwert: 50)

Mitgliedschaften

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_membership	Alle Details zu einer Mitgliedschaft/einem Produkt: Preise, Testphase, Gruppen, Zugangsregeln, Mitgliederzahl.	mitgliedschaft_id
memberpress_list_memberships	Mitgliedschaften/Produkte mit Statusfilter auflisten. Paginiert.	Status (veröffentlicht/Entwurf/alle), Seite, pro_Seite
memberpress_get_membership_stats	Statistiken zu allen Mitgliedschaften: aktive Abonnenten, Gesamtumsatz, durchschnittlicher Umsatz pro Mitglied.	(keine)

Abonnements

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_subscription	Vollständige Abonnementdetails: Benutzer, Produkt, Teststatus, Transaktionsverlauf.	subscription_id
Mitgliederliste_Abonnements	Abonnements mit Filterfunktion auflisten. Paginiert.	Mitglieds-ID, mitgliedschaft_id, Status (ausstehend/aktiv/ausgesetzt/abgebrochen/alle), date_from, date_to, Seite, pro_Seite

Transaktionen

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_transaction	Vollständige Transaktionsdetails: Benutzer, Produkt, Abonnement, Finanzdaten.	transaktions_id
memberpress_list_transactions	Transaktionen mit Filterfunktion auflisten. Paginiert.	Mitglieds-ID, mitgliedschaft_id, subscription_id, Status (ausstehend/abgeschlossen/fehlgeschlagen/erstattet/alle), date_from, date_to, Seite, pro_Seite

Regeln und Zugang

Werkzeug	Zweck	Wichtige Parameter
memberpress_list_rules	Zugriffsregeln mit Filterung auflisten. Paginiert.	mitgliedschaft_id, Regel_Art, Seite, pro_Seite
memberpress_get_protected_content	Alle Regeln für geschützte Inhalte und die Frage, ob ein Mitglied Zugriff auf die einzelnen Inhalte hat.	Mitglieds-ID
memberpress_list_protected_urls	Auflistung der Regeln zum Schutz von Inhalten mit den geschützten Inhalten und den erforderlichen Mitgliedschaften. Paginiert.	Seite, pro_Seite
memberpress_check_access	Ob ein Benutzer Zugriff auf einen bestimmten Beitrag/eine bestimmte Seite hat.	Benutzer_id, post_id

Gutscheine

Werkzeug	Zweck	Wichtige Parameter
Mitgliederpresse_Liste_Gutscheine	Gutscheine mit Statusfilter, Rabattdetails und Nutzungsstatistiken auflisten. Paginiert.	Status (aktiv/abgelaufen/alle), Seite, pro_Seite

Berichte und Analysen

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_revenue_report	Umsatz für einen bestimmten Zeitraum, aufgeschlüsselt nach Perioden.	date_from, date_to, Zeitraum (täglich/wöchentlich/monatlich/jährlich), mitgliedschaft_id
memberpress_get_churn_report	Gekündigte/ausgesetzte/neue Abonnements und Abwanderungsrate für einen bestimmten Zeitraum.	date_from, date_to, mitgliedschaft_id
memberpress_umsatzanalyse	Transaktionssummen, Umsatz nach Produkten, monatliche Trends.	date_from, date_to, Mitglieds-IDs (Array)
memberpress_churn_prediction	Abonnementstatus, Kündigungsraten, durchschnittliche Zeit bis zur Kündigung, Abwanderungsrate nach Produkt.	mitgliedschaft_id
memberpress_Kohortenanalyse	Nach Monaten gruppierte Neuanmeldungen mit Kundenbindung, Kündigungen und Umsatz pro Kohorte.	date_from, date_to
memberpress_ltv_analyse	Umsatz pro Abonnement und Laufzeit, nach Produkten gruppiert, zur Schätzung des LTV.	mitgliedschaft_id
memberpress_member_engagement	Transaktionshäufigkeit, Verteilung des Abonnementstatus, Aktivitätsmuster.	mitgliedschaft_id, Tage (max. 365, Standardwert 90)
memberpress_verlängerungsprognose	Anstehende Ablauftermine in 30-Tage-Intervallen mit historischen Verlängerungsquoten.	mitgliedschaft_id
memberpress_failed_payment_analysis	Fehlgeschlagene und erstattete Transaktionen nach Produkt, Monat und Zahlungsgateway im Vergleich zum Volumen der erfolgreichen Transaktionen.	date_from, date_to
memberpress_content_performance	Anzahl der geschützten Inhalte, Verhältnis von Mitgliedern zu Inhalten, Abwanderungsrate pro Mitgliedschaft.	date_from, date_to
memberpress_smart_query	Kontextdaten der Website zur Beantwortung einer in natürlicher Sprache formulierten Frage zu Mitgliederdaten.	Frage

Wenn date_from / date_to werden weggelassen, greifen die Analysetools auf einen Standardzeitraum zurück, anstatt die Angabe expliziter Datumsangaben zu erfordern.

System

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_system_info	Diagnose: PHP-/WordPress-/MemberPress-Versionen, aktive Add-ons, Namen der Zahlungsgateways, Status der Datenbanktabellen, Anzahl.	(keine)
memberpress_list_webhooks	Liste der konfigurierten Webhooks mit URLs, Ereignissen und Aktivierungsstatus.	(keine)
Mitgliederpresse_Liste_Erinnerungen	Liste der konfigurierten E-Mail-Erinnerungen mit auslösenden Ereignissen, Zeitpunkten, Status und Mitgliedschaften.	(keine)

Kurse (erfordert MemberPress-Kurse)

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_course	Kursdetails: Gruppen, Lektionen, Mitgliedschaften, Abschlussquote.	kurs_id
memberpress_list_courses	Kurse mit Filterfunktion auflisten. Paginiert.	Suche, Status (veröffentlicht/Entwurf/alle), Seite, pro_Seite
memberpress_get_lesson	Details zur Unterrichtseinheit: Kursgruppe, übergeordneter Kurs, Verfügbarkeit.	lektion_id
memberpress_list_lessons	Lektionen nach Kurs oder Abschnitt gefiltert auflisten. Paginiert.	kurs_id, section_id, Seite, pro_Seite
memberpress_get_student_progress	Der Fortschritt eines Teilnehmers pro Unterrichtseinheit in einem Kurs.	Benutzer_id, kurs_id
Mitgliederliste_Kurs_Studierende	Studierende, die in einem Kurs mit dem Status „abgeschlossen“ eingeschrieben sind. Mit Seitenangaben.	kurs_id, Seite, pro_Seite

Firmenkonten (erfordert MemberPress-Firmenkonten)

Werkzeug	Zweck	Wichtige Parameter
memberpress_get_corporate_account	Firmenkonto nach Benutzer-ID des Inhabers: Nutzung und Liste der Unterkonten.	Benutzer_id
memberpress_list_sub_accounts	Unterkonten eines Firmenkontos. Paginiert.	Unternehmenskonto-ID, Seite, pro_Seite

Downloads (erfordert MemberPress Downloads)

Werkzeug	Zweck	Wichtige Parameter
Mitgliederliste_Downloads	Liste der herunterladbaren Dateien mit Filteroptionen: Titel, Dateiname, Anzahl der Downloads, Mitgliedschaften. Mit Seitenaufteilung.	mitgliedschaft_id, Seite, pro_Seite
memberpress_get_download_stats	Statistiken zu einem Download: Anzahl, Dateiinformationen, Mitgliedschaften, Dateigröße.	Datei-ID

Schreibwerkzeuge (nicht-destruktiv)

Nicht-destruktive Schreibwerkzeuge erstellen oder aktualisieren Daten. Jedes davon ist standardmäßig auf ein Vorschau: Wenn man die Funktion aufruft, wird zurückgegeben, was *eigentlich* passieren würde, ohne dass etwas geändert wird. Um sie live auszuführen, übergebe ausführen: true. Jede davon erfordert einen bestimmten Schreibbereich und eine WordPress-Berechtigung. Die Bereichsprüfung wird zuerst ausgeführt und lehnt den Zugriff mit SCOPE_INSUFFICIENT; das Capability Gate lehnt dies dann mit folgender Meldung ab: FÄHIGKEIT_UNZUREICHEND.

Diese Tools stehen bei schreibgeschützten Verbindungen (einschließlich Verbindungen mit Anwendungskennwort) nicht zur Verfügung. Einer Verbindung muss über den Assistenten der entsprechende Schreibbereich auf der Ebene „Vollzugriff“ zugewiesen werden.

Einige Parameter sind in der nachstehenden Übersicht dokumentiert; für die vollständigen Eingabeschemata aller Schreibwerkzeuge ist weiterhin eine Live-Erfassung mit Vollzugriff oder eine Vorschau für jedes einzelne Werkzeug erforderlich (über die schreibgeschützte Erfassungsverbindung konnten die Schemata der Schreibwerkzeuge nicht aufgelistet werden).

Werkzeug	Zweck	Umfang	Fähigkeit
memberpress_create_member	Ein Mitglied anlegen.	Schreibe: Mitglieder	Benutzer anlegen
memberpress_update_member	Ein Mitglied aktualisieren. Es werden nur die Felder geändert, die der Aufrufer übermittelt; nicht angegebene Felder bleiben unverändert.	Schreibe: Mitglieder	Benutzer bearbeiten
memberpress_create_coupon	Erstellen Sie einen Gutschein.	write:content	manage_options
memberpress_create_subscription	Ein bestehendes Mitglied in eine Mitgliedschaft aufnehmen.	Schreibe: Mitglieder	Benutzer bearbeiten
memberpress_create_rule	Erstellen Sie eine Zugriffsregel.	write:content	manage_options
memberpress_create_webhook	Erstellen Sie einen Webhook.	Schreiben: Webhooks	manage_options
memberpress_import_members	Mitglieder im Massenimport.	write:imports	Benutzer anlegen
memberpress_complete_lesson	Eine Lektion für einen Schüler als abgeschlossen markieren.	Schreiben: Kurse	Benutzer bearbeiten
memberpress_toggle_reminder	E-Mail-Erinnerung aktivieren/deaktivieren.	Schreiben: Webhooks	manage_options

Zerstörungswerkzeuge

Destruktive Werkzeuge löschen, erstatten, stornieren oder setzen Daten zurück. Sie bewirken destructiveHint: true und kann nicht mit einem einfachen Parameter ausgeführt werden. Für jede ist die Zweistufiger Ablauf der Bestätigungstoken-Generierung: Der erste Aufruf gibt eine Vorschau sowie einen einmalig verwendbaren Bestätigungs-Token; ein zweiter Aufruf, der Bestätigen: "" Mit identischen Argumenten wird der Vorgang in Echtzeit ausgeführt. Die Tokens verfallen nach 60 Sekunden, sind nur einmal verwendbar und an das jeweilige Tool, die jeweiligen Argumente und den jeweiligen Benutzer gebunden.

Reversible Aktionen sind vom Bestätigungsschritt ausgenommen. Zwei Aktionswerte, die eine Aktion rückgängig machen, anstatt sie zu löschen, und ohne Token ausgeführt werden: memberpress_manage_subscription mit Aktion: "Fortsetzen"und memberpress_manage_sub_account mit Aktion: "Hinzufügen". Jede weitere Aktion mit diesen Werkzeugen – und jeder Aufruf der anderen vier destruktiven Werkzeuge – erfordert den Token-Flow.

Auch destruktive Werkzeuge unterliegen dem Kill-Switch: Wenn destruktive Schreibvorgänge angehalten werden, wird jedes destruktive Werkzeug mit folgender Meldung abgelehnt: WRITES_PAUSED, unabhängig vom Geltungsbereich oder einem gültigen Token. Siehe die Leitfaden zu Sicherheitsmaßnahmen für Mitarbeiter.

Die dokumentierten Parameter sind im nächsten Abschnitt aufgeführt; für vollständige Eingabeschemata ist weiterhin eine Live-Erfassung mit Vollzugriff oder eine Vorschau für das jeweilige Tool erforderlich.

Werkzeug	Zweck	Umfang	Fähigkeit
memberpress_delete_member	Ein Mitglied löschen (Aufrufe wp_delete_user; MemberPress führt eine Kaskadenlöschung von Zeilen, Transaktionen, Abonnements und Ereignissen durch. Das Löschen des aufrufenden Benutzers oder eines Benutzers mit Administratorrechten wird verweigert.	Schreibe: Mitglieder	delete_users — als explizites Gate auf Werkzeugebene deklariert; das Werkzeug wird vor Tools/Liste für Nutzer, die diese Funktion nicht haben
memberpress_delete_webhook	Einen Webhook löschen.	Schreiben: Webhooks	manage_options
memberpress_manage_subscription	Ein Abonnement kündigen, aussetzen oder wieder aufnehmen.	Schreiben: Rechnungsstellung	manage_options
memberpress_refund_transaction	Eine Transaktion rückerstatten.	Schreiben: Rechnungsstellung	manage_options
memberpress_manage_sub_account	Ein Unternehmensunterkonto verwalten.	Schreibe: Mitglieder	manage_options
memberpress_reset_course_progress	Den Kursfortschritt eines Teilnehmers zurücksetzen.	Schreiben: Kurse	Benutzer bearbeiten

Dokumentierte Parameter und Verhalten

Die folgenden Angaben zu Parametern und Verhaltensweisen stammen aus dem Code-Inventar und aus technischen Bestätigungen. Sie stellen kein vollständiges Schema für jedes Tool dar; die übrigen Parameter werden durch eine Vorschau für das jeweilige Tool bestätigt.

• memberpress_create_coupon — rabatt_type ∈ {Prozent, Dollar}, discount_mode ∈ {Standard, erste Zahlung} (Standard Standard), sowie rabatt_betrag und ein optionales Mitglieds-IDs array (schränkt den Gutschein auf bestimmte Produkte ein). Alte Werte (flach, erste, alle) werden kategorisch abgelehnt. Übernimmt ausführen.
• memberpress_create_subscription — meldet ein *bestehendes* Mitglied für eine Mitgliedschaft an (Mitglied + Produkt erforderlich); verhindert doppelte Anmeldungen; verwendet immer gateway='manual' (vom Administrator gewährter Zugriff, kein Abrechnungsvorgang); Zweige zu einmaligen bzw. wiederkehrenden Produkten. Enthält ausführen.
• memberpress_import_members — akzeptiert eine oberste Ebene Willkommens-E-Mail senden bool (Standardwert falsch); die WordPress-Begrüßungs-E-Mail wird nach der Einrichtung einmal pro neu angelegtem Mitglied versendet. Bereits vorhandene Benutzer, deren E-Mail-Adresse übereinstimmt, werden nicht neu angelegt. Enthält ausführen.
• memberpress_delete_member — Mitglieds-ID; Anrufe wp_delete_user, wobei MemberPress's gelöschter_Benutzer Hook „cascade-clean“ für zugehörige Zeilen. Nur für den Confirmation-Token-Ablauf.
• memberpress_manage_subscription — ein Aktionsauswahlfeld für „Abbrechen“, „Unterbrechen“ und „Fortsetzen“; Lebenslauf ist eine nicht-destruktive Variante, bei der das destruktive Gate übersprungen wird. Ablauf der Bestätigungs-Token bei destruktiven Aktionen.
• memberpress_manage_sub_account — ein Aktionsselektor; hinzufügen. ist eine nicht-destruktive Variante, bei der das destruktive Gatter übersprungen wird.
• memberpress_refund_transaction — transaktions_id erforderlich; optional Abonnement kündigen bool. Nebenwirkung der Antwort: wenn die Transaktion mit einem Abonnement verknüpft ist UND Abonnement kündigen *nicht* übergeben wurde, fügt die Antwort (Vorschau und Live) hinzu subscription_listing_may_show_inactive: true und eine Hinweis zum Abonnementangebot. Diese Markierung und dieser Hinweis beziehen sich auf nur, wie der Status in der Abonnementliste des WP-Admins angezeigt wird — diese Spalte leitet sich aus dem Status der letzten Transaktion ab, nicht aus dem Abonnementdatensatz — und werden übersprungen, wenn cancel_subscription: true. Das Flag beschreibt das Zugriffsverhalten nicht: Die Rückerstattung der letzten Transaktion, die ein Abonnement abdeckt, beendet den Zugriff des Mitglieds für diesen Zeitraum. Diese Antwortform muss in jedem Beispiel für eine Rückerstattung vorkommen. Nur im Ablauf mit Bestätigungstoken.

Öffentliche Tools

Der nicht authentifizierte öffentliche Endpunkt (/wp-json/mp-mcp/v1/public-mcp) stellt eine separate, sorgfältig zusammengestellte Auswahl an 4 schreibgeschützte Tools zur Verwendung ohne Token. Sie geben ausschließlich öffentliche Katalogdaten zurück – Preise und Anmeldelinks – und niemals Mitglieder-, Transaktions- oder Administratordaten. Alle vier sind memberpress_- mit Präfix und Carry readOnlyHint: true.

Diese vier Namen sind zwar auch in der authentifizierten Leseoberfläche vorhanden, doch unterscheiden sich die öffentlichen Versionen davon: Sie weisen einfachere Schemata, spezifische Beschreibungen für den öffentlichen Bereich sowie Ergebnisse auf, die auf Einträge beschränkt sind, die für den öffentlichen Katalog freigegeben wurden.

Werkzeug	Zweck	Wichtige Parameter
memberpress_list_memberships	Listen Sie öffentlich zugängliche Mitgliedschaftsangebote mit Preisen und Anmelde-URLs auf.	(keine)
memberpress_get_membership	Details zu einem öffentlichen Mitgliedschaftsangebot: Preise, Informationen zur Testphase, Anmelde-URL.	mitgliedschaft_id
memberpress_list_courses	Liste der öffentlich zugänglichen Kurse.	(keine)
memberpress_get_course	Angaben zu einem öffentlichen Kurs: Überblick und Anzahl der Unterrichtseinheiten.	kurs_id

Der öffentliche Katalog wird auf zwei Ebenen verwaltet: Ein Administrator aktiviert ihn global (MCP-Einstellungen → “Öffentlichen KI-Katalog-Endpunkt aktivieren”, Standard aus), und jede Mitgliedschaft oder jeder Kurs kann einzeln ausgeschlossen werden, indem man das Häkchen entfernt “Im öffentlichen KI-Katalog anzeigen” auf dem Bearbeitungsbildschirm. A get_membership/get_course Eine Abfrage nach einem Titel, der nicht im öffentlichen Katalog enthalten ist, liefert keine Ergebnisse.

Anmerkung: Wenn der öffentliche Katalog deaktiviert ist (Standardeinstellung), wird die Endpunkt-Route nicht eingebunden, sodass jede Anfrage Folgendes zurückgibt: HTTP 404 rest_no_route — Die Existenz des Endpunkts wird nicht offenbart. Der /.well-known/mcp.json Das Discovery-Dokument verhält sich genauso.

Add-On-Gating

Add-on-Tools werden nur registriert, solange ihr Add-on aktiv ist; dies wird durch eine Überprüfung der Hauptklasse des Add-ons festgestellt:

Add-on	Erkennungsklasse	Werkzeuge
Kurse	memberpress\courses\models\Course	Tools für Kurse/Unterrichtsstunden
Firmenkonten	MPCA_Firmenkonto	Unternehmens-Tools
Herunterladen	memberpress\downloads\models\Datei	Tools herunterladen

Eine Website, auf der ein Add-on fehlt, stellt ihre Tools einfach nicht zur Verfügung – beim Aufruf eines nicht registrierten Tools wird der Standard-JSON-RPC-Fehler „unknown-method“ zurückgegeben.

Anmerkung: MemberPress Gifting ist nicht Integriert in AI Foundation – es werden keine Geschenk-Tools registriert, unabhängig davon, ob das Add-on „Gifting“ aktiv ist. Die Unterstützung für Geschenke ist für eine zukünftige Version geplant.

Geltungsbereich – Referenz

Der Assistent stellt Verbindungen mit einem oder mehreren Zugriffsbereichen her. Lesezugriff wird immer gewährt; Schreibzugriff wird nur auf der Stufe „Vollzugriff“ gewährt.

Zuordnung der Kontrollkästchen im „Access-Schritt“ des Assistenten Eins-zu-Eins für diese Gültigkeitsbereiche – der Wert jedes Kontrollkästchens ist die interne Gültigkeitsbereichszeichenfolge, die unverändert im Token gespeichert wird:

Zauberer-Eimer	Gültigkeitsbereich festgelegt
Alles lesen	lesen (wird immer gewährt)
Inhalt bearbeiten	write:content
Mitglieder verwalten	Schreibe: Mitglieder
Abrechnungsvorgänge	Schreiben: Rechnungsstellung
Massenimporte	write:imports
Webhooks verwalten	Schreiben: Webhooks
Kursfortschritt	Schreiben: Kurse

Es gibt keinen separaten Anwendungsbereich für Gutscheine, Erinnerungen oder Unternehmensabläufe – Gutscheine werden in write:content, E-Mail-Erinnerungen an Schreiben: Webhooks, und Unternehmensunterkonten in Schreibe: Mitglieder.

Umfang	Zuschüsse
lesen	Alle Lesezugriffsrechte. Immer gewährt.
Schreibe: Mitglieder	Werkzeuge zum Anlegen, Aktualisieren und Löschen von Mitgliedern.
Schreiben: Rechnungsstellung	Tools zur Abonnementverwaltung und zur Rückerstattung von Transaktionen.
write:content	Tools für Zugriffsregeln und Gutscheine.
Schreiben: Webhooks	Tools zum Erstellen und Löschen von Webhooks sowie E-Mail-Erinnerungen.
write:imports	Tool zum Importieren von Mitgliedern.
Schreiben: Kurse	Tools zum Kursfortschritt. Wird im Assistenten nur angezeigt, wenn „Kurse“ aktiv ist.
vollständig	Altes Metaskop. Erfüllt jede schreiben:* Anfrage. Aus Gründen der Abwärtskompatibilität beibehalten.

Funktionsübersicht

Abgesehen vom Geltungsbereich erzwingt jedes Schreib-Tool die WordPress-Berechtigung des Token-Besitzers. Ein Token mit dem richtigen Geltungsbereich, dessen Besitzer jedoch nicht über die entsprechende Berechtigung verfügt, wird mit folgender Meldung abgelehnt: FÄHIGKEIT_UNZUREICHEND.

Fähigkeit	Werkzeuge
Benutzer anlegen	create_member, import_members
Benutzer bearbeiten	update_member, create_subscription, Lektion abschließen, Kursfortschritt zurücksetzen
delete_users	delete_member — explizites Gate auf Werkzeugebene; ausgeblendet von Tools/Liste ohne es
manage_options	Abonnement verwalten, Rückerstattungstransaktion, create_rule, Gutschein erstellen, create_webhook, delete_webhook, toggle_reminder, Unterkonto verwalten

Zugehörige Dokumentation

• MemberPress AI Foundation – Überblick und Einrichtungsanleitung — was die AI Foundation bietet und wie man sie installiert;
• Anbindung von KI-Clients an MemberPress – Entwicklerhandbuch — Authentifizierung und Einrichtung pro Client;
• MemberPress AI Foundation – Sicherheitsmaßnahmen für Agenten — Anwendungsbereiche, die Zugriffsgrenze, Bestätigungs-Token und der Kill-Switch;
• MemberPress MCP-Fehler und Fehlerbehebung — Fehlercodes, darunter FÄHIGKEIT_UNZUREICHEND und WRITES_PAUSED.