@elementor/editor-canvas 4.3.0-1017 → 4.3.0-1019

package/dist/index.js

@@ -2466,11 +2466,11 @@ function getVal2(val) {
 var transformOriginTransformer = createTransformer((value) => {
   const x = getVal2(value.x);
   const y = getVal2(value.y);
-  const z4 = getVal2(value.z);
-  if (x === DEFAULT_XY && y === DEFAULT_XY && z4 === DEFAULT_Z) {
+  const z3 = getVal2(value.z);
+  if (x === DEFAULT_XY && y === DEFAULT_XY && z3 === DEFAULT_Z) {
     return null;
   }
-  return `${x} ${y} ${z4}`;
+  return `${x} ${y} ${z3}`;
 });
 
 // src/transformers/styles/transform-rotate-transformer.ts
@@ -4477,115 +4477,13 @@ function getElementDisplayName(container) {
   }
 }
 
-// src/mcp/tools/build-composition/tool.ts
-var import_editor_documents2 = require("@elementor/editor-documents");
-var import_editor_elements11 = require("@elementor/editor-elements");
-var import_http_client7 = require("@elementor/http-client");
-var import_schema = require("@elementor/schema");
-
-// src/mcp/utils/get-mcp-error-message.ts
-var import_http_client6 = require("@elementor/http-client");
-function getMcpErrorMessage(error, toolName) {
-  if (error instanceof import_http_client6.AxiosError) {
-    const data = error.response?.data;
-    if (data?.message) {
-      return data.code ? `${data.code}: ${data.message}` : data.message;
-    }
-  }
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return `${toolName} failed with an unknown error.`;
-}
-
-// src/mcp/tools/build-composition/tool.ts
-var MCP_PROXY_URL5 = "elementor/v1/mcp-proxy";
-var initBuildCompositionTool = (reg) => {
-  const { addTool } = reg;
-  addTool({
-    name: "build-composition",
-    description: "Build a V4 element composition on the Elementor canvas via the server-side MCP ability. Pass the raw XML tags directly as xmlStructure \u2014 do NOT wrap the value in <![CDATA[ ... ]]>, code fences, or quotes. The document is saved as a draft. Reload the editor after calling this tool to see the result.",
-    schema: {
-      xmlStructure: import_schema.z.string().describe(
-        'Valid XML structure with custom Elementor widget tags. Every element MUST have a unique configuration-id attribute (e.g. <e-heading configuration-id="hero-title"></e-heading>). No attributes, classes, IDs, or text nodes in XML. Pass raw XML \u2014 do not wrap in CDATA.'
-      ),
-      elementConfig: import_schema.z.record(
-        import_schema.z.string().describe("configuration-id"),
-        import_schema.z.record(import_schema.z.string().describe("property name"), import_schema.z.any().describe("PropValue"))
-      ).optional().describe("Map configuration-id \u2192 widget PropValues ($$type + value)."),
-      style: import_schema.z.record(
-        import_schema.z.string().describe("configuration-id"),
-        import_schema.z.record(import_schema.z.string().describe("CSS property name"), import_schema.z.string().describe("CSS value"))
-      ).optional().describe(
-        "Map configuration-id \u2192 raw CSS declarations (property \u2192 value strings; no selectors). Server converts to native styles; unconvertible declarations become the element custom CSS."
-      ),
-      parentId: import_schema.z.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at document root."),
-      mode: import_schema.z.enum(["append", "replace_children"]).optional().describe(
-        "'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
-      ),
-      dryRun: import_schema.z.boolean().optional().describe("If true, validate and return the resolved tree without persisting.")
-    },
-    outputSchema: {
-      rootElementIds: import_schema.z.array(import_schema.z.string()),
-      previewUrl: import_schema.z.string(),
-      version: import_schema.z.string(),
-      resolvedXml: import_schema.z.string(),
-      llmInstructions: import_schema.z.string(),
-      warnings: import_schema.z.array(import_schema.z.string()).optional(),
-      removedElementIds: import_schema.z.array(import_schema.z.string()).optional()
-    },
-    handler: async ({ xmlStructure, elementConfig, style, parentId, mode, dryRun }) => {
-      const document2 = (0, import_editor_documents2.getCurrentDocument)();
-      if (!document2?.id) {
-        throw new Error("No active document found.");
-      }
-      try {
-        const { data } = await (0, import_http_client7.httpService)().post(MCP_PROXY_URL5, {
-          tool: "build-composition",
-          input: {
-            post_id: document2.id,
-            xml_structure: xmlStructure,
-            element_config: elementConfig ?? {},
-            style: style ?? {},
-            parent_id: parentId ?? "document",
-            mode: mode ?? "append",
-            dry_run: dryRun ?? false
-          }
-        });
-        if (!dryRun) {
-          await (0, import_editor_documents2.reloadCurrentDocument)();
-          const [firstRootId] = data.data.root_element_ids;
-          if (firstRootId) {
-            (0, import_editor_elements11.selectElement)(firstRootId);
-            (0, import_editor_elements11.getContainer)(firstRootId)?.view?.el?.scrollIntoView({
-              behavior: "smooth",
-              block: "center"
-            });
-          }
-        }
-        return {
-          rootElementIds: data.data.root_element_ids,
-          previewUrl: data.data.preview_url,
-          version: data.data.version,
-          resolvedXml: data.data.resolved_xml,
-          llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings,
-          removedElementIds: data.data.removed_element_ids
-        };
-      } catch (error) {
-        throw new Error(getMcpErrorMessage(error, "build-composition"));
-      }
-    }
-  });
-};
-
 // src/mcp/tools/configure-element/tool.ts
-var import_editor_elements14 = require("@elementor/editor-elements");
+var import_editor_elements13 = require("@elementor/editor-elements");
 var import_editor_mcp3 = require("@elementor/editor-mcp");
 var import_editor_props7 = require("@elementor/editor-props");
 
 // src/mcp/utils/do-update-element-property.ts
-var import_editor_elements13 = require("@elementor/editor-elements");
+var import_editor_elements12 = require("@elementor/editor-elements");
 var import_editor_props6 = require("@elementor/editor-props");
 var import_editor_styles4 = require("@elementor/editor-styles");
 var import_editor_v1_adapters20 = require("@elementor/editor-v1-adapters");
@@ -4605,7 +4503,7 @@ var readStoredCustomCssText = (raw) => {
 };
 
 // src/mcp/utils/resolve-canonical-prop-name.ts
-var import_editor_elements12 = require("@elementor/editor-elements");
+var import_editor_elements11 = require("@elementor/editor-elements");
 function buildAliasToCanonicalMap(schema) {
   const aliasToCanonical = {};
   for (const [canonical, propType] of Object.entries(schema)) {
@@ -4622,14 +4520,14 @@ function buildAliasToCanonicalMap(schema) {
   return aliasToCanonical;
 }
 function resolveCanonicalPropName(elementType, propertyName) {
-  const schema = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
+  const schema = (0, import_editor_elements11.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
   if (!schema || schema[propertyName]) {
     return propertyName;
   }
   return buildAliasToCanonicalMap(schema)[propertyName] ?? propertyName;
 }
 function resolveCanonicalPropKeys(elementType, props) {
-  const schema = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
+  const schema = (0, import_editor_elements11.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
   if (!schema) {
     return { ...props };
   }
@@ -4751,7 +4649,7 @@ var doUpdateElementProperty = (params) => {
   const { elementId, propertyValue, elementType, customCssWriteMode = "replace" } = params;
   const propertyName = params.propertyName === "_styles" ? params.propertyName : resolveCanonicalPropName(elementType, params.propertyName);
   if (propertyName === "_styles") {
-    const elementStyles = (0, import_editor_elements13.getElementStyles)(elementId) || {};
+    const elementStyles = (0, import_editor_elements12.getElementStyles)(elementId) || {};
     const propertyMapValue = propertyValue;
     const styleSchema = (0, import_editor_styles4.getStylesSchema)();
     const transformedStyleValues = Object.fromEntries(
@@ -4808,7 +4706,7 @@ var doUpdateElementProperty = (params) => {
     });
     delete transformedStyleValues.custom_css;
     if (!localStyle) {
-      (0, import_editor_elements13.createElementStyle)({
+      (0, import_editor_elements12.createElementStyle)({
         elementId,
         ...typeof customCss !== "undefined" ? { custom_css: customCss } : {},
         classesProp: "classes",
@@ -4822,7 +4720,7 @@ var doUpdateElementProperty = (params) => {
         }
       });
     } else {
-      (0, import_editor_elements13.updateElementStyle)({
+      (0, import_editor_elements12.updateElementStyle)({
         elementId,
         styleId: localStyle.id,
         meta: {
@@ -4837,7 +4735,7 @@ var doUpdateElementProperty = (params) => {
     }
     return;
   }
-  const elementPropSchema = (0, import_editor_elements13.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
+  const elementPropSchema = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
   if (!elementPropSchema) {
     throw new Error(`No prop schema found for element type: ${elementType}`);
   }
@@ -4855,7 +4753,7 @@ var doUpdateElementProperty = (params) => {
 Expected Schema: ${jsonSchema}`
     );
   }
-  (0, import_editor_elements13.updateElementSettings)({
+  (0, import_editor_elements12.updateElementSettings)({
     id: elementId,
     props: {
       [propertyName]: value
@@ -4978,29 +4876,29 @@ Note: \`link\` is valid only when the element's PropType schema (which you must
 };
 
 // src/mcp/tools/configure-element/schema.ts
-var import_schema2 = require("@elementor/schema");
+var import_schema = require("@elementor/schema");
 var inputSchema = {
-  propertiesToChange: import_schema2.z.record(
-    import_schema2.z.string().describe("The property name."),
-    import_schema2.z.any().describe(`PropValue, refer to [${WIDGET_SCHEMA_URI}] by correct type, as appears in elementType`),
-    import_schema2.z.any()
+  propertiesToChange: import_schema.z.record(
+    import_schema.z.string().describe("The property name."),
+    import_schema.z.any().describe(`PropValue, refer to [${WIDGET_SCHEMA_URI}] by correct type, as appears in elementType`),
+    import_schema.z.any()
   ).describe("An object record containing property names and their new values to be set on the element"),
-  style: import_schema2.z.record(
-    import_schema2.z.string().describe('A CSS property name, e.g. "color", "margin-top".'),
-    import_schema2.z.string().nullable().describe(
+  style: import_schema.z.record(
+    import_schema.z.string().describe('A CSS property name, e.g. "color", "margin-top".'),
+    import_schema.z.string().nullable().describe(
       'A CSS value, e.g. "red", "10px", "1px solid #000". Use null to reset the property to its default.'
     )
   ).describe(
     "Raw CSS declarations as a flat property\u2192value map. Converted to native styles server-side; any declaration that cannot be converted is stored as the element custom CSS. A null value resets that property to its default."
   ).default({}),
-  elementType: import_schema2.z.string().describe("The type of the element to retrieve the schema"),
-  elementId: import_schema2.z.string().describe("The unique id of the element to configure")
+  elementType: import_schema.z.string().describe("The type of the element to retrieve the schema"),
+  elementId: import_schema.z.string().describe("The unique id of the element to configure")
 };
 var outputSchema = {
-  success: import_schema2.z.boolean().describe(
+  success: import_schema.z.boolean().describe(
     "Whether the configuration change was successful, only if propertyName and propertyValue are provided"
   ),
-  warnings: import_schema2.z.string().describe(
+  warnings: import_schema.z.string().describe(
     'Non-fatal notices. Present when some props were skipped because they are not in the element schema (e.g. a "link" on a widget with no link prop). Other changes were still applied.'
   ).optional()
 };
@@ -5031,13 +4929,13 @@ var initConfigureElementTool = (reg) => {
       { description: "Dynamic tags catalog", uri: DYNAMIC_TAGS_URI }
     ],
     handler: async ({ elementId, propertiesToChange, elementType, style }) => {
-      const widgetData = (0, import_editor_elements14.getWidgetsCache)()?.[elementType];
+      const widgetData = (0, import_editor_elements13.getWidgetsCache)()?.[elementType];
       if (!widgetData) {
         throw new Error(
           `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
         );
       }
-      const container = (0, import_editor_elements14.getContainer)(elementId);
+      const container = (0, import_editor_elements13.getContainer)(elementId);
       if (!container) {
         throw new Error(`Element with id ${elementId} not found`);
       }
@@ -5137,36 +5035,53 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }
 
 // src/mcp/tools/get-page-structure/tool.ts
-var import_editor_documents3 = require("@elementor/editor-documents");
-var import_http_client8 = require("@elementor/http-client");
-var import_schema4 = require("@elementor/schema");
-var MCP_PROXY_URL6 = "elementor/v1/mcp-proxy";
+var import_editor_documents2 = require("@elementor/editor-documents");
+var import_http_client7 = require("@elementor/http-client");
+var import_schema3 = require("@elementor/schema");
+
+// src/mcp/utils/get-mcp-error-message.ts
+var import_http_client6 = require("@elementor/http-client");
+function getMcpErrorMessage(error, toolName) {
+  if (error instanceof import_http_client6.AxiosError) {
+    const data = error.response?.data;
+    if (data?.message) {
+      return data.code ? `${data.code}: ${data.message}` : data.message;
+    }
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return `${toolName} failed with an unknown error.`;
+}
+
+// src/mcp/tools/get-page-structure/tool.ts
+var MCP_PROXY_URL5 = "elementor/v1/mcp-proxy";
 var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
     name: "get-page-structure",
     description: "Returns a lean Elementor element tree skeleton (id, elType, widgetType, title, nested elements) for a post or page. If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. Set includeContent=true (requires elementId) to also return each node's settings and styles.",
     schema: {
-      postId: import_schema4.z.number().optional().describe(
+      postId: import_schema3.z.number().optional().describe(
         "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
       ),
-      elementId: import_schema4.z.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
-      includeContent: import_schema4.z.boolean().optional().describe(
+      elementId: import_schema3.z.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
+      includeContent: import_schema3.z.boolean().optional().describe(
         "If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
       )
     },
     outputSchema: {
-      elements: import_schema4.z.array(import_schema4.z.any()).describe(
+      elements: import_schema3.z.array(import_schema3.z.any()).describe(
         "Skeleton of Elementor elements (id, elType, widgetType, title, nested elements). When includeContent is true, each node also includes settings and styles."
       )
     },
     handler: async ({ postId, elementId, includeContent }) => {
-      const resolvedPostId = postId ?? (0, import_editor_documents3.getCurrentDocument)()?.id;
+      const resolvedPostId = postId ?? (0, import_editor_documents2.getCurrentDocument)()?.id;
       if (!resolvedPostId) {
         throw new Error("No post ID provided and no active document found.");
       }
       try {
-        const { data } = await (0, import_http_client8.httpService)().post(MCP_PROXY_URL6, {
+        const { data } = await (0, import_http_client7.httpService)().post(MCP_PROXY_URL5, {
           tool: "get-page-structure",
           input: {
             post_id: resolvedPostId,
@@ -5196,7 +5111,6 @@ var initCanvasMcp = (reg) => {
   initGeneralContextResource(reg);
   initBestPracticesResource(reg);
   initConfigureElementTool(reg);
-  initBuildCompositionTool(reg);
   initGetPageStructureTool(reg);
   initBreakpointsResource(reg);
 };
@@ -5204,7 +5118,7 @@ var initCanvasMcp = (reg) => {
 // src/mcp/mcp-description.ts
 var ELEMENT_SCHEMA_URI = WIDGET_SCHEMA_URI.replace("{widgetType}", "element-schema");
 var mcpDescription = `Elementor Canvas MCP
-This MCP enables creation, configuration, and styling of elements on the Elementor canvas using the build_composition tool.
+This MCP enables configuration and styling of existing V4 elements on the Elementor canvas using the configure-element tool.
 
 # Core Concepts
 
@@ -5223,66 +5137,54 @@ The \`$$type\` defines how Elementor interprets the value. Providing the correct
 - **Global Classes**: Reusable style sets that can be applied to elements (\`elementor://global-classes\`)
 - **Widget Schemas**: Configuration options for each widget type (\`${WIDGET_SCHEMA_URI}\`)
 
-# Building Compositions with build_composition
+# Configuring Elements with configure-element
 
-The \`build_composition\` tool is the primary way to create elements. It accepts structure (XML), configuration, and styling in a single operation.
+The \`configure-element\` tool updates settings and styles on existing V4 elements. Read the configure-element guide resource before use.
 
 ## Complete Workflow
 
 ### 1. Parse User Requirements
-Understand what needs to be built: structure, content, and styling.
+Understand what needs to change: content, settings, or styling on existing elements.
 
 ### 2. Check Global Resources FIRST
-Always check existing resources before building:
+Always check existing resources before styling:
 - List \`elementor://global-variables\` for available variables (colors, sizes, fonts)
 - List \`elementor://global-classes\` for available style sets
 - **Always prefer using existing global resources over creating inline styles**
 
 ### 3. Retrieve Widget Schemas
-For each widget you'll use:
+For each element you will configure:
 - List \`${WIDGET_SCHEMA_URI}\` to see available widgets
 - Retrieve configuration schema from \`${ELEMENT_SCHEMA_URI}\` for each widget
-- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\` (omit default_settings from elementConfig unless the user asks to change them)
+- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\`
 
-### 4. Build XML Structure
-Create valid XML with configuration-ids:
-- Each element must have a unique \`configuration-id\` attribute
-- No text nodes, classes, or IDs in XML - structure only
-- Example:
-\`\`\`xml
-<e-container configuration-id="container-1">
-  <e-heading configuration-id="heading-1" />
-  <e-text configuration-id="text-1" />
-</e-container>
-\`\`\`
+### 4. Get Current Element State
+Use page structure and element configuration resources to find element IDs and current values.
 
-### 5. Create elementConfig
-Map each configuration-id to its widget properties using PropValues:
+### 5. Create propertiesToChange
+Map property names to PropValues using the widget schema:
 - Use correct \`$$type\` matching the widget's schema
 - Use global variables in PropValues where applicable
 - Example:
 \`\`\`json
 {
-  "heading-1": {
-    "text": { "$$type": "string", "value": "Welcome" },
-    "tag": { "$$type": "string", "value": "h1" }
-  }
+  "text": { "$$type": "string", "value": "Welcome" },
+  "tag": { "$$type": "string", "value": "h1" }
 }
 \`\`\`
 
 ### 6. Create style
-Map each configuration-id to raw CSS declarations (property \u2192 value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
+Provide raw CSS declarations (property \u2192 value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
 - Example:
 \`\`\`json
 {
-  "heading-1": "color: #1a1a1a; font-size: 2rem;"
-  }
+  "color": "#1a1a1a",
+  "font-size": "2rem"
 }
 \`\`\`
 
-### 7. Execute build_composition
-Call the tool with your XML structure, elementConfig, and style. The response will contain the created element IDs.
-At the response you will also find llm_instructions for you to do afterwards, read and follow them!
+### 7. Execute configure-element
+Call the tool with elementId, elementType, propertiesToChange, and style as needed.
 
 ## Key Points
 
@@ -5310,7 +5212,7 @@ Note: The "size" property controls image resolution/loading, not visual size. Se
 `;
 
 // src/prevent-link-in-link-commands.ts
-var import_editor_elements15 = require("@elementor/editor-elements");
+var import_editor_elements14 = require("@elementor/editor-elements");
 var import_editor_notifications3 = require("@elementor/editor-notifications");
 var import_editor_v1_adapters21 = require("@elementor/editor-v1-adapters");
 var import_i18n4 = require("@wordpress/i18n");
@@ -5381,24 +5283,24 @@ function shouldBlock(sourceElements, targetElements) {
     return false;
   }
   const isSourceContainsAnAnchor = sourceElements.some((src) => {
-    return src?.id ? (0, import_editor_elements15.isElementAnchored)(src.id) || !!(0, import_editor_elements15.getAnchoredDescendantId)(src.id) : false;
+    return src?.id ? (0, import_editor_elements14.isElementAnchored)(src.id) || !!(0, import_editor_elements14.getAnchoredDescendantId)(src.id) : false;
   });
   if (!isSourceContainsAnAnchor) {
     return false;
   }
   const isTargetContainsAnAnchor = targetElements.some((target) => {
-    return target?.id ? (0, import_editor_elements15.isElementAnchored)(target.id) || !!(0, import_editor_elements15.getAnchoredAncestorId)(target.id) : false;
+    return target?.id ? (0, import_editor_elements14.isElementAnchored)(target.id) || !!(0, import_editor_elements14.getAnchoredAncestorId)(target.id) : false;
   });
   return isTargetContainsAnAnchor;
 }
 
 // src/style-commands/paste-style.ts
-var import_editor_elements18 = require("@elementor/editor-elements");
+var import_editor_elements17 = require("@elementor/editor-elements");
 var import_editor_props10 = require("@elementor/editor-props");
 var import_editor_v1_adapters23 = require("@elementor/editor-v1-adapters");
 
 // src/utils/command-utils.ts
-var import_editor_elements16 = require("@elementor/editor-elements");
+var import_editor_elements15 = require("@elementor/editor-elements");
 var import_editor_props9 = require("@elementor/editor-props");
 var import_i18n5 = require("@wordpress/i18n");
 function hasAtomicWidgets(args) {
@@ -5423,7 +5325,7 @@ function getClassesProp(container) {
 }
 function getContainerSchema(container) {
   const type = container?.model.get("widgetType") || container?.model.get("elType");
-  const widgetsCache = (0, import_editor_elements16.getWidgetsCache)();
+  const widgetsCache = (0, import_editor_elements15.getWidgetsCache)();
   const elementType = widgetsCache?.[type];
   return elementType?.atomic_props_schema ?? null;
 }
@@ -5436,11 +5338,11 @@ function getClipboardElements(storageKey = "clipboard") {
   }
 }
 function getTitleForContainers(containers) {
-  return containers.length > 1 ? (0, import_i18n5.__)("Elements", "elementor") : (0, import_editor_elements16.getElementLabel)(containers[0].id);
+  return containers.length > 1 ? (0, import_i18n5.__)("Elements", "elementor") : (0, import_editor_elements15.getElementLabel)(containers[0].id);
 }
 
 // src/style-commands/undoable-actions/paste-element-style.ts
-var import_editor_elements17 = require("@elementor/editor-elements");
+var import_editor_elements16 = require("@elementor/editor-elements");
 var import_editor_styles_repository4 = require("@elementor/editor-styles-repository");
 var import_editor_v1_adapters22 = require("@elementor/editor-v1-adapters");
 var import_i18n6 = require("@wordpress/i18n");
@@ -5453,7 +5355,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         if (!classesProp) {
           return null;
         }
-        const originalStyles = (0, import_editor_elements17.getElementStyles)(container.id);
+        const originalStyles = (0, import_editor_elements16.getElementStyles)(container.id);
         const [styleId, styleDef] = Object.entries(originalStyles ?? {})[0] ?? [];
         const originalStyle = Object.keys(styleDef ?? {}).length ? styleDef : null;
         const revertData = {
@@ -5462,7 +5364,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         };
         if (styleId) {
           newStyle.variants.forEach(({ meta, props, custom_css: customCss }) => {
-            (0, import_editor_elements17.updateElementStyle)({
+            (0, import_editor_elements16.updateElementStyle)({
               elementId,
               styleId,
               meta,
@@ -5473,7 +5375,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         } else {
           const [firstVariant] = newStyle.variants;
           const additionalVariants = newStyle.variants.slice(1);
-          revertData.styleId = (0, import_editor_elements17.createElementStyle)({
+          revertData.styleId = (0, import_editor_elements16.createElementStyle)({
             elementId,
             classesProp,
             label: import_editor_styles_repository4.ELEMENTS_STYLES_RESERVED_LABEL,
@@ -5491,7 +5393,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
           return;
         }
         if (!revertData.originalStyle) {
-          (0, import_editor_elements17.deleteElementStyle)(container.id, revertData.styleId);
+          (0, import_editor_elements16.deleteElementStyle)(container.id, revertData.styleId);
           return;
         }
         const classesProp = getClassesProp(container);
@@ -5500,7 +5402,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         }
         const [firstVariant] = revertData.originalStyle.variants;
         const additionalVariants = revertData.originalStyle.variants.slice(1);
-        (0, import_editor_elements17.createElementStyle)({
+        (0, import_editor_elements16.createElementStyle)({
           elementId: container.id,
           classesProp,
           label: import_editor_styles_repository4.ELEMENTS_STYLES_RESERVED_LABEL,
@@ -5537,7 +5439,7 @@ function pasteStyles(args, pasteLocalStyle) {
   }
   const clipboardElements = getClipboardElements(storageKey);
   const [clipboardElement] = clipboardElements ?? [];
-  const clipboardContainer = (0, import_editor_elements18.getContainer)(clipboardElement.id);
+  const clipboardContainer = (0, import_editor_elements17.getContainer)(clipboardElement.id);
   if (!clipboardElement || !clipboardContainer || !isAtomicWidget(clipboardContainer)) {
     return;
   }
@@ -5556,7 +5458,7 @@ function getClassesWithoutLocalStyle(clipboardContainer, style) {
   if (!classesProp) {
     return [];
   }
-  const classesSetting = (0, import_editor_elements18.getElementSetting)(clipboardContainer.id, classesProp);
+  const classesSetting = (0, import_editor_elements17.getElementSetting)(clipboardContainer.id, classesProp);
   return classesSetting?.value.filter((styleId) => styleId !== style?.id) ?? [];
 }
 function pasteClasses(containers, classes) {
@@ -5565,10 +5467,10 @@ function pasteClasses(containers, classes) {
     if (!classesProp) {
       return;
     }
-    const classesSetting = (0, import_editor_elements18.getElementSetting)(container.id, classesProp);
+    const classesSetting = (0, import_editor_elements17.getElementSetting)(container.id, classesProp);
     const currentClasses = import_editor_props10.classesPropTypeUtil.extract(classesSetting) ?? [];
     const newClasses = import_editor_props10.classesPropTypeUtil.create(Array.from(/* @__PURE__ */ new Set([...classes, ...currentClasses])));
-    (0, import_editor_elements18.updateElementSettings)({
+    (0, import_editor_elements17.updateElementSettings)({
       id: container.id,
       props: { [classesProp]: newClasses }
     });
@@ -5579,7 +5481,7 @@ function pasteClasses(containers, classes) {
 var import_editor_v1_adapters25 = require("@elementor/editor-v1-adapters");
 
 // src/style-commands/undoable-actions/reset-element-style.ts
-var import_editor_elements19 = require("@elementor/editor-elements");
+var import_editor_elements18 = require("@elementor/editor-elements");
 var import_editor_styles_repository5 = require("@elementor/editor-styles-repository");
 var import_editor_v1_adapters24 = require("@elementor/editor-v1-adapters");
 var import_i18n7 = require("@wordpress/i18n");
@@ -5588,9 +5490,9 @@ var undoableResetElementStyle = () => (0, import_editor_v1_adapters24.undoable)(
     do: ({ containers }) => {
       return containers.map((container) => {
         const elementId = container.model.get("id");
-        const containerStyles = (0, import_editor_elements19.getElementStyles)(elementId);
+        const containerStyles = (0, import_editor_elements18.getElementStyles)(elementId);
         Object.keys(containerStyles ?? {}).forEach(
-          (styleId) => (0, import_editor_elements19.deleteElementStyle)(elementId, styleId)
+          (styleId) => (0, import_editor_elements18.deleteElementStyle)(elementId, styleId)
         );
         return containerStyles;
       });
@@ -5606,7 +5508,7 @@ var undoableResetElementStyle = () => (0, import_editor_v1_adapters24.undoable)(
         Object.entries(containerStyles ?? {}).forEach(([styleId, style]) => {
           const [firstVariant] = style.variants;
           const additionalVariants = style.variants.slice(1);
-          (0, import_editor_elements19.createElementStyle)({
+          (0, import_editor_elements18.createElementStyle)({
             elementId,
             classesProp,
             styleId,
@@ -5680,10 +5582,9 @@ function init() {
   initCanvasMcp(
     (0, import_editor_mcp4.getMCPByDomain)("canvas", {
       instructions: `Everything related to V4 ( Atomic ) canvas.
-# Canvas workflow for new compositions
-- Configure elements settings and styles
-- Build compositions/sections out of V4 atomic elements using context aware designs using the website resources
-- Get and retrieve element configuration values
+# Canvas workflow
+- Configure element settings and styles with configure-element
+- Get page structure and element configuration values
 `,
       docs: mcpDescription
     })
@@ -5806,10 +5707,10 @@ function useEscapeOnCanvas(canvasDocument, onEscape) {
 }
 
 // src/utils/after-render.ts
-var import_editor_elements20 = require("@elementor/editor-elements");
+var import_editor_elements19 = require("@elementor/editor-elements");
 function doAfterRender(elementIds, callback) {
   const pending = elementIds.map((elementId) => {
-    const view = (0, import_editor_elements20.getContainer)(elementId)?.view;
+    const view = (0, import_editor_elements19.getContainer)(elementId)?.view;
     if (!view || !hasDoAfterRender(view)) {
       return void 0;
     }

package/dist/index.mjs

@@ -2418,11 +2418,11 @@ function getVal2(val) {
 var transformOriginTransformer = createTransformer((value) => {
   const x = getVal2(value.x);
   const y = getVal2(value.y);
-  const z4 = getVal2(value.z);
-  if (x === DEFAULT_XY && y === DEFAULT_XY && z4 === DEFAULT_Z) {
+  const z3 = getVal2(value.z);
+  if (x === DEFAULT_XY && y === DEFAULT_XY && z3 === DEFAULT_Z) {
     return null;
   }
-  return `${x} ${y} ${z4}`;
+  return `${x} ${y} ${z3}`;
 });
 
 // src/transformers/styles/transform-rotate-transformer.ts
@@ -4443,110 +4443,8 @@ function getElementDisplayName(container) {
   }
 }
 
-// src/mcp/tools/build-composition/tool.ts
-import { getCurrentDocument, reloadCurrentDocument } from "@elementor/editor-documents";
-import { getContainer as getContainer4, selectElement } from "@elementor/editor-elements";
-import { httpService as httpService6 } from "@elementor/http-client";
-import { z } from "@elementor/schema";
-
-// src/mcp/utils/get-mcp-error-message.ts
-import { AxiosError } from "@elementor/http-client";
-function getMcpErrorMessage(error, toolName) {
-  if (error instanceof AxiosError) {
-    const data = error.response?.data;
-    if (data?.message) {
-      return data.code ? `${data.code}: ${data.message}` : data.message;
-    }
-  }
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return `${toolName} failed with an unknown error.`;
-}
-
-// src/mcp/tools/build-composition/tool.ts
-var MCP_PROXY_URL5 = "elementor/v1/mcp-proxy";
-var initBuildCompositionTool = (reg) => {
-  const { addTool } = reg;
-  addTool({
-    name: "build-composition",
-    description: "Build a V4 element composition on the Elementor canvas via the server-side MCP ability. Pass the raw XML tags directly as xmlStructure \u2014 do NOT wrap the value in <![CDATA[ ... ]]>, code fences, or quotes. The document is saved as a draft. Reload the editor after calling this tool to see the result.",
-    schema: {
-      xmlStructure: z.string().describe(
-        'Valid XML structure with custom Elementor widget tags. Every element MUST have a unique configuration-id attribute (e.g. <e-heading configuration-id="hero-title"></e-heading>). No attributes, classes, IDs, or text nodes in XML. Pass raw XML \u2014 do not wrap in CDATA.'
-      ),
-      elementConfig: z.record(
-        z.string().describe("configuration-id"),
-        z.record(z.string().describe("property name"), z.any().describe("PropValue"))
-      ).optional().describe("Map configuration-id \u2192 widget PropValues ($$type + value)."),
-      style: z.record(
-        z.string().describe("configuration-id"),
-        z.record(z.string().describe("CSS property name"), z.string().describe("CSS value"))
-      ).optional().describe(
-        "Map configuration-id \u2192 raw CSS declarations (property \u2192 value strings; no selectors). Server converts to native styles; unconvertible declarations become the element custom CSS."
-      ),
-      parentId: z.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at document root."),
-      mode: z.enum(["append", "replace_children"]).optional().describe(
-        "'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
-      ),
-      dryRun: z.boolean().optional().describe("If true, validate and return the resolved tree without persisting.")
-    },
-    outputSchema: {
-      rootElementIds: z.array(z.string()),
-      previewUrl: z.string(),
-      version: z.string(),
-      resolvedXml: z.string(),
-      llmInstructions: z.string(),
-      warnings: z.array(z.string()).optional(),
-      removedElementIds: z.array(z.string()).optional()
-    },
-    handler: async ({ xmlStructure, elementConfig, style, parentId, mode, dryRun }) => {
-      const document2 = getCurrentDocument();
-      if (!document2?.id) {
-        throw new Error("No active document found.");
-      }
-      try {
-        const { data } = await httpService6().post(MCP_PROXY_URL5, {
-          tool: "build-composition",
-          input: {
-            post_id: document2.id,
-            xml_structure: xmlStructure,
-            element_config: elementConfig ?? {},
-            style: style ?? {},
-            parent_id: parentId ?? "document",
-            mode: mode ?? "append",
-            dry_run: dryRun ?? false
-          }
-        });
-        if (!dryRun) {
-          await reloadCurrentDocument();
-          const [firstRootId] = data.data.root_element_ids;
-          if (firstRootId) {
-            selectElement(firstRootId);
-            getContainer4(firstRootId)?.view?.el?.scrollIntoView({
-              behavior: "smooth",
-              block: "center"
-            });
-          }
-        }
-        return {
-          rootElementIds: data.data.root_element_ids,
-          previewUrl: data.data.preview_url,
-          version: data.data.version,
-          resolvedXml: data.data.resolved_xml,
-          llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings,
-          removedElementIds: data.data.removed_element_ids
-        };
-      } catch (error) {
-        throw new Error(getMcpErrorMessage(error, "build-composition"));
-      }
-    }
-  });
-};
-
 // src/mcp/tools/configure-element/tool.ts
-import { getContainer as getContainer5, getWidgetsCache as getWidgetsCache6 } from "@elementor/editor-elements";
+import { getContainer as getContainer4, getWidgetsCache as getWidgetsCache6 } from "@elementor/editor-elements";
 import { dispatchMcpStylesAppliedEvent } from "@elementor/editor-mcp";
 import { Schema as Schema2 } from "@elementor/editor-props";
 
@@ -4950,29 +4848,29 @@ Note: \`link\` is valid only when the element's PropType schema (which you must
 };
 
 // src/mcp/tools/configure-element/schema.ts
-import { z as z2 } from "@elementor/schema";
+import { z } from "@elementor/schema";
 var inputSchema = {
-  propertiesToChange: z2.record(
-    z2.string().describe("The property name."),
-    z2.any().describe(`PropValue, refer to [${WIDGET_SCHEMA_URI}] by correct type, as appears in elementType`),
-    z2.any()
+  propertiesToChange: z.record(
+    z.string().describe("The property name."),
+    z.any().describe(`PropValue, refer to [${WIDGET_SCHEMA_URI}] by correct type, as appears in elementType`),
+    z.any()
   ).describe("An object record containing property names and their new values to be set on the element"),
-  style: z2.record(
-    z2.string().describe('A CSS property name, e.g. "color", "margin-top".'),
-    z2.string().nullable().describe(
+  style: z.record(
+    z.string().describe('A CSS property name, e.g. "color", "margin-top".'),
+    z.string().nullable().describe(
       'A CSS value, e.g. "red", "10px", "1px solid #000". Use null to reset the property to its default.'
     )
   ).describe(
     "Raw CSS declarations as a flat property\u2192value map. Converted to native styles server-side; any declaration that cannot be converted is stored as the element custom CSS. A null value resets that property to its default."
   ).default({}),
-  elementType: z2.string().describe("The type of the element to retrieve the schema"),
-  elementId: z2.string().describe("The unique id of the element to configure")
+  elementType: z.string().describe("The type of the element to retrieve the schema"),
+  elementId: z.string().describe("The unique id of the element to configure")
 };
 var outputSchema = {
-  success: z2.boolean().describe(
+  success: z.boolean().describe(
     "Whether the configuration change was successful, only if propertyName and propertyValue are provided"
   ),
-  warnings: z2.string().describe(
+  warnings: z.string().describe(
     'Non-fatal notices. Present when some props were skipped because they are not in the element schema (e.g. a "link" on a widget with no link prop). Other changes were still applied.'
   ).optional()
 };
@@ -5009,7 +4907,7 @@ var initConfigureElementTool = (reg) => {
           `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
         );
       }
-      const container = getContainer5(elementId);
+      const container = getContainer4(elementId);
       if (!container) {
         throw new Error(`Element with id ${elementId} not found`);
       }
@@ -5109,36 +5007,53 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }
 
 // src/mcp/tools/get-page-structure/tool.ts
-import { getCurrentDocument as getCurrentDocument2 } from "@elementor/editor-documents";
-import { httpService as httpService7 } from "@elementor/http-client";
-import { z as z3 } from "@elementor/schema";
-var MCP_PROXY_URL6 = "elementor/v1/mcp-proxy";
+import { getCurrentDocument } from "@elementor/editor-documents";
+import { httpService as httpService6 } from "@elementor/http-client";
+import { z as z2 } from "@elementor/schema";
+
+// src/mcp/utils/get-mcp-error-message.ts
+import { AxiosError } from "@elementor/http-client";
+function getMcpErrorMessage(error, toolName) {
+  if (error instanceof AxiosError) {
+    const data = error.response?.data;
+    if (data?.message) {
+      return data.code ? `${data.code}: ${data.message}` : data.message;
+    }
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return `${toolName} failed with an unknown error.`;
+}
+
+// src/mcp/tools/get-page-structure/tool.ts
+var MCP_PROXY_URL5 = "elementor/v1/mcp-proxy";
 var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
     name: "get-page-structure",
     description: "Returns a lean Elementor element tree skeleton (id, elType, widgetType, title, nested elements) for a post or page. If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. Set includeContent=true (requires elementId) to also return each node's settings and styles.",
     schema: {
-      postId: z3.number().optional().describe(
+      postId: z2.number().optional().describe(
         "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
       ),
-      elementId: z3.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
-      includeContent: z3.boolean().optional().describe(
+      elementId: z2.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
+      includeContent: z2.boolean().optional().describe(
         "If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
       )
     },
     outputSchema: {
-      elements: z3.array(z3.any()).describe(
+      elements: z2.array(z2.any()).describe(
         "Skeleton of Elementor elements (id, elType, widgetType, title, nested elements). When includeContent is true, each node also includes settings and styles."
       )
     },
     handler: async ({ postId, elementId, includeContent }) => {
-      const resolvedPostId = postId ?? getCurrentDocument2()?.id;
+      const resolvedPostId = postId ?? getCurrentDocument()?.id;
       if (!resolvedPostId) {
         throw new Error("No post ID provided and no active document found.");
       }
       try {
-        const { data } = await httpService7().post(MCP_PROXY_URL6, {
+        const { data } = await httpService6().post(MCP_PROXY_URL5, {
           tool: "get-page-structure",
           input: {
             post_id: resolvedPostId,
@@ -5168,7 +5083,6 @@ var initCanvasMcp = (reg) => {
   initGeneralContextResource(reg);
   initBestPracticesResource(reg);
   initConfigureElementTool(reg);
-  initBuildCompositionTool(reg);
   initGetPageStructureTool(reg);
   initBreakpointsResource(reg);
 };
@@ -5176,7 +5090,7 @@ var initCanvasMcp = (reg) => {
 // src/mcp/mcp-description.ts
 var ELEMENT_SCHEMA_URI = WIDGET_SCHEMA_URI.replace("{widgetType}", "element-schema");
 var mcpDescription = `Elementor Canvas MCP
-This MCP enables creation, configuration, and styling of elements on the Elementor canvas using the build_composition tool.
+This MCP enables configuration and styling of existing V4 elements on the Elementor canvas using the configure-element tool.
 
 # Core Concepts
 
@@ -5195,66 +5109,54 @@ The \`$$type\` defines how Elementor interprets the value. Providing the correct
 - **Global Classes**: Reusable style sets that can be applied to elements (\`elementor://global-classes\`)
 - **Widget Schemas**: Configuration options for each widget type (\`${WIDGET_SCHEMA_URI}\`)
 
-# Building Compositions with build_composition
+# Configuring Elements with configure-element
 
-The \`build_composition\` tool is the primary way to create elements. It accepts structure (XML), configuration, and styling in a single operation.
+The \`configure-element\` tool updates settings and styles on existing V4 elements. Read the configure-element guide resource before use.
 
 ## Complete Workflow
 
 ### 1. Parse User Requirements
-Understand what needs to be built: structure, content, and styling.
+Understand what needs to change: content, settings, or styling on existing elements.
 
 ### 2. Check Global Resources FIRST
-Always check existing resources before building:
+Always check existing resources before styling:
 - List \`elementor://global-variables\` for available variables (colors, sizes, fonts)
 - List \`elementor://global-classes\` for available style sets
 - **Always prefer using existing global resources over creating inline styles**
 
 ### 3. Retrieve Widget Schemas
-For each widget you'll use:
+For each element you will configure:
 - List \`${WIDGET_SCHEMA_URI}\` to see available widgets
 - Retrieve configuration schema from \`${ELEMENT_SCHEMA_URI}\` for each widget
-- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\` (omit default_settings from elementConfig unless the user asks to change them)
+- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\`
 
-### 4. Build XML Structure
-Create valid XML with configuration-ids:
-- Each element must have a unique \`configuration-id\` attribute
-- No text nodes, classes, or IDs in XML - structure only
-- Example:
-\`\`\`xml
-<e-container configuration-id="container-1">
-  <e-heading configuration-id="heading-1" />
-  <e-text configuration-id="text-1" />
-</e-container>
-\`\`\`
+### 4. Get Current Element State
+Use page structure and element configuration resources to find element IDs and current values.
 
-### 5. Create elementConfig
-Map each configuration-id to its widget properties using PropValues:
+### 5. Create propertiesToChange
+Map property names to PropValues using the widget schema:
 - Use correct \`$$type\` matching the widget's schema
 - Use global variables in PropValues where applicable
 - Example:
 \`\`\`json
 {
-  "heading-1": {
-    "text": { "$$type": "string", "value": "Welcome" },
-    "tag": { "$$type": "string", "value": "h1" }
-  }
+  "text": { "$$type": "string", "value": "Welcome" },
+  "tag": { "$$type": "string", "value": "h1" }
 }
 \`\`\`
 
 ### 6. Create style
-Map each configuration-id to raw CSS declarations (property \u2192 value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
+Provide raw CSS declarations (property \u2192 value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
 - Example:
 \`\`\`json
 {
-  "heading-1": "color: #1a1a1a; font-size: 2rem;"
-  }
+  "color": "#1a1a1a",
+  "font-size": "2rem"
 }
 \`\`\`
 
-### 7. Execute build_composition
-Call the tool with your XML structure, elementConfig, and style. The response will contain the created element IDs.
-At the response you will also find llm_instructions for you to do afterwards, read and follow them!
+### 7. Execute configure-element
+Call the tool with elementId, elementType, propertiesToChange, and style as needed.
 
 ## Key Points
 
@@ -5369,7 +5271,7 @@ function shouldBlock(sourceElements, targetElements) {
 }
 
 // src/style-commands/paste-style.ts
-import { getContainer as getContainer6, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
+import { getContainer as getContainer5, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
 import { classesPropTypeUtil } from "@elementor/editor-props";
 import {
   __privateListenTo as listenTo5,
@@ -5522,7 +5424,7 @@ function pasteStyles(args, pasteLocalStyle) {
   }
   const clipboardElements = getClipboardElements(storageKey);
   const [clipboardElement] = clipboardElements ?? [];
-  const clipboardContainer = getContainer6(clipboardElement.id);
+  const clipboardContainer = getContainer5(clipboardElement.id);
   if (!clipboardElement || !clipboardContainer || !isAtomicWidget(clipboardContainer)) {
     return;
   }
@@ -5669,10 +5571,9 @@ function init() {
   initCanvasMcp(
     getMCPByDomain("canvas", {
       instructions: `Everything related to V4 ( Atomic ) canvas.
-# Canvas workflow for new compositions
-- Configure elements settings and styles
-- Build compositions/sections out of V4 atomic elements using context aware designs using the website resources
-- Get and retrieve element configuration values
+# Canvas workflow
+- Configure element settings and styles with configure-element
+- Get page structure and element configuration values
 `,
       docs: mcpDescription
     })
@@ -5799,10 +5700,10 @@ function useEscapeOnCanvas(canvasDocument, onEscape) {
 }
 
 // src/utils/after-render.ts
-import { getContainer as getContainer7 } from "@elementor/editor-elements";
+import { getContainer as getContainer6 } from "@elementor/editor-elements";
 function doAfterRender(elementIds, callback) {
   const pending = elementIds.map((elementId) => {
-    const view = getContainer7(elementId)?.view;
+    const view = getContainer6(elementId)?.view;
     if (!view || !hasDoAfterRender(view)) {
       return void 0;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/editor-canvas",
   "description": "Elementor Editor Canvas",
-  "version": "4.3.0-1017",
+  "version": "4.3.0-1019",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,26 +37,26 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "4.3.0-1017",
-    "@elementor/editor-controls": "4.3.0-1017",
-    "@elementor/editor-documents": "4.3.0-1017",
-    "@elementor/editor-elements": "4.3.0-1017",
-    "@elementor/editor-interactions": "4.3.0-1017",
-    "@elementor/editor-mcp": "4.3.0-1017",
-    "@elementor/editor-notifications": "4.3.0-1017",
-    "@elementor/editor-props": "4.3.0-1017",
-    "@elementor/editor-responsive": "4.3.0-1017",
-    "@elementor/editor-styles": "4.3.0-1017",
-    "@elementor/editor-styles-repository": "4.3.0-1017",
-    "@elementor/editor-ui": "4.3.0-1017",
-    "@elementor/editor-v1-adapters": "4.3.0-1017",
-    "@elementor/events": "4.3.0-1017",
-    "@elementor/http-client": "4.3.0-1017",
-    "@elementor/schema": "4.3.0-1017",
-    "@elementor/twing": "4.3.0-1017",
+    "@elementor/editor": "4.3.0-1019",
+    "@elementor/editor-controls": "4.3.0-1019",
+    "@elementor/editor-documents": "4.3.0-1019",
+    "@elementor/editor-elements": "4.3.0-1019",
+    "@elementor/editor-interactions": "4.3.0-1019",
+    "@elementor/editor-mcp": "4.3.0-1019",
+    "@elementor/editor-notifications": "4.3.0-1019",
+    "@elementor/editor-props": "4.3.0-1019",
+    "@elementor/editor-responsive": "4.3.0-1019",
+    "@elementor/editor-styles": "4.3.0-1019",
+    "@elementor/editor-styles-repository": "4.3.0-1019",
+    "@elementor/editor-ui": "4.3.0-1019",
+    "@elementor/editor-v1-adapters": "4.3.0-1019",
+    "@elementor/events": "4.3.0-1019",
+    "@elementor/http-client": "4.3.0-1019",
+    "@elementor/schema": "4.3.0-1019",
+    "@elementor/twing": "4.3.0-1019",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.3.0-1017",
-    "@elementor/wp-media": "4.3.0-1017",
+    "@elementor/utils": "4.3.0-1019",
+    "@elementor/wp-media": "4.3.0-1019",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0",
     "dompurify": "^3.2.6"

package/src/init.tsx

@@ -54,10 +54,9 @@ export function init() {
 	initCanvasMcp(
 		getMCPByDomain( 'canvas', {
 			instructions: `Everything related to V4 ( Atomic ) canvas.
-# Canvas workflow for new compositions
-- Configure elements settings and styles
-- Build compositions/sections out of V4 atomic elements using context aware designs using the website resources
-- Get and retrieve element configuration values
+# Canvas workflow
+- Configure element settings and styles with configure-element
+- Get page structure and element configuration values
 `,
 			docs: mcpDescription,
 		} )

package/src/mcp/canvas-mcp.ts

@@ -10,7 +10,6 @@ import { initEditorStateResource } from './resources/editor-state-resource';
 import { initGeneralContextResource } from './resources/general-context-resource';
 import { initSelectedElementResource } from './resources/selected-element-resource';
 import { initWidgetsSchemaResource } from './resources/widgets-schema-resource';
-import { initBuildCompositionTool } from './tools/build-composition/tool';
 import { initConfigureElementTool } from './tools/configure-element/tool';
 import { initGetPageStructureTool } from './tools/get-page-structure/tool';
 import { getDynamicTagNamesByCategories } from './utils/resolve-dynamic-tag';
@@ -29,7 +28,6 @@ export const initCanvasMcp = ( reg: MCPRegistryEntry ) => {
 	initGeneralContextResource( reg );
 	initBestPracticesResource( reg );
 	initConfigureElementTool( reg );
-	initBuildCompositionTool( reg );
 	initGetPageStructureTool( reg );
 	initBreakpointsResource( reg );
 };

package/src/mcp/mcp-description.ts

@@ -3,7 +3,7 @@ import { WIDGET_SCHEMA_URI } from './resources/widgets-schema-resource';
 const ELEMENT_SCHEMA_URI = WIDGET_SCHEMA_URI.replace( '{widgetType}', 'element-schema' );
 
 export const mcpDescription = `Elementor Canvas MCP
-This MCP enables creation, configuration, and styling of elements on the Elementor canvas using the build_composition tool.
+This MCP enables configuration and styling of existing V4 elements on the Elementor canvas using the configure-element tool.
 
 # Core Concepts
 
@@ -22,66 +22,54 @@ The \`$$type\` defines how Elementor interprets the value. Providing the correct
 - **Global Classes**: Reusable style sets that can be applied to elements (\`elementor://global-classes\`)
 - **Widget Schemas**: Configuration options for each widget type (\`${ WIDGET_SCHEMA_URI }\`)
 
-# Building Compositions with build_composition
+# Configuring Elements with configure-element
 
-The \`build_composition\` tool is the primary way to create elements. It accepts structure (XML), configuration, and styling in a single operation.
+The \`configure-element\` tool updates settings and styles on existing V4 elements. Read the configure-element guide resource before use.
 
 ## Complete Workflow
 
 ### 1. Parse User Requirements
-Understand what needs to be built: structure, content, and styling.
+Understand what needs to change: content, settings, or styling on existing elements.
 
 ### 2. Check Global Resources FIRST
-Always check existing resources before building:
+Always check existing resources before styling:
 - List \`elementor://global-variables\` for available variables (colors, sizes, fonts)
 - List \`elementor://global-classes\` for available style sets
 - **Always prefer using existing global resources over creating inline styles**
 
 ### 3. Retrieve Widget Schemas
-For each widget you'll use:
+For each element you will configure:
 - List \`${ WIDGET_SCHEMA_URI }\` to see available widgets
 - Retrieve configuration schema from \`${ ELEMENT_SCHEMA_URI }\` for each widget
-- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\` (omit default_settings from elementConfig unless the user asks to change them)
+- Check the \`llm_guidance\` property for container nesting, \`default_styles\`, and \`default_settings\`
 
-### 4. Build XML Structure
-Create valid XML with configuration-ids:
-- Each element must have a unique \`configuration-id\` attribute
-- No text nodes, classes, or IDs in XML - structure only
-- Example:
-\`\`\`xml
-<e-container configuration-id="container-1">
-  <e-heading configuration-id="heading-1" />
-  <e-text configuration-id="text-1" />
-</e-container>
-\`\`\`
+### 4. Get Current Element State
+Use page structure and element configuration resources to find element IDs and current values.
 
-### 5. Create elementConfig
-Map each configuration-id to its widget properties using PropValues:
+### 5. Create propertiesToChange
+Map property names to PropValues using the widget schema:
 - Use correct \`$$type\` matching the widget's schema
 - Use global variables in PropValues where applicable
 - Example:
 \`\`\`json
 {
-  "heading-1": {
-    "text": { "$$type": "string", "value": "Welcome" },
-    "tag": { "$$type": "string", "value": "h1" }
-  }
+  "text": { "$$type": "string", "value": "Welcome" },
+  "tag": { "$$type": "string", "value": "h1" }
 }
 \`\`\`
 
 ### 6. Create style
-Map each configuration-id to raw CSS declarations (property → value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
+Provide raw CSS declarations (property → value strings). The server converts them to native styles and stores any unconvertible declarations as the element custom CSS.
 - Example:
 \`\`\`json
 {
-  "heading-1": "color: #1a1a1a; font-size: 2rem;"
-  }
+  "color": "#1a1a1a",
+  "font-size": "2rem"
 }
 \`\`\`
 
-### 7. Execute build_composition
-Call the tool with your XML structure, elementConfig, and style. The response will contain the created element IDs.
-At the response you will also find llm_instructions for you to do afterwards, read and follow them!
+### 7. Execute configure-element
+Call the tool with elementId, elementType, propertiesToChange, and style as needed.
 
 ## Key Points
 

package/src/mcp/tools/build-composition/tool.ts

@@ -1,130 +0,0 @@
-import { getCurrentDocument, reloadCurrentDocument } from '@elementor/editor-documents';
-import { getContainer, selectElement } from '@elementor/editor-elements';
-import { type MCPRegistryEntry } from '@elementor/editor-mcp';
-import { type HttpResponse, httpService } from '@elementor/http-client';
-import { z } from '@elementor/schema';
-
-import { getMcpErrorMessage } from '../../utils/get-mcp-error-message';
-
-const MCP_PROXY_URL = 'elementor/v1/mcp-proxy';
-
-type BuildCompositionResponse = {
-	success: boolean;
-	post_id: number;
-	root_element_ids: string[];
-	preview_url: string;
-	version: string;
-	resolved_xml: string;
-	llm_instructions: string;
-	warnings?: string[];
-	removed_element_ids?: string[];
-};
-
-export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
-	const { addTool } = reg;
-
-	addTool( {
-		name: 'build-composition',
-		description:
-			'Build a V4 element composition on the Elementor canvas via the server-side MCP ability. ' +
-			'Pass the raw XML tags directly as xmlStructure — do NOT wrap the value in <![CDATA[ ... ]]>, ' +
-			'code fences, or quotes. The document is saved as a draft. Reload the editor after calling ' +
-			'this tool to see the result.',
-		schema: {
-			xmlStructure: z
-				.string()
-				.describe(
-					'Valid XML structure with custom Elementor widget tags. Every element MUST have a unique ' +
-						'configuration-id attribute (e.g. <e-heading configuration-id="hero-title"></e-heading>). ' +
-						'No attributes, classes, IDs, or text nodes in XML. Pass raw XML — do not wrap in CDATA.'
-				),
-			elementConfig: z
-				.record(
-					z.string().describe( 'configuration-id' ),
-					z.record( z.string().describe( 'property name' ), z.any().describe( 'PropValue' ) )
-				)
-				.optional()
-				.describe( 'Map configuration-id → widget PropValues ($$type + value).' ),
-			style: z
-				.record(
-					z.string().describe( 'configuration-id' ),
-					z.record( z.string().describe( 'CSS property name' ), z.string().describe( 'CSS value' ) )
-				)
-				.optional()
-				.describe(
-					'Map configuration-id → raw CSS declarations (property → value strings; no selectors). ' +
-						'Server converts to native styles; unconvertible declarations become the element custom CSS.'
-				),
-			parentId: z
-				.string()
-				.optional()
-				.describe( "ID of the parent container. Omit or pass 'document' to insert at document root." ),
-			mode: z
-				.enum( [ 'append', 'replace_children' ] )
-				.optional()
-				.describe(
-					"'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
-				),
-			dryRun: z
-				.boolean()
-				.optional()
-				.describe( 'If true, validate and return the resolved tree without persisting.' ),
-		},
-		outputSchema: {
-			rootElementIds: z.array( z.string() ),
-			previewUrl: z.string(),
-			version: z.string(),
-			resolvedXml: z.string(),
-			llmInstructions: z.string(),
-			warnings: z.array( z.string() ).optional(),
-			removedElementIds: z.array( z.string() ).optional(),
-		},
-		handler: async ( { xmlStructure, elementConfig, style, parentId, mode, dryRun } ) => {
-			const document = getCurrentDocument();
-
-			if ( ! document?.id ) {
-				throw new Error( 'No active document found.' );
-			}
-
-			try {
-				const { data } = await httpService().post< HttpResponse< BuildCompositionResponse > >( MCP_PROXY_URL, {
-					tool: 'build-composition',
-					input: {
-						post_id: document.id,
-						xml_structure: xmlStructure,
-						element_config: elementConfig ?? {},
-						style: style ?? {},
-						parent_id: parentId ?? 'document',
-						mode: mode ?? 'append',
-						dry_run: dryRun ?? false,
-					},
-				} );
-
-				if ( ! dryRun ) {
-					await reloadCurrentDocument();
-
-					const [ firstRootId ] = data.data.root_element_ids;
-					if ( firstRootId ) {
-						selectElement( firstRootId );
-						getContainer( firstRootId )?.view?.el?.scrollIntoView( {
-							behavior: 'smooth',
-							block: 'center',
-						} );
-					}
-				}
-
-				return {
-					rootElementIds: data.data.root_element_ids,
-					previewUrl: data.data.preview_url,
-					version: data.data.version,
-					resolvedXml: data.data.resolved_xml,
-					llmInstructions: data.data.llm_instructions,
-					warnings: data.data.warnings,
-					removedElementIds: data.data.removed_element_ids,
-				};
-			} catch ( error ) {
-				throw new Error( getMcpErrorMessage( error, 'build-composition' ) );
-			}
-		},
-	} );
-};