Skip to content

GoBuildWP 1.21.0

Latest

Choose a tag to compare

@wppilot-labs wppilot-labs released this 16 Nov 20:02

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, shell and 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 where proc_open or the wp binary 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=true overrides).
  • Write receipts and idempotency keys. Every write returns its change id and the undo call; a retried write with the same idempotency_key runs once.
  • Provable audit log. The change ledger is a SHA-256 hash chain; wppilot/verify-change-log finds 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-file and enable-file refuse PHP that would not parse and write files atomically.
  • SSRF hardening: import-media-url checks 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-comment undo on an approved comment works; stale .well-known OAuth 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:

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).