Beaver Builder MCP tools
Available in EMCP 3.17.0. EMCP Pro works with Beaver Builder’s native rows, columns and modules. Inspect installed module schemas, create a draft and stage layout changes through the native save process. Explicit publication separates the editable draft from what visitors see.
Requirements and setup
Section titled “Requirements and setup”- Check installed versions. Beaver Builder 2.11.1 through 2.11.x, tested with Pro 2.11.1. 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”Incremental node edits, page-local styles, reusable template creation and detached template application have dedicated tools. Native asset generation runs through the builder save lifecycle. Fifteen core module types are verified for authoring; the discovery catalog can contain more.
Read module and node schemas
Section titled “Read module and node schemas”Inspect the catalog, node hierarchy and page state.
Stage the layout and styles
Section titled “Stage the layout and styles”Edit native nodes, save local CSS and reuse detached templates.
Publish after review
Section titled “Publish after review”Inspect editor, frontend and recovery state before publication.
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 |
|---|---|---|---|
beaver-get-context | Read | Read version, supported scope, edition and optional Themer availability. | None |
beaver-list-modules | Read | Discover installed module types and whether they support authoring. | None |
beaver-get-module-schema | Read | Read native module form fields and defaults. | type |
beaver-get-node-schema | Read | Read row or column controls and defaults. | type |
beaver-list-pages | Read | List accessible pages and native builder state. | None |
beaver-get-page | Read | Read staged and published native nodes, settings and hash without changing the draft. | post_id |
beaver-create-page | Write | Create an empty WordPress draft with Beaver Builder enabled. | title |
beaver-set-page-layout | Write | Validate and replace the native draft node map; does not publish. | post_id, expected_hash, nodes |
beaver-add-node | Write | Add one native node with a unique ID and sibling position to the draft. | post_id, expected_hash, node |
beaver-update-node | Write | Merge named settings into a draft node; nested setting values replace as a whole. | post_id, expected_hash, node_id, settings |
beaver-move-node | Write | Move a node and descendants to an allowed parent and unused sibling position. | post_id, expected_hash, node_id, parent_id, position |
beaver-remove-node | Write | Remove a node and descendants from the draft. | post_id, expected_hash, node_id |
beaver-get-page-styles | Read | Read published and draft page-local CSS. | post_id |
beaver-set-page-styles | Write | Stage page-local CSS, preserving other layout settings. | post_id, expected_hash, css |
beaver-get-design-system | Read | Read native responsive breakpoints and layout spacing defaults; no global writes. | None |
beaver-list-library | Read | Discover saved layouts, rows, columns, modules and optional Themer documents. | None |
beaver-get-library-item | Read | Read a permitted local library document and whether it can be applied as a detached layout. | post_id |
beaver-save-template | Write | Create a local non-global full-layout template from the current draft. | post_id, expected_hash, name |
beaver-apply-template | Write | Copy an accessible local full-layout template into the page draft; shared references are rejected. | post_id, expected_hash, template_id |
beaver-list-revisions | Read | Read the latest ten EMCP draft snapshots. | post_id |
beaver-restore-revision | Write | Restore an EMCP content/CSS snapshot to the draft without publishing. | post_id, expected_hash, revision_id |
beaver-publish-page | Write | Publish staged native nodes and settings, regenerate assets and publish the WordPress page. | post_id, expected_hash |
Example request
Section titled “Example request”Create a Beaver Builder draft for a small hotel using verified modules. Stage responsive styles and save a detached reusable template after review.
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 Beaver Builder; live authoring was verified with Pro 2.11.1.
- Fifteen core module types are authorable. Optional Themer, linked/global and dynamic references remain read-only.
- Detached template application does not authorize changing shared or global references.
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 Beaver Builder integration overview, builder setup guide and agent skills.