Otter Blocks MCP tools
Available in EMCP 3.17.0. Otter discovery reads the block registry installed on your site. Free and Pro blocks share tools for pages, block editing, local patterns, styles and supported feature settings. The adapter is part of EMCP Pro; Otter Pro is only needed for the vendor’s premium features.
Requirements and setup
Section titled “Requirements and setup”- Check installed versions. Otter 3.2.5 through 3.2.x; Otter Pro optional. EMCP Pro is required.
- Enable the integration. Open EMCP Tools > Page Builders and enable this Gutenberg pack independently.
- 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”Static blocks require attributes and saved HTML. EMCP saves them together and can regenerate Otter CSS after changes. Locally registered patterns are discoverable and insertable. Atomic Wind uses a separate browser CSS compiler, so its utilities require native browser validation.
Discover installed blocks
Section titled “Discover installed blocks”Read the catalog, exact attributes and existing mixed Gutenberg content.
Prepare native content
Section titled “Prepare native content”Insert blocks or replace one complete serialized block using the current page hash.
Validate in Gutenberg
Section titled “Validate in Gutenberg”Check saved markup, frontend styles and responsive output in the native editor.
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 |
|---|---|---|---|
otter-get-context | Read | Read native Free/Pro availability and independent Gutenberg integration status. | None |
otter-list-blocks | Read | List installed Otter and Atomic Wind blocks; optional search. | None |
otter-get-block-schema | Read | Read the installed native attribute schema, parent requirements and static markup contract. | name |
otter-get-features | Read | Discover native visibility, dynamic data, animations, sticky, CSS and Pro feature availability. No credentials or submissions. | None |
otter-create-page | Write | Create an empty draft Gutenberg page. | title |
otter-get-post-blocks | Read | Read complete mixed Gutenberg markup, block paths and content hash. | post_id |
otter-set-page-blocks | Write | Replace page content with complete serialized Gutenberg blocks containing Otter blocks. Preserve native save markup; confirmation required. | post_id, expected_hash, markup, confirm |
otter-publish-page | Write | Explicitly publish a page after reviewing its saved blocks and styles. | post_id, expected_hash, confirm |
otter-add-block | Write | Insert one complete serialized Otter block, including its saved HTML and nested blocks. | post_id, expected_hash, markup |
otter-update-block | Write | Replace one Otter block with complete serialized native markup, including children. | post_id, expected_hash, path, markup |
otter-move-block | Write | Move an Otter block within a mixed Gutenberg tree. | post_id, expected_hash, path, position |
otter-remove-block | Write | Remove one Otter block and its children. | post_id, expected_hash, path |
otter-list-patterns | Read | List locally registered Otter patterns. Does not fetch remote libraries. | None |
otter-get-pattern | Read | Read registered native pattern markup before insertion or adaptation. | name |
otter-insert-pattern | Write | Insert registered pattern markup with regenerated Otter IDs; unavailable blocks are rejected. Remote images are not downloaded. | post_id, expected_hash, name |
otter-get-page-styles | Read | Read native generated CSS and stylesheet URL. | post_id |
otter-rebuild-page-styles | Write | Regenerate page CSS from native attributes using the installed Otter compiler. | post_id, expected_hash |
otter-get-settings | Read | Read allowlisted feature switches and their settings hash. Requires manage_options. | None |
otter-update-settings | Write | Update allowlisted boolean feature switches. Requires manage_options and settings hash; changes apply on the next request. | expected_hash, settings |
Example request
Section titled “Example request”Build an Otter draft for a cafe with headings, columns and an accordion. Include Pro Business Hours if registered, rebuild CSS and validate the saved blocks in Gutenberg.
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 Otter 3.2.5 through 3.2.x. Otter Pro is optional.
- Tested 3.2.5 registries exposed 45 blocks with Free and 63 with Pro; your catalog may differ.
- Payments, credentials, submission records, remote template sync and WooCommerce template assignments are excluded.
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 Otter Blocks integration overview, builder setup guide and agent skills.