Referentie voor WordPress.com MCP-tools
Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik dan hier.
Dit document biedt een uitgebreide mapping van MCP-tools die beschikbaar zijn voor WordPress.com-ontwikkelaars. Dit is een levend document en wordt bijgewerkt wanneer er nieuwe tools worden toegevoegd of bestaande tools worden aangepast.
Voor exacte invoer- en uitvoerschema’s roep je de tool zelf aan — elke STRAP-facade biedt action: list (operation catalog) en action: describe (volledig JSON Schema per bewerking). Schema’s ontwikkelen zich, dus beschouw de live describe-respons altijd als de bron van waarheid.
Hoe WordPress.com MCP-tools zijn georganiseerd
De WordPress.com MCP-server biedt twee soorten tools:
- STRAP-facadetools — Eén MCP-tool die een reeks verwante bewerkingen achter één toegangspunt verpakt. Facades gebruiken een uniforme interface op basis van acties (
action: list | describe | execute), zodat AI-agents ontdekken wat er beschikbaar is, parameterschema’s ophalen en bewerkingen via één tool uitvoeren. Zo blijft de toolcatalogus klein en voorspelbaar. - Zelfstandige tools — Tools voor één specifiek doel die parameters rechtstreeks accepteren. Gebruikt voor bewerkingen die niet in een grotere reeks passen (bijv. het weergeven van de sites van de gebruiker, het genereren van een checkout-URL).
⚠️ Veiligheidsprotocol: Voor alle schrijf-, bijwerk- en verwijderbewerkingen is bevestiging van de gebruiker vereist. De agent moet (1) precies beschrijven wat hij van plan is te doen, (2) de gebruiker om expliciete bevestiging vragen en (3) de bevestiging van de gebruiker opnemen als user_confirmed: true in de params van execute. Schrijfbewerkingen worden nooit automatisch uitgevoerd. Voor permanente verwijderingen (taxonomietermen) is daarnaast confirm_permanent_delete: true vereist.
Interface op basis van acties (STRAP-facades)
Elke STRAP-facadetool accepteert dezelfde drie invoerwaarden op het hoogste niveau:
action(enum:list/describe/execute): Wat de agent wil doen.list— Ontdek beschikbare bewerkingen in deze tool. Geeft bewerkingsnamen, korte beschrijvingen en redenen voor uitgeschakelde bewerkingen terug.describe— Haal het volledige JSON Schema (parameters, typen, vereiste velden) voor één bewerking op.execute— Voer een bewerking uit.operation: De bewerkingsnaam in de vormresource.action(bijv.posts.create,theme.presets).params: Bewerkingsspecifieke parameters. Schrijfbewerkingen moetenuser_confirmed: truebevatten.
De meeste facades vereisen ook wpcom_site (een site-ID of URL). De facade wpcom-mcp-account is de uitzondering — die werkt op basis van de geauthenticeerde gebruiker.
Alle bewerkingen ondersteunen een optionele parameter include_fields om te beperken welke velden worden geretourneerd. Gebruik deze om reacties context-efficiënt te houden.
STRAP-facadetools
Contentcreatie ( wpcom-mcp-content-authoring )
Maak, lees, werk bij en verwijder content op een WordPress.com-site — berichten, pagina’s, reacties, media, categorieën, tags, blokpatronen en zoeken in content.
💡 Aanbevolen volgorde: Roep eerst wpcom-mcp-site-editor-context aan (theme.active, theme.presets), zodat content preset-slugs gebruikt die aansluiten op het thema (bijv. "primary", "large") in plaats van hardcoded kleuren en groottes.
Beschikbare bewerkingen
| Bewerking | Beschrijving |
|---|---|
posts.list | Toon berichten met optionele filters (status, auteur, zoeken, taxonomie, datumbereik, sortering, paginering). |
posts.get | Haal een individueel bericht op via ID of slug. Valt terug op zoeken in pagina’s als een slug niet overeenkomt met een bericht. |
posts.create | Maak een nieuw bericht — wordt standaard als concept aangemaakt. Schrijfbewerking. |
posts.update | Werk een bestaand bericht bij. Alleen opgegeven velden worden gewijzigd. Als de status publish is, gaan wijzigingen direct live. Schrijfbewerking. |
posts.delete | Verplaats een bericht naar de prullenbak. Binnen 30 dagen te herstellen via WordPress-beheer. Schrijfbewerking. |
pages.list | Toon pagina’s met optionele filters (bovenliggende pagina, status, zoeken, sortering, paginering). |
pages.get | Haal één pagina op via ID of slug. |
pages.create | Maak een nieuwe pagina — wordt standaard als concept aangemaakt. Ondersteunt hiërarchische structuren en paginasjablonen. Schrijfbewerking. |
pages.update | Werk een bestaande pagina bij. Alleen opgegeven velden worden gewijzigd. Als de status publish is, gaan wijzigingen direct live. Schrijfbewerking. |
pages.delete | Verplaats een pagina naar de prullenbak. Binnen 30 dagen te herstellen via WordPress-beheer. Schrijfbewerking. |
comments.list | Toon reacties met optionele filters (status, bericht, auteur, zoeken, datumbereik, paginering). |
comments.get | Haal één reactie op via ID. |
comments.create | Maak een reactie op een bericht. Bij reacties van geauthenticeerde gebruikers worden auteursvelden automatisch ingevuld. Schrijfbewerking. |
comments.update | Werk een bestaande reactie bij. Als de status approved is, zijn wijzigingen direct zichtbaar. Schrijfbewerking. |
comments.delete | Verplaats een reactie naar de prullenbak. Schrijfbewerking. |
media.list | Toon media items met optionele filters (mime-type, bericht, auteur, zoeken, datumbereik, paginering). |
media.get | Haal één media item op via ID. |
media.create | Upload een nieuw media item (afbeelding, video, audio, document). Schrijfbewerking. |
media.update | Werk metadata van een media item bij (niet het bestand). Wijzigingen in alt_text en caption worden direct bijgewerkt overal waar de media worden gebruikt. Schrijfbewerking. |
media.delete | Verplaats een media item naar de prullenbak. Kan content breken die ernaar verwijst. Schrijfbewerking. |
categories.list | Toon categorieën met optionele filters. |
categories.get | Haal één categorie op via ID. |
categories.create | Maak een nieuwe categorie. Ondersteunt hiërarchische ouder-kindrelaties. Schrijfbewerking. |
categories.update | Werk een bestaande categorie bij. Het wijzigen van de slug heeft direct invloed op archief-URL’s en kan links breken. Schrijfbewerking. |
categories.delete | Verwijder een categorie permanent — taxonomietermen hebben geen prullenbak. Toegewezen berichten worden verplaatst naar Geen categorie; subcategorieën worden categorieën op het hoogste niveau. Vereist confirm_permanent_delete: true. |
tags.list | Toon tags met optionele filters. Zoeken naar tags is niet hoofdlettergevoelig. |
tags.get | Haal één tag op via ID. |
tags.create | Maak een nieuwe tag. Schrijfbewerking. |
tags.update | Werk een bestaande tag bij. Het wijzigen van de slug heeft direct invloed op archief-URL’s. Schrijfbewerking. |
tags.delete | Verwijder een tag permanent — verwijderd uit alle gekoppelde berichten. Vereist confirm_permanent_delete: true. |
patterns.list | Toon blokpatronen die beschikbaar zijn op de site (thema, core, patroondirectory). |
patterns.get | Haal één blokpatroon op via naam, inclusief de bijbehorende blokmark-up. |
synced-patterns.list | Toon de gesynchroniseerde (herbruikbare) patronen van de site. |
synced-patterns.get | Haal één gesynchroniseerd patroon op via ID, inclusief de bijbehorende blokmark-up. |
content-search | Zoeken met vrije tekst in de content van de site (berichten, pagina’s, andere berichttypes). |
⚠️ Destructieve bewerkingen (posts.delete, pages.delete, comments.delete, media.delete, categories.delete, tags.delete) vereisen dat de agent het item dat wordt verwijderd ophaalt en presenteert (titel, auteur, aantal getroffen berichten) voordat om bevestiging wordt gevraagd.
💡 Tip: Gebruik bij het maken van pagina’s patterns.list → patterns.get om blokpatronen op te halen en volledige pagina’s samen te stellen uit meerdere patronen. Controleer na elke aanmaak- of updateactie het veld _content_warnings in de response — WordPress kan tijdens het opslaan blokken of HTML verwijderen.
Site-editorcontext ( wpcom-mcp-site-editor-context )
Vraag de ontwerpcontext van de site op — themavoorinstellingen, toegepaste stijlen en geregistreerde bloktypen. Alleen-lezen aanvulling op Content Authoring. Gebruik dit voordat je content maakt of bijwerkt, zodat de markup thema-uitgelijnde tokens gebruikt in plaats van hardgecodeerde waarden.
Deze facade gebruikt action: list | describe | get (niet execute, omdat deze nooit schrijft).
💡 Aanbevolen volgorde: theme.active → theme.presets → (optioneel) blocks.allowed → maak vervolgens content via wpcom-mcp-content-authoring.
Beschikbare bewerkingen
| Bewerking | Beschrijving |
|---|---|
theme.active | Haal de stylesheet-slug en naam van het actieve thema op. Gebruik de waarde stylesheet bij het ophalen van theme.presets of theme.styles. |
theme.presets | Haal de designtokens van de site op — kleurenpalet, lettergroottes, lettertypefamilies, gradiënten en afstandsschaal. Lost de stylesheet automatisch op vanuit het actieve thema als deze wordt weggelaten. |
theme.styles | Haal de toegepaste stijlen van de site op uit theme.json — overschrijvingen op blokniveau en typografie/kleuren op elementniveau. Vult theme.presets aan: presets zijn welke tokens er bestaan; stijlen zijn hoe ze worden toegepast. |
blocks.allowed | Toon bloktypen die op de site zijn geregistreerd, met naam, titel, beschrijving, categorie en stijlvariaties. Pas een stijlvariatie toe als is-style-{name}. |
💡 Tip: Verwijs naar preset-slugs in blokmarkup — bijvoorbeeld has-primary-color of has-large-font-size — in plaats van inline stijlen met ruwe hex- of pixelwaarden, zodat content zich aanpast wanneer de designtokens van de site veranderen.
⚠️ Belangrijk: Dat een blok is geregistreerd, garandeert niet dat de markup ongewijzigd door de opslagpipeline van de REST API komt. Controleer na elke aanmaak- of updateactie via wpcom-mcp-content-authoring het veld _content_warnings. Als markup is verwijderd, gebruik dan eenvoudigere blokalternatieven of vraag de gebruiker hoe je verder moet gaan.
Account ( wpcom-mcp-account )
Beheer het WordPress.com-account van de geauthenticeerde gebruiker — profiel, meldingen, prestaties, domeinen, verbindingen, beveiliging en valuta. Werkt op de aanroepende gebruiker; geen parameter wpcom_site vereist.
Beschikbare bewerkingen
| Bewerking | Beschrijving |
|---|---|
profile.get | Basic-profiel (gebruikersnaam, e-mailadres, weergavenaam, avatar, locale, tijdzone), optioneel met voorkeuren, statistieken, accountgegevens en sociale/Activiteit-gegevens. |
profile.update | Werk profielvelden bij (weergavenaam, bio, locale, enz.). Schrijfbewerking. |
notifications.get | Meldingsvoorkeuren voor e-mail, push, tijdlijn en andere kanalen. Bevat apparatenlijst en bezorgingstest. |
notifications.update | Werk meldingsinstellingen bij. Schrijfbewerking. |
inbox.get | De meldingeninbox van de gebruiker (berichten, waarschuwingen, vermeldingen, likes, volgers). Filter op type, ongelezen, periode. |
achievements.get | Behaalde badges, prestaties, voortgang in gamification en prijzenkast. |
domains.list | Maak een lijst van de domeinen van de geauthenticeerde gebruiker op alle sites. |
domains.get | Domeingegevens: beheermogelijkheden, DNS-configuratie, DNSSEC, SSL-status, onderhoudsstatus. |
domains.dns_records | DNS-records (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) voor één domein. |
domains.set_primary | Stel een aangepast domein in als het primair domein voor een site. Schrijfbewerking. |
connections.get | Verbindingen met sociale en externe services (lijst, details ophalen, gezondheid testen). |
security.get | Beveiligingsstatus: 2FA, applicatiewachtwoorden, actieve sessies, inloggeschiedenis, accountleeftijd. |
currency.preview | Bekijk een voorbeeld van de impact van het wijzigen van de accountvaluta (wordt niet doorgevoerd). |
currency.change | Wijzig de accountvaluta. Schrijfbewerking. |
Site ( wpcom-mcp-site )
Beheer een WordPress.com-site — instellingen, statistieken, plugins, activiteitenlog, thema’s en configuratie van Jetpack-modules. Vereist wpcom_site (site-ID of URL).
Beschikbare bewerkingen
| Bewerking | Beschrijving |
|---|---|
settings.get | Instellingen voor Algemeen, Schrijven, Lezen, Discussie, Media, Permalinks en Privacy. |
settings.update | Werk site-instellingen bij. Schrijfbewerking. |
statistics.get | Sitetotalen — gepubliceerde berichten, pagina’s, abonnees — plus optionele weergaven, bezoekers, gepubliceerde berichten en gepubliceerde pagina’s voor een datumbereik. Bevat GEEN topberichten, verwijzers, geo-gegevens of uitsplitsingen per URL. |
plugin.list | Geïnstalleerde plugins met status, versie, beschikbaarheid van updates en rechten. |
activity.get | Activiteitenlogvermeldingen (berichten, reacties, plugin-updates, back-ups, gebruikersacties). Omgekeerd chronologisch. Standaard de afgelopen 6 maanden. Filter op activity_group en activity_action. |
theme.list | Geïnstalleerde thema’s op de site. |
theme.set | Wissel van actief thema. Schrijfbewerking. |
monitor.status / monitor.activate / monitor.deactivate | Uptime-controles van Jetpack Monitor. Activeren/deactiveren zijn schrijfbewerkingen. |
newsletter.status / newsletter.get_settings | Status en instellingen van Jetpack Newsletter. |
account-protection.status / account-protection.activate / account-protection.deactivate | Jetpack Account Protection. Activeren/deactiveren zijn schrijfbewerkingen. |
manage-site.status / manage-site.launch / manage-site.set-visibility | Levenscyclus van de site — status ‘binnenkort beschikbaar’, lancering, zichtbaarheid. Schrijfbewerkingen. |
💡 Tip voor activity.get: combineer activity_group (bijv. ["plugin"]) en activity_action (bijv. ["activated", "deactivated"]) om onderzoeken te verfijnen. Roep eerst zonder filters aan om te ontdekken wat beschikbaar is voor een bepaalde site.
Zelfstandige tools
Gebruikerssites weergeven ( wpcom-user-sites )
Geef de toegankelijke sites van de geverifieerde gebruiker weer op WordPress.com en zelfgehoste sites die met Jetpack zijn verbonden. Gebruik dit om site-ID’s te vinden voordat je tools aanroept die op een site zijn gericht. Ondersteunt paginering, zoeken, filters voor status en privacy, sorteren en optionele sitestatistieken.
Domeinbeschikbaarheid zoeken ( wpcom-domain-purchase )
Zoek naar beschikbare domeinen en genereer afrekenlinks voor registratie op WordPress.com. Retourneert overeenkomende domeinen met prijzen en vooraf gemaakte afreken-URL’s.
DNS-records bijwerken ( wpcom-domain-update-dns-records )
Voeg DNS-records (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) toe of verwijder ze voor één aangepast domein dat je beheert.
⚠️ Destructieve bewerking. Verkeerd geconfigureerde DNS kan e-mail en websites verstoren. Haal altijd eerst de huidige records op (via wpcom-mcp-account → domains.dns_records) en beschrijf de diff voordat je om bevestiging vraagt.
Standaard DNS-records herstellen ( wpcom-domain-restore-default-dns-records )
Herstel de standaard A-records van WordPress.com (apex-IP’s) of de standaard www CNAME voor één aangepast domein. Afgeschermd door de instelling “DNS-records bijwerken”.
Naamservers bijwerken ( wpcom-domain-update-nameservers )
Stel de naamservers in voor één aangepast domein. Vereist dat de aanroeper de site beheert waarmee het domein is verbonden. Accepteert tussen 2 en 13 geldige hostnamen voor naamservers.
⚠️ Het wijzigen van naamservers verplaatst de DNS-controle weg van WordPress.com. E-mail, websites en andere diensten kunnen uitvallen als de nieuwe naamservers niet zijn geconfigureerd om dezelfde records te leveren.
Externe e-maildienst instellen ( wpcom-domain-set-mail-service )
Configureer DNS-records op een domein voor een externe e-maildienst: Google Workspace, iCloud Mail, Office 365 of Zoho Mail.
⚠️ Overschrijft de bestaande MX- en gerelateerde DNS-records van het domein. Bestaand e-mailverkeer stopt zodra de nieuwe records zijn doorgevoerd.
Checkout-URL genereren ( wpcom-checkout-url )
Genereer een vooraf geconfigureerde WordPress.com-checkout-URL voor een of meer producten (nieuwe aankoop) of voor een abonnementsverlenging. De URL brengt de gebruiker naar de WordPress.com-checkout — de betaling gebeurt in de browser, niet via deze tool.
WordPress.com-abonnementen weergeven ( wpcom-plans-list )
Geef WordPress.com-abonnementen weer met prijzen en functielijsten per niveau. Alleen-lezen; handig om abonnementsopties te tonen voordat je een checkout-URL genereert.
Samenvatting van het veiligheidsprotocol
Alle schrijf-/verwijderbewerkingen dwingen een verplichte bevestigingsflow af. De agent moet de actie beschrijven, expliciete goedkeuring van de gebruiker krijgen en die goedkeuring doorgeven als user_confirmed: true in de uitvoer-params.
| Gedrag | Lezen | Aanmaken | Bijwerken | Verwijderen (prullenbak) | Verwijderen (permanent) |
|---|---|---|---|---|---|
| Bevestiging vereist | ❌ | ✅ | ✅ | ✅ | ✅ |
| Omkeerbaar | N.v.t. | N.v.t. | Gedeeltelijk (vorige waarden gaan verloren) | ✅ Binnen 30 dagen | ❌ Permanent |
| Standaardstatus (inhoud) | N.v.t. | draft | Geen wijziging | trash | Volledig verwijderd |
| Extra vlag | — | — | — | — | confirm_permanent_delete: true |
Permanente verwijderingen (taxonomietermen zoals categorieën en tags) vereisen daarnaast confirm_permanent_delete: true in params.
Geaccepteerde vormen van user_confirmed: de boolean true (aanbevolen), of een van de strings "true", "yes", "on", "1". Vrije goedkeuringszinnen zoals "yes do it" worden geweigerd — de agent moet de goedkeuring van de gebruiker omzetten naar een van deze geaccepteerde vormen.
Laatste update: juni 22, 2026
WordPress.com Hulpmiddelen ontwikkelaars