Oxygen 6 MCP tools
Available in EMCP 3.17.0. Oxygen 6 support extends beyond editing a page tree. EMCP Pro exposes templates and matching conditions, header and footer layouts, component definitions and overrides, global design data, revisions and Design Library workflows. Each area has its own tools and permissions.
Requirements and setup
Section titled “Requirements and setup”- Check installed versions. Oxygen 6.1.3 through 6.1.x in Oxygen mode. 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”Discover exposed component properties, place instances and use supported overrides. Create or copy templates that remain disabled until explicitly enabled. Design transfers remap document and design dependencies, while separate hashes protect global selectors and variables from stale updates.
Inspect the design model
Section titled “Inspect the design model”Read elements, components, template conditions, variables and selectors.
Build the reusable design
Section titled “Build the reusable design”Create a draft, disabled template or component workflow using scoped tools.
Verify matching and dependencies
Section titled “Verify matching and dependencies”Inspect assignments, revisions and native output before enabling a template.
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 |
|---|---|---|---|
oxygen-configure-design-library | Write | Update sharing flags, registered provider URLs or password using the current library hash. Passwords are never returned. | expected_hash |
oxygen-browse-design-library | Read | Fetch the catalog of a registered provider through safe HTTP. | provider_index |
oxygen-export-design-library | Read | Export selected local IDs and dependencies, with variables and selectors. Set provider_index for a remote set and template_ids for remote library record IDs. Up to 100 documents. | post_ids |
oxygen-import-design-library | Write | Import an exported bundle with dependency and design ID remapping. Pages are drafts and templates disabled. Pass both target design hashes and a unique request_id; replay returns the original result, including any partial failure and recovery revisions. Class selectors are namespaced; global selectors require separate explicit design editing. | bundle, bundle_hash, variables_hash, selectors_hash, request_id |
oxygen-get-dynamic-schema | Read | Discover installed dynamic fields and interaction triggers/actions with native controls. | None |
oxygen-set-native-document | Write | Save a complete native tree including code, loops, interactions and installed extension elements. Requires unfiltered_html and full builder access; native schemas, nesting, references and revisions are checked. Executable controls run with the site privileges. | post_id, expected_hash, tree |
oxygen-manage-document | Write | Rename, trash or restore a page or native library item. Requires the current document hash; get-page can read trashed records. | post_id, expected_hash, operation |
oxygen-get-design-state | Read | Read an entire native design scope and its independent hash. | scope |
oxygen-get-global-schema | Read | Read installed global controls, preferences and native selector CSS mapping. | None |
oxygen-save-design-state | Write | Replace a native global design scope, including collections. Requires current scope hash and unfiltered_html; affects all site usages and creates a complete prior-document revision. | scope, data, expected_hash |
oxygen-list-design-revisions | Read | List complete prior design documents saved by EMCP, including collections and preferences. | None |
oxygen-restore-design-revision | Write | Restore a complete prior global document with the current scope hash. Creates a new revision before restoration. | revision_id, expected_hash |
oxygen-get-component-properties | Read | Read exposed properties and defaults from a component master. | component_id |
oxygen-define-component-property | Write | Expose a native control or child visibility on a component element. Replaces the definition with the same key. | post_id, expected_hash, element_id, key, path, label |
oxygen-get-condition-values | Read | Search native selectable values for a registered condition. | slug |
oxygen-list-revisions | Read | Read native Oxygen revisions for an editable document. | post_id |
oxygen-restore-revision | Write | Restore a native tree revision belonging to this document. Optionally restore an EMCP template-settings snapshot; otherwise preserve current settings. Advanced trees require unfiltered_html. | post_id, expected_hash, revision_id |
oxygen-insert-component | Write | Insert an existing component with optional exposed-property overrides. Cyclic references are rejected. | post_id, expected_hash, component_id |
oxygen-get-template-schema | Read | Read native template locations and supported settings for templates, headers and footers. | None |
oxygen-create-template | Write | Create a native template, header, footer or component. Oxygen publishes library records; templates start disabled. Edit its tree with the page/element tools. | title, kind |
oxygen-update-template-settings | Write | Patch location, priority, disabled state, ruleGroups and parentId using the page content_hash. Omitted settings are preserved. Enabling changes site-wide template matching. | post_id, expected_hash, settings |
oxygen-get-design-library | Read | Read registered design-set URLs and local library settings without revealing passwords or fetching remote sets. | None |
oxygen-copy-library-item | Write | Copy a readable local page, template, header, footer or component. Pages become drafts; Oxygen publishes library records. Template matching is disabled on the copy. Classes and component references remain shared. | source_id, expected_hash, title |
oxygen-get-context | Read | Read installed version, permissions, breakpoints and supported workflow. Start here. | None |
oxygen-list-elements | Read | List registered native element types and nesting rules. Use set-native-document for advanced elements. | None |
oxygen-get-element-schema | Read | Read native controls, defaults and nesting rules for an exact namespaced type, e.g. OxygenElements\Text. | type |
oxygen-list-pages | Read | List editable WordPress pages and their Oxygen status. | None |
oxygen-get-page | Read | Read the native nested tree and content_hash for a page or existing template. | post_id |
oxygen-create-page | Write | Create an empty draft using the native Oxygen tree format. | title |
oxygen-set-page-tree | Write | Replace a page tree with root, _nextNodeId and nested nodes. Requires expected_hash; preserves template settings and page status. | post_id, expected_hash, tree |
oxygen-add-element | Write | Add a childless native element, allocating a unique ID. Read schema/defaults first; default parent is root 1. | post_id, expected_hash, type |
oxygen-update-element | Write | Recursively merge named property groups while replacing lists and preserving other properties. Optional label changes its friendly name. | post_id, expected_hash, element_id, properties |
oxygen-move-element | Write | Move a node and descendants to a parent and sibling position; rejects cycles and invalid nesting. | post_id, expected_hash, element_id, parent_id |
oxygen-remove-element | Write | Remove a node and its entire subtree; root cannot be removed. | post_id, expected_hash, element_id |
oxygen-get-style-schema | Read | Read supported native class style paths, value shapes and breakpoint layout. | None |
oxygen-save-class | Write | Create or replace one native CSS class. Requires full access, edit_theme_options and current design-system content_hash. Existing class changes affect every use. | expected_hash, name, properties |
oxygen-list-templates | Read | List editable templates, headers, footers and components. Read get-page for native settings and tree. | None |
oxygen-get-design-system | Read | Read global settings, native classes, variables, collections and breakpoints, plus content_hash for save-class. | None |
Example request
Section titled “Example request”Inspect my Oxygen components and design tokens, then build a draft services page. Create a disabled footer template scoped to that page and show its conditions before enabling it.
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 Oxygen 6. Oxygen Classic and Breakdance mode use different data and are excluded.
- Advanced native-document, global and import writes require additional capabilities. Executable controls are privileged.
- Design transfer does not migrate media files, menus, custom fields or homepage settings. Review imported conditions before enabling templates.
- Local export/import was tested through MCP; third-party provider imports were not live-verified for this release.
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 Oxygen 6 integration overview, builder setup guide and agent skills.