WordPress.com MCP-Tools-Referenz
Dieser Text wurde mithilfe von KI übersetzt. Wenn du den Originaltext auf Englisch lesen möchtest, klicke hier.
Dieses Dokument bietet eine umfassende Übersicht der MCP-Tools, die WordPress.com-Entwicklern zur Verfügung stehen. Es handelt sich um ein lebendes Dokument, das aktualisiert wird, sobald neue Tools hinzugefügt oder bestehende geändert werden.
Für exakte Eingabe- und Ausgabe-Schemas rufe das Tool selbst auf – jede STRAP-Fassade stellt action: list (Operationskatalog) und action: describe (vollständiges JSON Schema pro Operation) bereit. Schemas entwickeln sich weiter, daher solltest du die Live-Antwort von describe stets als maßgebliche Quelle betrachten.
Wie WordPress.com-MCP-Tools organisiert sind
Der WordPress.com-MCP-Server stellt zwei Arten von Tools bereit:
- STRAP-Fassaden-Tools — Ein einzelnes MCP-Tool, das eine Familie verwandter Operationen hinter einem einzigen Einstiegspunkt bündelt. Fassaden verwenden eine einheitliche aktionsbasierte Schnittstelle (
action: list | describe | execute), sodass KI-Agenten verfügbare Operationen entdecken, Parameter-Schemas abrufen und Operationen über ein einziges Tool ausführen können. Dadurch bleibt der Tool-Katalog klein und vorhersehbar. - Eigenständige Tools — Einzelzweck-Tools, die Parameter direkt entgegennehmen. Sie werden für Operationen verwendet, die nicht in eine größere Familie passen (z. B. Auflisten der Websites des Benutzers, Generieren einer Checkout-URL).
⚠️ Sicherheitsprotokoll: Alle Schreib-, Aktualisierungs- und Löschoperationen erfordern eine Benutzerbestätigung. Der Agent muss (1) genau beschreiben, was er vorhat, (2) den Benutzer um ausdrückliche Bestätigung bitten und (3) die Bestätigung des Benutzers als user_confirmed: true in den params der Ausführung übergeben. Schreiboperationen werden niemals automatisch ausgeführt. Permanente Löschungen (Taxonomie-Begriffe) erfordern zusätzlich confirm_permanent_delete: true.
Aktionsbasierte Schnittstelle (STRAP-Fassaden)
Jedes STRAP-Fassaden-Tool akzeptiert dieselben drei übergeordneten Eingaben:
action(enum:list/describe/execute): Was der Agent tun möchte.list— Verfügbare Operationen dieses Tools entdecken. Gibt Operationsnamen, Kurzbeschreibungen und Gründe für deaktivierte Operationen zurück.describe— Das vollständige JSON Schema (Parameter, Typen, Pflichtfelder) für eine Operation abrufen.execute— Eine Operation ausführen.operation: Der Operationsname im Formatresource.action(z. B.posts.create,theme.presets).params: Operationsspezifische Parameter. Schreiboperationen müssenuser_confirmed: trueenthalten.
Die meisten Fassaden erfordern auch wpcom_site (eine Website-ID oder URL). Die Fassade wpcom-mcp-account ist die Ausnahme – sie arbeitet mit dem authentifizierten Benutzer.
Alle Operationen unterstützen einen optionalen Parameter include_fields, um die zurückgegebenen Felder einzuschränken. Verwende ihn, um Antworten kontexteffizient zu halten.
STRAP-Fassaden-Tools
Content Authoring ( wpcom-mcp-content-authoring )
Erstelle, lese, aktualisiere und lösche Inhalte auf einer WordPress.com-Website – Beiträge, Seiten, Kommentare, Medien, Kategorien, Schlagwörter, Block-Vorlagen und Inhaltssuche.
💡 Empfohlene Reihenfolge: Rufe zuerst wpcom-mcp-site-editor-context auf (theme.active, theme.presets), damit Inhalte theme-konforme Preset-Slugs verwenden (z. B. "primary", "large") anstelle von fest codierten Farben und Größen.
Verfügbare Operationen
| Operation | Beschreibung |
|---|---|
posts.list | Beiträge mit optionalen Filtern auflisten (Status, Autor, Suche, Taxonomie, Datumsbereich, Sortierung, Paginierung). |
posts.get | Einen einzelnen Beitrag nach ID oder Slug abrufen. Fällt auf die Suche nach Seiten zurück, wenn ein Slug keinem Beitrag entspricht. |
posts.create | Einen neuen Beitrag erstellen – wird standardmäßig als Entwurf erstellt. Schreibzugriff. |
posts.update | Einen bestehenden Beitrag aktualisieren. Nur die angegebenen Felder werden geändert. Wenn der Status publish ist, gehen Änderungen sofort live. Schreibzugriff. |
posts.delete | Einen Beitrag in den Papierkorb verschieben. Innerhalb von 30 Tagen über die WordPress-Verwaltung wiederherstellbar. Schreibzugriff. |
pages.list | Seiten mit optionalen Filtern auflisten (übergeordnete Seite, Status, Suche, Sortierung, Paginierung). |
pages.get | Eine einzelne Seite nach ID oder Slug abrufen. |
pages.create | Eine neue Seite erstellen – wird standardmäßig als Entwurf erstellt. Unterstützt hierarchische Strukturen und Seitenvorlagen. Schreibzugriff. |
pages.update | Eine bestehende Seite aktualisieren. Nur die angegebenen Felder werden geändert. Wenn der Status publish ist, gehen Änderungen sofort live. Schreibzugriff. |
pages.delete | Eine Seite in den Papierkorb verschieben. Innerhalb von 30 Tagen über die WordPress-Verwaltung wiederherstellbar. Schreibzugriff. |
comments.list | Kommentare mit optionalen Filtern auflisten (Status, Beitrag, Autor, Suche, Datumsbereich, Paginierung). |
comments.get | Einen einzelnen Kommentar nach ID abrufen. |
comments.create | Einen Kommentar zu einem Beitrag erstellen. Kommentare von authentifizierten Benutzern füllen die Autorenfelder automatisch aus. Schreibzugriff. |
comments.update | Einen bestehenden Kommentar aktualisieren. Wenn der Status approved ist, sind Änderungen sofort sichtbar. Schreibzugriff. |
comments.delete | Einen Kommentar in den Papierkorb verschieben. Schreibzugriff. |
media.list | Medienelemente mit optionalen Filtern auflisten (MIME-Typ, Beitrag, Autor, Suche, Datumsbereich, Paginierung). |
media.get | Ein einzelnes Medienelement nach ID abrufen. |
media.create | Ein neues Medienelement hochladen (Bild, Video, Audio, Dokument). Schreibzugriff. |
media.update | Metadaten eines Medienelements aktualisieren (nicht die Datei). Änderungen an alt_text und caption werden sofort überall aktualisiert, wo das Medienelement verwendet wird. Schreibzugriff. |
media.delete | Ein Medienelement in den Papierkorb verschieben. Kann Inhalte beschädigen, die darauf verweisen. Schreibzugriff. |
categories.list | Kategorien mit optionalen Filtern auflisten. |
categories.get | Eine einzelne Kategorie nach ID abrufen. |
categories.create | Eine neue Kategorie erstellen. Unterstützt hierarchische Eltern-Kind-Beziehungen. Schreibzugriff. |
categories.update | Eine bestehende Kategorie aktualisieren. Das Ändern des Slugs wirkt sich sofort auf Archiv-URLs aus und kann Links beschädigen. Schreibzugriff. |
categories.delete | Eine Kategorie dauerhaft löschen – Taxonomie-Begriffe haben keinen Papierkorb. Zugewiesene Beiträge werden nach „Allgemein“ verschoben; untergeordnete Kategorien werden zu Kategorien der obersten Ebene. Erfordert confirm_permanent_delete: true. |
tags.list | Schlagwörter mit optionalen Filtern auflisten. Die Schlagwortsuche unterscheidet nicht zwischen Groß- und Kleinschreibung. |
tags.get | Ein einzelnes Schlagwort nach ID abrufen. |
tags.create | Ein neues Schlagwort erstellen. Schreibzugriff. |
tags.update | Ein bestehendes Schlagwort aktualisieren. Das Ändern des Slugs wirkt sich sofort auf Archiv-URLs aus. Schreibzugriff. |
tags.delete | Ein Schlagwort dauerhaft löschen – wird von allen zugehörigen Beiträgen entfernt. Erfordert confirm_permanent_delete: true. |
patterns.list | Auf der Website verfügbare Block-Vorlagen auflisten (Theme, Core, Vorlagenverzeichnis). |
patterns.get | Eine einzelne Block-Vorlage nach Name abrufen, einschließlich ihres Block-Markups. |
synced-patterns.list | Die synchronisierten (wiederverwendbaren) Vorlagen der Website auflisten. |
synced-patterns.get | Eine einzelne synchronisierte Vorlage nach ID abrufen, einschließlich ihres Block-Markups. |
content-search | Freitextsuche über die Inhalte der Website (Beiträge, Seiten, andere Inhaltstypen). |
⚠️ Destruktive Operationen (posts.delete, pages.delete, comments.delete, media.delete, categories.delete, tags.delete) erfordern, dass der Agent das zu löschende Element abruft und anzeigt (Titel, Autor, Anzahl betroffener Beiträge), bevor eine Bestätigung angefordert wird.
💡 Tipp: Verwende beim Erstellen von Seiten patterns.list → patterns.get, um Block-Vorlagen abzurufen und vollständige Seiten aus mehreren Block-Vorlagen zusammenzustellen. Prüfe nach jedem Erstellen oder Aktualisieren das Feld _content_warnings in der Antwort – WordPress kann beim Speichern Blöcke oder HTML entfernen.
Website-Editor-Kontext ( wpcom-mcp-site-editor-context )
Frage den Design-Kontext der Website ab – Theme-Presets, angewendete Stile und registrierte Blocktypen. Schreibgeschütztes Gegenstück zur Inhaltserstellung. Verwende es vor dem Erstellen oder Aktualisieren von Inhalten, damit das Markup theme-konforme Tokens anstelle von fest codierten Werten verwendet.
Diese Fassade verwendet action: list | describe | get (nicht execute, da sie niemals schreibt).
💡 Empfohlene Reihenfolge: theme.active → theme.presets → (optional) blocks.allowed → dann Inhalte über wpcom-mcp-content-authoring erstellen.
Verfügbare Operationen
| Operation | Beschreibung |
|---|---|
theme.active | Ruft den Stylesheet-Slug und den Namen des aktiven Themes ab. Verwende den stylesheet-Wert beim Abrufen von theme.presets oder theme.styles. |
theme.presets | Ruft die Design-Tokens der Website ab – Farbpalette, Schriftgrößen, Schriftfamilien, Verläufe, Abstufungsskala. Löst das Stylesheet automatisch vom aktiven Theme auf, wenn es nicht angegeben wird. |
theme.styles | Ruft die angewendeten Stile der Website aus theme.json ab – Block-spezifische Überschreibungen und Element-spezifische Typografie/Farben. Ergänzt theme.presets: Presets definieren, welche Tokens existieren; Stile definieren, wie sie angewendet werden. |
blocks.allowed | Listet die auf der Website registrierten Blocktypen mit Name, Titel, Beschreibung, Kategorie und Stilvarianten auf. Wende eine Stilvariante als is-style-{name} an. |
💡 Tipp: Referenziere Preset-Slugs im Block-Markup – z. B. has-primary-color oder has-large-font-size – anstelle von Inline-Stilen mit rohen Hex- oder Pixelwerten, damit sich Inhalte anpassen, wenn sich die Design-Tokens der Website ändern.
⚠️ Wichtig: Dass ein Block registriert ist, garantiert nicht, dass sein Markup die REST-API-Speicherpipeline unverändert übersteht. Prüfe nach jedem Erstellen oder Aktualisieren über wpcom-mcp-content-authoring das Feld _content_warnings. Wenn Markup entfernt wurde, verwende einfachere Block-Alternativen oder frage nach, wie vorgegangen werden soll.
Account ( wpcom-mcp-account )
Verwalte das WordPress.com-Konto des authentifizierten Benutzers – Profil, Benachrichtigungen, Erfolge, Domains, Verbindungen, Sicherheit und Währung. Arbeitet mit dem aufrufenden Benutzer; kein wpcom_site-Parameter erforderlich.
Verfügbare Operationen
| Operation | Beschreibung |
|---|---|
profile.get | Grundlegendes Profil (Benutzername, E-Mail, Anzeigename, Avatar, Sprache, Zeitzone), optional mit Einstellungen, Statistiken, Kontoinformationen, sozialen/Aktivitätsdaten. |
profile.update | Profilfelder aktualisieren (Anzeigename, Bio, Sprache usw.). Schreibzugriff. |
notifications.get | Benachrichtigungseinstellungen über E-Mail, Push, Timeline und andere Kanäle. Enthält Geräteliste und Zustellungstest. |
notifications.update | Benachrichtigungseinstellungen aktualisieren. Schreibzugriff. |
inbox.get | Der Benachrichtigungseingang des Benutzers (Nachrichten, Warnungen, Erwähnungen, Likes, Follows). Filtern nach Typ, ungelesen, Zeitraum. |
achievements.get | Verdiente Abzeichen, Erfolge, Gamification-Fortschritt und Trophäenvitrine. |
domains.list | Domains des authentifizierten Benutzers über alle Websites hinweg auflisten. |
domains.get | Domain-Details: Verwaltungsfunktionen, DNS-Konfiguration, DNSSEC, SSL-Status, Wartungsstatus. |
domains.dns_records | DNS-Einträge (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) für eine einzelne Domain. |
domains.set_primary | Eine benutzerdefinierte Domain als Hauptdomain für eine Website festlegen. Schreibzugriff. |
connections.get | Soziale und Drittanbieter-Dienstverbindungen (auflisten, Details abrufen, Zustand prüfen). |
security.get | Sicherheitsstatus: 2FA, Anwendungspasswörter, aktive Sitzungen, Anmeldeverlauf, Kontoalter. |
currency.preview | Vorschau der Auswirkungen einer Kontowährungsänderung (wird nicht übernommen). |
currency.change | Kontowährung ändern. Schreibzugriff. |
Site ( wpcom-mcp-site )
Verwalte eine WordPress.com-Website – Einstellungen, Statistiken, Plugins, Aktivitätsprotokoll, Themes und Jetpack-Modulkonfiguration. Erfordert wpcom_site (Website-ID oder URL).
Verfügbare Operationen
| Operation | Beschreibung |
|---|---|
settings.get | Allgemeine, Schreib-, Lese-, Diskussions-, Medien-, Permalink- und Datenschutzeinstellungen. |
settings.update | Website-Einstellungen aktualisieren. Schreibzugriff. |
statistics.get | Website-Gesamtzahlen – veröffentlichte Beiträge, Seiten, Abonnenten – plus optionale Aufrufe, Besucher, veröffentlichte Beiträge und veröffentlichte Seiten für einen Zeitraum. Enthält KEINE Top-Beiträge, Referrer, Geo-Daten oder Aufschlüsselungen pro URL. |
plugin.list | Installierte Plugins mit Status, Version, Update-Verfügbarkeit und Berechtigungen. |
activity.get | Einträge im Aktivitätsprotokoll (Beiträge, Kommentare, Plugin-Updates, Backups, Benutzeraktionen). Umgekehrt chronologisch. Standardmäßig die letzten 6 Monate. Filtern nach activity_group und activity_action. |
theme.list | Installierte Themes auf der Website. |
theme.set | Das aktive Theme wechseln. Schreibzugriff. |
monitor.status / monitor.activate / monitor.deactivate | Jetpack Monitor Verfügbarkeitsprüfungen. Aktivieren/Deaktivieren sind Schreibzugriffe. |
newsletter.status / newsletter.get_settings | Jetpack Newsletter-Status und -Einstellungen. |
account-protection.status / account-protection.activate / account-protection.deactivate | Jetpack Kontoschutz. Aktivieren/Deaktivieren sind Schreibzugriffe. |
manage-site.status / manage-site.launch / manage-site.set-visibility | Website-Lebenszyklus – „Demnächst verfügbar“-Status, Start, Sichtbarkeit. Schreibzugriffe. |
💡 Tipp für activity.get: Kombiniere activity_group (z. B. ["plugin"]) und activity_action (z. B. ["activated", "deactivated"]), um Untersuchungen einzugrenzen. Rufe das Tool zunächst ohne Filter auf, um herauszufinden, was für eine bestimmte Website verfügbar ist.
Eigenständige Tools
Benutzer-Websites auflisten ( wpcom-user-sites )
Listet die zugänglichen Websites des authentifizierten Benutzers auf – sowohl auf WordPress.com als auch auf selbst gehosteten, mit Jetpack verbundenen Websites. Verwende dieses Tool, um Website-IDs zu ermitteln, bevor du website-bezogene Tools aufrufst. Unterstützt Paginierung, Suche, Status- und Datenschutzfilter, Sortierung sowie optionale Website-Metriken.
Domain-Verfügbarkeit prüfen ( wpcom-domain-purchase )
Suche nach verfügbaren Domains und generiere Checkout-Links für die Registrierung auf WordPress.com. Gibt passende Domains mit Preisen und vorgefertigten Checkout-URLs zurück.
DNS-Einträge aktualisieren ( wpcom-domain-update-dns-records )
Fügen Sie DNS-Einträge (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) für eine einzelne benutzerdefinierte Domain, die Sie verwalten, hinzu oder entfernen Sie diese.
⚠️ Destruktiver Vorgang. Fehlkonfiguriertes DNS kann E-Mail und Websites beeinträchtigen. Rufen Sie immer die aktuellen Einträge ab (über wpcom-mcp-account → domains.dns_records) und beschreiben Sie die Unterschiede, bevor Sie eine Bestätigung anfordern.
Standard-DNS-Einträge wiederherstellen ( wpcom-domain-restore-default-dns-records )
Stellt die WordPress.com-Standard-A-Einträge (Apex-IPs) oder den Standard-www-CNAME für eine einzelne benutzerdefinierte Domain wieder her. Wird durch die Einstellung „DNS-Einträge aktualisieren“ gesteuert.
Nameserver aktualisieren ( wpcom-domain-update-nameservers )
Legt die Nameserver für eine einzelne benutzerdefinierte Domain fest. Erfordert, dass der Aufrufer die Website verwaltet, mit der die Domain verbunden ist. Akzeptiert zwischen 2 und 13 gültige Nameserver-Hostnamen.
⚠️ Das Ändern der Nameserver überträgt die DNS-Kontrolle von WordPress.com weg. E-Mail, Websites und andere Dienste können ausfallen, wenn die neuen Nameserver nicht so konfiguriert sind, dass sie dieselben Einträge bereitstellen.
Externen E-Mail-Dienst festlegen ( wpcom-domain-set-mail-service )
DNS-Einträge einer Domain für einen externen E-Mail-Dienst konfigurieren: Google Workspace, iCloud Mail, Office 365 oder Zoho Mail.
⚠️ Überschreibt die vorhandenen MX- und zugehörigen DNS-Einträge der Domain. Der bestehende E-Mail-Verkehr wird unterbrochen, sobald die neuen Einträge propagiert sind.
Checkout-URL generieren ( wpcom-checkout-url )
Eine vorkonfigurierte WordPress.com-Checkout-URL für ein oder mehrere Produkte (Neukauf) oder für eine Abonnementverlängerung generieren. Die URL leitet den Benutzer zum WordPress.com-Checkout weiter – die Zahlung erfolgt im Browser, nicht über dieses Tool.
WordPress.com-Tarife auflisten ( wpcom-plans-list )
WordPress.com-Tarife mit Preisen und Funktionslisten pro Stufe auflisten. Nur lesend; nützlich, um Tarifoptionen anzuzeigen, bevor eine Checkout-URL generiert wird.
Zusammenfassung des Sicherheitsprotokolls
Alle Schreib-/Löschvorgänge erfordern einen obligatorischen Bestätigungsablauf. Der Agent muss die Aktion beschreiben, eine ausdrückliche Zustimmung des Benutzers einholen und diese Zustimmung als user_confirmed: true in den Execute-params übergeben.
| Verhalten | Lesen | Erstellen | Aktualisieren | Löschen (Papierkorb) | Löschen (endgültig) |
|---|---|---|---|---|---|
| Bestätigung erforderlich | ❌ | ✅ | ✅ | ✅ | ✅ |
| Umkehrbar | N/A | N/A | Teilweise (vorherige Werte gehen verloren) | ✅ Innerhalb von 30 Tagen | ❌ Endgültig |
| Standardstatus (Inhalt) | N/A | draft | Keine Änderung | trash | Vollständig entfernt |
| Zusätzliches Flag | — | — | — | — | confirm_permanent_delete: true |
Endgültige Löschungen (Taxonomie-Begriffe wie Kategorien und Schlagwörter) erfordern zusätzlich confirm_permanent_delete: true in params.
Akzeptierte Formen von user_confirmed: der boolesche Wert true (bevorzugt) oder einer der Strings "true", "yes", "on", "1". Freiformulierte Zustimmungsphrasen wie "yes do it" werden abgelehnt – der Agent muss die Zustimmung des Benutzers in eine dieser akzeptierten Formen umwandeln.
Zuletzt aktualisiert: Juni 29, 2026
Ressourcen für WordPress.com-Entwickler 