README

Adwise_McpHyvaCms

Extension module for Adwise_Mcp that adds Hyvä CMS guidance, prompts, and page editing tools.

Installation

composer require adwise/magento2-mcp-hyva-cms
bin/magento module:enable Adwise_McpHyvaCms
bin/magento setup:upgrade

Tools

• hyva_cms_component_list - list installed Hyvä CMS components, optionally with field definitions.
• hyva_cms_component_get - fetch one component declaration, fields, variants, children support, and example JSON.
• hyva_cms_page_list - list CMS pages with Hyvä Liveview status.
• hyva_cms_page_get - fetch a CMS page and its Hyvä draft/published content.
• hyva_cms_page_get_raw - fetch stored Hyvä JSON without decoding.
• hyva_cms_page_validate - validate Hyvä CMS JSON without saving.
• hyva_cms_page_create - create a Magento CMS page and optionally create/enable its Hyvä CMS Liveview record.
• hyva_cms_page_update - update draft and/or published Hyvä CMS JSON content and settings.
• hyva_cms_page_publish / hyva_cms_page_unpublish - explicit publishing controls.
• hyva_cms_page_preview_url - get frontend/admin URLs for QA.
• hyva_cms_page_render_check - fetch frontend URL and detect HTTP/template/component errors.
• hyva_cms_page_clone - clone CMS pages and optionally Hyvä content.

Resources

• hyva-cms://guidance
• hyva-cms://liveview-content-format
• hyva-cms://components

Prompts

• hyva_cms_edit_page
• hyva_cms_create_component_json

Recommended edit flow

1. Read hyva-cms://guidance and hyva-cms://liveview-content-format.
2. Use hyva_cms_page_list to find the page, or hyva_cms_page_create when the page does not exist.
3. Use hyva_cms_page_get with decode_json=true.
4. Make the smallest JSON change possible.
5. Use hyva_cms_page_update with draft_content.
6. Only pass publish_draft=true when explicitly asked to publish.
7. Component children arrays contain nested component objects, not UID strings.
8. Spacer sizes are stored in rem, not pixels. Convert px to rem first, e.g. 24px = 1.5, not 24.
9. Avoid raw HTML/code block components unless explicitly requested; prefer structured Hyvä CMS components.