WPBakery Page Builder MCP tools
Available in EMCP 3.17.0. WPBakery uses shortcodes for rows, columns and elements. EMCP Pro reads the live WPBMap registry, exposes schemas and edits a verified core subset of native content. Unsupported markup is refused rather than silently discarded during a rewrite.
Requirements and setup
Section titled “Requirements and setup”- Check installed versions. WPBakery 9.0.1 through 9.0.x. EMCP Pro is required.
- Enable the integration. Open EMCP Tools > Page Builders and select this standalone builder. Gutenberg and enabled block packs remain available.
- Connect and inspect. Reconnect your MCP client, read context and schemas, and enable the write tools needed for the task. Start with a draft and inspect the native editor.
Native workflow
Section titled “Native workflow”Page styling has dedicated tools, including native custom and default element CSS regeneration. Local and default templates can be discovered and applied when valid for the adapter. Recovery snapshots capture content and CSS for inspecting and restoring a previous state.
Inspect shortcode elements
Section titled “Inspect shortcode elements”Read the runtime catalog and verified authoring subset.
Edit layout and CSS
Section titled “Edit layout and CSS”Use a current hash to replace supported content or fragments and update page styles.
Verify the backend editor
Section titled “Verify the backend editor”Read back the native save, inspect responsive output and publish explicitly.
Tool reference
Section titled “Tool reference”All names use the emcp-tools/ namespace. Read the live input schema for optional fields, enums, limits and confirmation requirements; this table lists required inputs only.
| Tool | Access | Purpose | Required inputs |
|---|---|---|---|
wpbakery-get-context | Read | Read installed version, permissions and authoring scope. | None |
wpbakery-list-elements | Read | List installed elements, native access and supported authoring types. | None |
wpbakery-get-element-schema | Read | Read native element controls, defaults and nesting rules. | type |
wpbakery-list-pages | Read | List accessible pages and their native editor state. | None |
wpbakery-get-page | Read | Read native shortcodes, page CSS, editor links and current hash. | post_id |
wpbakery-create-page | Write | Create an empty native WPBakery draft. | title |
wpbakery-set-page-content | Write | Replace native shortcodes after validating the verified core subset; preserves publication status. | post_id, expected_hash, content |
wpbakery-replace-fragment | Write | Replace one unique exact shortcode fragment, validating the entire resulting layout. | post_id, expected_hash, find, replacement |
wpbakery-get-page-styles | Read | Read custom page CSS and generated element CSS. | post_id |
wpbakery-set-page-styles | Write | Replace page-local CSS; rejects style closing tags. | post_id, expected_hash, css |
wpbakery-list-templates | Read | List native saved and default templates; no remote library downloads. | None |
wpbakery-get-template | Read | Read one native saved or default template and authoring compatibility. | template_id, source |
wpbakery-apply-template | Write | Replace page content with a validated native local/default template. | post_id, expected_hash, template_id, source |
wpbakery-get-settings | Read | Read enabled post types and native editor/template access; no global changes. | None |
wpbakery-list-revisions | Read | Read the latest 10 EMCP snapshots including content and page CSS. | post_id |
wpbakery-restore-revision | Write | Restore content and page CSS from an EMCP snapshot; preserves publication status. | post_id, expected_hash, revision_id |
wpbakery-publish-page | Write | Explicitly publish a validated WPBakery page. | post_id, expected_hash |
Example request
Section titled “Example request”Build a WPBakery draft using verified rows, columns, images and buttons. Keep CSS local, inspect recovery snapshots and show the native editor preview.
Read current state before editing and re-read after each save. If a hash is stale, inspect the changed document before rebuilding the request. A successful save is not proof of correct visual output: inspect the native editor and frontend.
Supported scope
Section titled “Supported scope”- Requires EMCP Pro and supported WPBakery. Native role and element restrictions still apply.
- Fifteen verified core types support authoring. Other installed schemas can be discovered.
- Remote library downloads, saved-template mutations, Grid Builder and global settings writes are excluded. Recovery uses EMCP snapshots.
Troubleshooting
Section titled “Troubleshooting”If tools are missing, check versions, dependencies, integration selection, tool switches and user capabilities. Reconnect long-lived MCP clients after plugin updates or selection changes. If output differs after saving, inspect the native document and styles before retrying; do not bypass the adapter with direct metadata writes.
See the WPBakery Page Builder integration overview, builder setup guide and agent skills.