Gutenberg MCP tools for AI agents

Detect which page builder is active on the site and get its version, support level (Full Intelligence / Smart Defaults / Basic), available modules/widgets, and capabilities. Call this first before working with builder content to understand what format to use.

Extract the full structured content from a page as builder-native JSON. Use this to see the complete page layout with all sections, columns, and widgets. For targeted searches, prefer find_element (faster). For a lightweight overview, prefer find_builder_targets. Returns the raw builder data structure that can be modified and passed back to inject_builder_content.

List all editable builder modules/blocks on a page with their types, labels, and text content — without returning the full builder JSON. Use this for a quick overview of what is on a page. For finding a specific element by text or class, use find_element instead.

REPLACE (or append to) the entire page builder layout. WARNING: By default this REPLACES all existing content — use mode:"append" to add content without destroying existing elements. For editing a single module, use wordpress_update_module instead. Use exactly: gutenberg, divi, elementor, bricks, beaver, oxygen, breakdance, brizy, thrive, visual-composer, wpbakery. For Divi, diviVersion is required ("4" or "5").

Update a specific module within a page builder page. Supports finding modules by admin_label, path, or type. Only updates the specified module while preserving all other content.

Apply Respira v2 builder patch operations (identifier by id/path/type+match_content).

Find an element in a page by ID, type, CSS class, or text content. This is the PRIMARY tool for locating content to edit — use it instead of searching the database or reading PHP files. Works with all 12 page builders. Use identifier_type "content" to search by visible text (e.g. find a heading containing "2025" to update a year). Returns matching element(s) with their position, settings, and element ID for use with update_element.

Update settings or content on a specific element in a page. This is the PRIMARY tool for making content changes — use it for text edits, style changes, image swaps, link updates, etc. Works with all 12 page builders. First use find_element to locate the element, then pass the same identifier here with the updates object containing the new values.

Move an element to a different container or position within the page.

Duplicate an element in a page. The copy is inserted immediately after the original.

Remove an element from a page.

Reorder child elements within a container.

Convert HTML into native page builder content. Extracts CSS styles, maps sections to builder widgets, and creates a page with a fidelity report showing conversion accuracy.

Add a heading widget to a page.

Add a text/paragraph widget to a page.

Add a button widget to a page.

Add an image widget to a page.

Add a section container to a page.

Add a video widget to a page.

Add a divider/horizontal rule to a page.

Add vertical spacing to a page.

Add an icon widget to a page.

Add an icon list widget to a page.

Add social media icons to a page.

Add a contact form to a page.

Add a Google Maps widget to a page.

Add a number counter widget to a page.

Add a progress bar widget to a page.

Add a testimonial widget to a page.

Add a tabbed content widget to a page.

Add an accordion/FAQ widget to a page.

Add a toggle (collapsible content) widget to a page.

Add an alert/notice widget to a page.

Add a raw HTML widget to a page.

Add a sidebar widget area to a page.

Add a search form widget to a page.

Add an image gallery widget to a page.

Add an image/content slider to a page.

Add a pricing table widget to a page.

Search for a stock image, download it to the Media Library, and add it as an image widget to a page — all in one call. Builder-agnostic: works with Elementor, Bricks, Beaver Builder, etc. Saves 3 separate tool calls.