Kirki 6 MCP tools
Available in EMCP 3.17.0. This integration targets Kirki 6’s visual page builder. EMCP Pro works with its native element graph and separate style blocks, creating canvas drafts and staging changes before explicit publication. It is not a general adapter for older Customizer-only installations.
Requirements and setup
Section titled “Requirements and setup”- Check installed versions. Kirki 6.3.1 through 6.3.x with the native visual builder. 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”Read the design system and installed viewports before styling. Library discovery covers templates, header and footer symbols, popups and utility pages in their native envelopes. Content Manager collections and fields are discoverable, while CMS schema changes remain outside page authoring.
Discover graphs and viewports
Section titled “Discover graphs and viewports”Inspect starter elements, local styles and native breakpoints.
Save a staged canvas
Section titled “Save a staged canvas”Build native elements and page-local style blocks, then read the latest stage.
Publish the reviewed version
Section titled “Publish the reviewed version”Check native editor and frontend output before publishing.
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 |
|---|---|---|---|
kirki-get-context | Read | Read site, installed versions, permissions and integration scope. | None |
kirki-list-elements | Read | Read the verified native starter element catalog. | None |
kirki-get-element-schema | Read | Read starter data and native graph/style contracts. | type |
kirki-list-pages | Read | List accessible WordPress pages and Kirki editor state. | None |
kirki-get-page | Read | Read the latest native graph, local styles, staged versions and content hash. | post_id |
kirki-create-page | Write | Create a native Kirki canvas draft. | title |
kirki-set-page-content | Write | Save a validated native graph and local styles to staging; does not publish. | post_id, expected_hash, blocks |
kirki-add-element | Write | Append one native element to an existing parent and stage the result. | post_id, expected_hash, parent_id, element |
kirki-update-element | Write | Merge top-level native properties into one element and stage the result. | post_id, expected_hash, element_id, properties |
kirki-set-page-styles | Write | Replace page-local responsive style blocks and stage the result. | post_id, expected_hash, styles |
kirki-get-design-system | Read | Read global classes, variables, viewports and registered fonts. | None |
kirki-publish-page | Write | Publish the latest staged native content and the WordPress page. | post_id, expected_hash |
kirki-restore-version | Write | Restore a known native version into a new unpublished stage. | post_id, expected_hash, version |
kirki-list-library | Read | Discover local components, header/footer symbols, templates, popups and utility pages. | None |
kirki-get-library-item | Read | Read a local library document in its native envelope and its template conditions. | post_id |
kirki-get-page-settings | Read | Read page identity, SEO and disabled header/footer symbols. | post_id |
kirki-set-page-canvas | Write | Switch a Kirki page between full canvas and the default theme template. | post_id, expected_hash, full_canvas |
kirki-list-collections | Read | Discover Content Manager collections through its native API. | None |
kirki-get-collection | Read | Read a collection definition and its native fields. | collection_id |
Example request
Section titled “Example request”Create a Kirki canvas draft with feature cards and a contact section. Use installed mobile viewports, save to staging and leave publication for 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, supported Kirki 6 visual builder and native full access.
- Shared library editing, global assignments, CMS schema writes, app installation and external form submissions are excluded.
- Symbols use a different envelope from page graphs. Discovery does not make them editable page documents.
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 Kirki 6 integration overview, builder setup guide and agent skills.