Repository navigation
The biggest free release of the GoBuildWP WordPress MCP server yet. AI agents in Claude, ChatGPT, Cursor, Codex and other MCP clients can now run more of a WordPress site (maintenance windows, redirects, widgets, block edits, Markdown import, PDFs, child themes), and every write is guarded so an agent cannot quietly break a page. Includes the 1.20.2 fix.
New abilities
- Maintenance mode with scheduled windows. A 503 page with Retry-After for 1 minute to 7 days that switches itself off; administrators still see the site. Schedule windows up to 30 days ahead.
- Admin IP lock. Restrict wp-login.php and wp-admin to your IP addresses and ranges, with Cloudflare and proxy support. A list that would lock out the address saving it is refused.
- Redirect manager. 301, 302 and 410 redirects with hit counts, a path tracer and suggestions from the 404 log. Loops and long chains are refused; a published page whose URL changes gets a 301 automatically.
- Classic widgets. List widget areas; add, change, move and remove widgets, with undo.
- Edit one Gutenberg block by path (
wppilot/gutenberg-edit-block) instead of resending the whole page. - Markdown to blocks (
wppilot/markdown-to-blocks): headings, lists, quotes, code, images and tables become core blocks. - Read a PDF from the Media Library page by page (
wppilot/read-pdf), in plain PHP. - Create a child theme (
wppilot/create-child-theme) so customisations survive the parent theme's next update, with undo. - Search and replace in site options (widgets, theme mods, plugin settings), not only posts.
- Bulk comment moderation: approve, unapprove, spam or trash up to 100 comments in one call after a count preview.
- Rendered HTML (
wppilot/get-rendered-html): the HTML a logged-out visitor is served, cache included. - Bot access report (
wppilot/bot-access-report): which search and AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Googlebot and more) robots.txt lets in, and which actually visit. - Pre-launch checklist (
wppilot/launch-checklist): search visibility, HTTPS, errors shown to visitors, favicon, analytics, privacy page and broken links. - REST bridge (
wppilot/rest-request): call one namespace of the site's own REST API as the connected user, once an administrator switches it on. - Database row writes (
db-insert-row,db-update-rows,db-delete-rows) in a plugin's own tables, Developer Full Access only, each row recorded for undo. - WP-CLI improvements: command rules refuse
db drop,eval,shelland similar; version pins (expect) stop a command written for one plugin version running on another; core version, plugin and theme lists and option reads run in-process whereproc_openor thewpbinary is missing.
Safety and control
- Pause agents from the admin bar, Settings or GoBuildWP Cloud. Pause and resume from Cloud are signed and replay-proof, with an "Only resume locally" option.
- Approve Cloud bulk writes on each site. A GoBuildWP Cloud job that needs a person queues one approval screen per site, with Approve all and Deny all.
- In-chat approval card. New installs start on "A person approves", so an agent can no longer approve its own destructive calls.
- Content-loss guard. A write that removes more than half of a page's text or media is refused until the user agrees.
- Stale-read guard and editor lock. An agent cannot overwrite edits made in the block editor after it read the post, or while someone has it open.
- Safer undo. Undoing a post change after a newer edit is refused and names what moved (
force=trueoverrides). - Write receipts and idempotency keys. Every write returns its change id and the undo call; a retried write with the same
idempotency_keyruns once. - Provable audit log. The change ledger is a SHA-256 hash chain;
wppilot/verify-change-logfinds the first edited or deleted row. - Access control: per-connection access levels, a Drafts only token level, an MCP IP allowlist, approval for new OAuth apps, newly added abilities held until enabled, settings as code, an MCP request log and a connection survival kit.
- Kill switch:
define( 'WPPILOT_DISABLE_MCP', true );in wp-config.php switches off all AI agent access. - Safe PHP file writes:
write-file,edit-fileandenable-filerefuse PHP that would not parse and write files atomically. - SSRF hardening:
import-media-urlchecks every redirect hop and IPv6 address and pins the connection to the checked address. - Bound approvals: an approval for a destructive call is tied to the state of what it writes to.
Fixes
- 1.20.2: OAuth answered HTTP 500 on every MCP call when WPS Hide Login (or another plugin checking login state during
plugins_loaded) was active with pretty permalinks. - Undo after a visitor commented on the post no longer reports a failed restore.
- Read Only connections and narrow tokens get a refusal that names the connection or token, not the safety profile.
moderate-commentundo on an approved comment works; stale.well-knownOAuth documents are purged from page caches; Diagnostics can repair missing OAuth tables.
Full details: CHANGELOG.txt.
Watch it work
Video tutorials on the GoBuildWP YouTube channel:
- Connect WordPress to any AI client with MCP
- Build a full Elementor website with one prompt
- Edit Elementor pages with AI prompts
- WordPress SEO with AI, step by step
- Manage multiple WordPress sites with AI
Install or update
- Download gobuildwp.zip below and upload it in Plugins → Add New → Upload Plugin, or let WordPress offer the update. The plugin folder stays
wppilot/, so settings, connections and history carry over. - Then connect your AI client: https://gobuildwp.com/wordpress-mcp. Docs and the ability reference: https://gobuildwp.com/docs.
- Requires WordPress 6.9+ and PHP 8.0+.
Validation
- 262 abilities; ability count, doc consistency, duplicate declaration, kit boundary and coexistence gates pass.
- PHPUnit: 2672 tests, 12445 assertions, OK.
- PHP lint clean under PHP 8.0 and 8.1.
- Installed from this zip on WordPress 7.1 and exercised over real MCP HTTP (launch checklist, bot access report, Markdown to blocks, change-log verification, maintenance mode, redirects, widgets, rendered HTML).