@elementor/editor-canvas 4.3.0-1002 → 4.3.0-1004

package/dist/index.js

@@ -116,13 +116,13 @@ var initWidgetsSchemaResource = (reg) => {
       if (!widgetType) {
         throw new Error("No widget type provided.");
       }
-      const schema2 = await fetchWidgetSchema(widgetType);
+      const schema = await fetchWidgetSchema(widgetType);
       return {
         contents: [
           {
             uri: uri.toString(),
             mimeType: "application/json",
-            text: JSON.stringify(schema2)
+            text: JSON.stringify(schema)
           }
         ]
       };
@@ -1310,10 +1310,10 @@ var getMultiPropsValue = (multiProps) => {
 // src/renderers/create-props-resolver.ts
 var TRANSFORM_DEPTH_LIMIT = 3;
 function createPropsResolver({ transformers, schema: initialSchema, onPropResolve }) {
-  async function resolve({ props, schema: schema2, signal, renderContext }) {
-    schema2 = schema2 ?? initialSchema;
+  async function resolve({ props, schema, signal, renderContext }) {
+    schema = schema ?? initialSchema;
     const promises = Promise.all(
-      Object.entries(schema2).map(async ([key, type]) => {
+      Object.entries(schema).map(async ([key, type]) => {
         const value = props[key] ?? type.default;
         const transformed = await transform({ value, key, type, signal, renderContext });
         onPropResolve?.({ key, value: transformed, propValue: value, propType: type });
@@ -3961,7 +3961,7 @@ function initTabsModelExtensions() {
 }
 
 // src/mcp/canvas-mcp.ts
-var import_editor_props9 = require("@elementor/editor-props");
+var import_editor_props8 = require("@elementor/editor-props");
 
 // src/mcp/resources/available-widgets-resource.ts
 var import_http_client3 = require("@elementor/http-client");
@@ -4482,8 +4482,25 @@ 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_client6 = require("@elementor/http-client");
+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;
@@ -4505,6 +4522,9 @@ var initBuildCompositionTool = (reg) => {
         "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: {
@@ -4513,15 +4533,16 @@ var initBuildCompositionTool = (reg) => {
       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()
+      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, dryRun }) => {
+    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_client6.httpService)().post(MCP_PROXY_URL5, {
+        const { data } = await (0, import_http_client7.httpService)().post(MCP_PROXY_URL5, {
           tool: "build-composition",
           input: {
             post_id: document2.id,
@@ -4529,6 +4550,7 @@ var initBuildCompositionTool = (reg) => {
             element_config: elementConfig ?? {},
             style: style ?? {},
             parent_id: parentId ?? "document",
+            mode: mode ?? "append",
             dry_run: dryRun ?? false
           }
         });
@@ -4549,26 +4571,15 @@ var initBuildCompositionTool = (reg) => {
           version: data.data.version,
           resolvedXml: data.data.resolved_xml,
           llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings
+          warnings: data.data.warnings,
+          removedElementIds: data.data.removed_element_ids
         };
       } catch (error) {
-        throw new Error(getErrorMessage(error));
+        throw new Error(getMcpErrorMessage(error, "build-composition"));
       }
     }
   });
 };
-function getErrorMessage(error) {
-  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 "build-composition failed with an unknown error.";
-}
 
 // src/mcp/tools/configure-element/tool.ts
 var import_editor_elements14 = require("@elementor/editor-elements");
@@ -4597,9 +4608,9 @@ var readStoredCustomCssText = (raw) => {
 
 // src/mcp/utils/resolve-canonical-prop-name.ts
 var import_editor_elements12 = require("@elementor/editor-elements");
-function buildAliasToCanonicalMap(schema2) {
+function buildAliasToCanonicalMap(schema) {
   const aliasToCanonical = {};
-  for (const [canonical, propType] of Object.entries(schema2)) {
+  for (const [canonical, propType] of Object.entries(schema)) {
     const aliases = propType.meta?.aliases;
     if (!Array.isArray(aliases)) {
       continue;
@@ -4613,26 +4624,26 @@ function buildAliasToCanonicalMap(schema2) {
   return aliasToCanonical;
 }
 function resolveCanonicalPropName(elementType, propertyName) {
-  const schema2 = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
-  if (!schema2 || schema2[propertyName]) {
+  const schema = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
+  if (!schema || schema[propertyName]) {
     return propertyName;
   }
-  return buildAliasToCanonicalMap(schema2)[propertyName] ?? propertyName;
+  return buildAliasToCanonicalMap(schema)[propertyName] ?? propertyName;
 }
 function resolveCanonicalPropKeys(elementType, props) {
-  const schema2 = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
-  if (!schema2) {
+  const schema = (0, import_editor_elements12.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
+  if (!schema) {
     return { ...props };
   }
-  const aliasToCanonical = buildAliasToCanonicalMap(schema2);
+  const aliasToCanonical = buildAliasToCanonicalMap(schema);
   const resolved = {};
   for (const [key, value] of Object.entries(props)) {
-    if (schema2[key]) {
+    if (schema[key]) {
       resolved[key] = value;
     }
   }
   for (const [key, value] of Object.entries(props)) {
-    if (schema2[key]) {
+    if (schema[key]) {
       continue;
     }
     const canonical = aliasToCanonical[key];
@@ -4680,9 +4691,9 @@ var dynamicTagLLMResolver = (value) => {
     }
   };
 };
-var buildStrictSettings = (schema2, provided) => {
+var buildStrictSettings = (schema, provided) => {
   const settings = {};
-  for (const [key, propType] of Object.entries(schema2)) {
+  for (const [key, propType] of Object.entries(schema)) {
     if (OMITTED_DYNAMIC_SETTING_KEYS.includes(key)) {
       continue;
     }
@@ -5109,102 +5120,49 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }`;
 }
 
-// src/mcp/tools/get-element-config/tool.ts
-var import_editor_elements15 = require("@elementor/editor-elements");
-var import_editor_props8 = require("@elementor/editor-props");
+// 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 schema = {
-  elementId: import_schema4.z.string()
-};
-var outputSchema2 = {
-  properties: import_schema4.z.record(import_schema4.z.string(), import_schema4.z.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
-  style: import_schema4.z.record(import_schema4.z.string(), import_schema4.z.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
-  childElements: import_schema4.z.array(
-    import_schema4.z.object({
-      id: import_schema4.z.string(),
-      elementType: import_schema4.z.string(),
-      childElements: import_schema4.z.array(import_schema4.z.any()).describe("An array of child element IDs, when applicable, same structure recursively")
-    })
-  ).describe("An array of child element IDs, when applicable, with recursive structure")
-};
-var structuredElements = (element) => {
-  const children = element.children || [];
-  return children.map((child) => {
-    return {
-      id: child.id,
-      elementType: child.model.get("elType") || child.model.get("widgetType") || "unknown",
-      childElements: structuredElements(child)
-    };
-  });
-};
-var initGetElementConfigTool = (reg) => {
+var MCP_PROXY_URL6 = "elementor/v1/mcp-proxy";
+var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
-    name: "get-element-configuration-values",
-    description: "Retrieve the element's configuration PropValues for a specific element by unique ID.",
-    schema,
-    outputSchema: outputSchema2,
-    handler: async ({ elementId }) => {
-      const element = (0, import_editor_elements15.getContainer)(elementId);
-      if (!element) {
-        throw new Error(`Element with ID ${elementId} not found.`);
-      }
-      const elementType = element.model.get("widgetType") || element.model.get("elType") || "";
-      const widgetData = (0, import_editor_elements15.getWidgetsCache)()?.[elementType];
-      if (!widgetData) {
-        throw new Error(
-          `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
-        );
-      }
-      if (!widgetData.atomic_props_schema) {
-        throw new Error(
-          `This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${elementType}`
-        );
-      }
-      const elementRawSettings = element.settings;
-      const propSchema = (0, import_editor_elements15.getWidgetsCache)()?.[elementType]?.atomic_props_schema;
-      if (!elementRawSettings || !propSchema) {
-        throw new Error(`No settings or prop schema found for element ID: ${elementId}`);
+    name: "get-page-structure",
+    description: "Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.",
+    schema: {
+      postId: import_schema4.z.number().optional().describe(
+        "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
+      )
+    },
+    outputSchema: {
+      elements: import_schema4.z.array(import_schema4.z.any()).describe("Root-level Elementor elements for the document.")
+    },
+    handler: async ({ postId }) => {
+      const resolvedPostId = postId ?? (0, import_editor_documents3.getCurrentDocument)()?.id;
+      if (!resolvedPostId) {
+        throw new Error("No post ID provided and no active document found.");
       }
-      const propValues = {};
-      const stylePropValues = {};
-      import_editor_props8.Schema.configurableKeys(propSchema).forEach((key) => {
-        propValues[key] = structuredClone(elementRawSettings.get(key));
-      });
-      const elementStyles = (0, import_editor_elements15.getElementStyles)(elementId) || {};
-      const localStyle = Object.values(elementStyles).find((style) => style.label === "local");
-      if (localStyle) {
-        const defaultVariant = localStyle.variants.find(
-          (variant) => variant.meta.breakpoint === "desktop" && !variant.meta.state
-        );
-        if (defaultVariant) {
-          const styleProps = defaultVariant.props || {};
-          Object.keys(styleProps).forEach((stylePropName) => {
-            if (typeof styleProps[stylePropName] !== "undefined") {
-              stylePropValues[stylePropName] = structuredClone(styleProps[stylePropName]);
-            }
-          });
-          if (defaultVariant.custom_css) {
-            stylePropValues.custom_css = atob(defaultVariant.custom_css.raw);
+      try {
+        const { data } = await (0, import_http_client8.httpService)().post(MCP_PROXY_URL6, {
+          tool: "get-page-structure",
+          input: {
+            post_id: resolvedPostId
           }
-        }
+        });
+        return {
+          elements: data.data.elements
+        };
+      } catch (error) {
+        throw new Error(getMcpErrorMessage(error, "get-page-structure"));
       }
-      return {
-        properties: {
-          ...propValues
-        },
-        style: {
-          ...stylePropValues
-        },
-        childElements: structuredElements(element)
-      };
     }
   });
 };
 
 // src/mcp/canvas-mcp.ts
 var initCanvasMcp = (reg) => {
-  import_editor_props9.Schema.setDynamicTagNamesResolver(getDynamicTagNamesByCategories);
+  import_editor_props8.Schema.setDynamicTagNamesResolver(getDynamicTagNamesByCategories);
   initWidgetsSchemaResource(reg);
   initAvailableWidgetsResource(reg);
   initDocumentStructureResource(reg);
@@ -5213,9 +5171,9 @@ var initCanvasMcp = (reg) => {
   initEditorStateResource(reg);
   initGeneralContextResource(reg);
   initBestPracticesResource(reg);
-  initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
   initBuildCompositionTool(reg);
+  initGetPageStructureTool(reg);
   initBreakpointsResource(reg);
 };
 
@@ -5328,7 +5286,7 @@ Note: The "size" property controls image resolution/loading, not visual size. Se
 `;
 
 // src/prevent-link-in-link-commands.ts
-var import_editor_elements16 = require("@elementor/editor-elements");
+var import_editor_elements15 = 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");
@@ -5399,25 +5357,25 @@ function shouldBlock(sourceElements, targetElements) {
     return false;
   }
   const isSourceContainsAnAnchor = sourceElements.some((src) => {
-    return src?.id ? (0, import_editor_elements16.isElementAnchored)(src.id) || !!(0, import_editor_elements16.getAnchoredDescendantId)(src.id) : false;
+    return src?.id ? (0, import_editor_elements15.isElementAnchored)(src.id) || !!(0, import_editor_elements15.getAnchoredDescendantId)(src.id) : false;
   });
   if (!isSourceContainsAnAnchor) {
     return false;
   }
   const isTargetContainsAnAnchor = targetElements.some((target) => {
-    return target?.id ? (0, import_editor_elements16.isElementAnchored)(target.id) || !!(0, import_editor_elements16.getAnchoredAncestorId)(target.id) : false;
+    return target?.id ? (0, import_editor_elements15.isElementAnchored)(target.id) || !!(0, import_editor_elements15.getAnchoredAncestorId)(target.id) : false;
   });
   return isTargetContainsAnAnchor;
 }
 
 // src/style-commands/paste-style.ts
-var import_editor_elements19 = require("@elementor/editor-elements");
-var import_editor_props11 = require("@elementor/editor-props");
+var import_editor_elements18 = 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_elements17 = require("@elementor/editor-elements");
-var import_editor_props10 = require("@elementor/editor-props");
+var import_editor_elements16 = require("@elementor/editor-elements");
+var import_editor_props9 = require("@elementor/editor-props");
 var import_i18n5 = require("@wordpress/i18n");
 function hasAtomicWidgets(args) {
   const { containers = [args.container] } = args;
@@ -5435,13 +5393,13 @@ function getClassesProp(container) {
     return null;
   }
   const [propKey] = Object.entries(propsSchema).find(
-    ([, propType]) => propType.kind === "plain" && propType.key === import_editor_props10.CLASSES_PROP_KEY
+    ([, propType]) => propType.kind === "plain" && propType.key === import_editor_props9.CLASSES_PROP_KEY
   ) ?? [];
   return propKey ?? null;
 }
 function getContainerSchema(container) {
   const type = container?.model.get("widgetType") || container?.model.get("elType");
-  const widgetsCache = (0, import_editor_elements17.getWidgetsCache)();
+  const widgetsCache = (0, import_editor_elements16.getWidgetsCache)();
   const elementType = widgetsCache?.[type];
   return elementType?.atomic_props_schema ?? null;
 }
@@ -5454,11 +5412,11 @@ function getClipboardElements(storageKey = "clipboard") {
   }
 }
 function getTitleForContainers(containers) {
-  return containers.length > 1 ? (0, import_i18n5.__)("Elements", "elementor") : (0, import_editor_elements17.getElementLabel)(containers[0].id);
+  return containers.length > 1 ? (0, import_i18n5.__)("Elements", "elementor") : (0, import_editor_elements16.getElementLabel)(containers[0].id);
 }
 
 // src/style-commands/undoable-actions/paste-element-style.ts
-var import_editor_elements18 = require("@elementor/editor-elements");
+var import_editor_elements17 = 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");
@@ -5471,7 +5429,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         if (!classesProp) {
           return null;
         }
-        const originalStyles = (0, import_editor_elements18.getElementStyles)(container.id);
+        const originalStyles = (0, import_editor_elements17.getElementStyles)(container.id);
         const [styleId, styleDef] = Object.entries(originalStyles ?? {})[0] ?? [];
         const originalStyle = Object.keys(styleDef ?? {}).length ? styleDef : null;
         const revertData = {
@@ -5480,7 +5438,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         };
         if (styleId) {
           newStyle.variants.forEach(({ meta, props, custom_css: customCss }) => {
-            (0, import_editor_elements18.updateElementStyle)({
+            (0, import_editor_elements17.updateElementStyle)({
               elementId,
               styleId,
               meta,
@@ -5491,7 +5449,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_elements18.createElementStyle)({
+          revertData.styleId = (0, import_editor_elements17.createElementStyle)({
             elementId,
             classesProp,
             label: import_editor_styles_repository4.ELEMENTS_STYLES_RESERVED_LABEL,
@@ -5509,7 +5467,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
           return;
         }
         if (!revertData.originalStyle) {
-          (0, import_editor_elements18.deleteElementStyle)(container.id, revertData.styleId);
+          (0, import_editor_elements17.deleteElementStyle)(container.id, revertData.styleId);
           return;
         }
         const classesProp = getClassesProp(container);
@@ -5518,7 +5476,7 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
         }
         const [firstVariant] = revertData.originalStyle.variants;
         const additionalVariants = revertData.originalStyle.variants.slice(1);
-        (0, import_editor_elements18.createElementStyle)({
+        (0, import_editor_elements17.createElementStyle)({
           elementId: container.id,
           classesProp,
           label: import_editor_styles_repository4.ELEMENTS_STYLES_RESERVED_LABEL,
@@ -5555,7 +5513,7 @@ function pasteStyles(args, pasteLocalStyle) {
   }
   const clipboardElements = getClipboardElements(storageKey);
   const [clipboardElement] = clipboardElements ?? [];
-  const clipboardContainer = (0, import_editor_elements19.getContainer)(clipboardElement.id);
+  const clipboardContainer = (0, import_editor_elements18.getContainer)(clipboardElement.id);
   if (!clipboardElement || !clipboardContainer || !isAtomicWidget(clipboardContainer)) {
     return;
   }
@@ -5574,7 +5532,7 @@ function getClassesWithoutLocalStyle(clipboardContainer, style) {
   if (!classesProp) {
     return [];
   }
-  const classesSetting = (0, import_editor_elements19.getElementSetting)(clipboardContainer.id, classesProp);
+  const classesSetting = (0, import_editor_elements18.getElementSetting)(clipboardContainer.id, classesProp);
   return classesSetting?.value.filter((styleId) => styleId !== style?.id) ?? [];
 }
 function pasteClasses(containers, classes) {
@@ -5583,10 +5541,10 @@ function pasteClasses(containers, classes) {
     if (!classesProp) {
       return;
     }
-    const classesSetting = (0, import_editor_elements19.getElementSetting)(container.id, classesProp);
-    const currentClasses = import_editor_props11.classesPropTypeUtil.extract(classesSetting) ?? [];
-    const newClasses = import_editor_props11.classesPropTypeUtil.create(Array.from(/* @__PURE__ */ new Set([...classes, ...currentClasses])));
-    (0, import_editor_elements19.updateElementSettings)({
+    const classesSetting = (0, import_editor_elements18.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)({
       id: container.id,
       props: { [classesProp]: newClasses }
     });
@@ -5597,7 +5555,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_elements20 = require("@elementor/editor-elements");
+var import_editor_elements19 = 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");
@@ -5606,9 +5564,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_elements20.getElementStyles)(elementId);
+        const containerStyles = (0, import_editor_elements19.getElementStyles)(elementId);
         Object.keys(containerStyles ?? {}).forEach(
-          (styleId) => (0, import_editor_elements20.deleteElementStyle)(elementId, styleId)
+          (styleId) => (0, import_editor_elements19.deleteElementStyle)(elementId, styleId)
         );
         return containerStyles;
       });
@@ -5624,7 +5582,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_elements20.createElementStyle)({
+          (0, import_editor_elements19.createElementStyle)({
             elementId,
             classesProp,
             styleId,
@@ -5824,10 +5782,10 @@ function useEscapeOnCanvas(canvasDocument, onEscape) {
 }
 
 // src/utils/after-render.ts
-var import_editor_elements21 = require("@elementor/editor-elements");
+var import_editor_elements20 = require("@elementor/editor-elements");
 function doAfterRender(elementIds, callback) {
   const pending = elementIds.map((elementId) => {
-    const view = (0, import_editor_elements21.getContainer)(elementId)?.view;
+    const view = (0, import_editor_elements20.getContainer)(elementId)?.view;
     if (!view || !hasDoAfterRender(view)) {
       return void 0;
     }

package/dist/index.mjs

@@ -47,13 +47,13 @@ var initWidgetsSchemaResource = (reg) => {
       if (!widgetType) {
         throw new Error("No widget type provided.");
       }
-      const schema2 = await fetchWidgetSchema(widgetType);
+      const schema = await fetchWidgetSchema(widgetType);
       return {
         contents: [
           {
             uri: uri.toString(),
             mimeType: "application/json",
-            text: JSON.stringify(schema2)
+            text: JSON.stringify(schema)
           }
         ]
       };
@@ -1260,10 +1260,10 @@ var getMultiPropsValue = (multiProps) => {
 // src/renderers/create-props-resolver.ts
 var TRANSFORM_DEPTH_LIMIT = 3;
 function createPropsResolver({ transformers, schema: initialSchema, onPropResolve }) {
-  async function resolve({ props, schema: schema2, signal, renderContext }) {
-    schema2 = schema2 ?? initialSchema;
+  async function resolve({ props, schema, signal, renderContext }) {
+    schema = schema ?? initialSchema;
     const promises = Promise.all(
-      Object.entries(schema2).map(async ([key, type]) => {
+      Object.entries(schema).map(async ([key, type]) => {
         const value = props[key] ?? type.default;
         const transformed = await transform({ value, key, type, signal, renderContext });
         onPropResolve?.({ key, value: transformed, propValue: value, propType: type });
@@ -3922,7 +3922,7 @@ function initTabsModelExtensions() {
 }
 
 // src/mcp/canvas-mcp.ts
-import { Schema as Schema4 } from "@elementor/editor-props";
+import { Schema as Schema3 } from "@elementor/editor-props";
 
 // src/mcp/resources/available-widgets-resource.ts
 import { httpService as httpService3 } from "@elementor/http-client";
@@ -4448,8 +4448,25 @@ 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 { AxiosError, httpService as httpService6 } from "@elementor/http-client";
+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;
@@ -4471,6 +4488,9 @@ var initBuildCompositionTool = (reg) => {
         "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: {
@@ -4479,9 +4499,10 @@ var initBuildCompositionTool = (reg) => {
       version: z.string(),
       resolvedXml: z.string(),
       llmInstructions: z.string(),
-      warnings: z.array(z.string()).optional()
+      warnings: z.array(z.string()).optional(),
+      removedElementIds: z.array(z.string()).optional()
     },
-    handler: async ({ xmlStructure, elementConfig, style, parentId, dryRun }) => {
+    handler: async ({ xmlStructure, elementConfig, style, parentId, mode, dryRun }) => {
       const document2 = getCurrentDocument();
       if (!document2?.id) {
         throw new Error("No active document found.");
@@ -4495,6 +4516,7 @@ var initBuildCompositionTool = (reg) => {
             element_config: elementConfig ?? {},
             style: style ?? {},
             parent_id: parentId ?? "document",
+            mode: mode ?? "append",
             dry_run: dryRun ?? false
           }
         });
@@ -4515,26 +4537,15 @@ var initBuildCompositionTool = (reg) => {
           version: data.data.version,
           resolvedXml: data.data.resolved_xml,
           llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings
+          warnings: data.data.warnings,
+          removedElementIds: data.data.removed_element_ids
         };
       } catch (error) {
-        throw new Error(getErrorMessage(error));
+        throw new Error(getMcpErrorMessage(error, "build-composition"));
       }
     }
   });
 };
-function getErrorMessage(error) {
-  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 "build-composition failed with an unknown error.";
-}
 
 // src/mcp/tools/configure-element/tool.ts
 import { getContainer as getContainer5, getWidgetsCache as getWidgetsCache6 } from "@elementor/editor-elements";
@@ -4569,9 +4580,9 @@ var readStoredCustomCssText = (raw) => {
 
 // src/mcp/utils/resolve-canonical-prop-name.ts
 import { getWidgetsCache as getWidgetsCache4 } from "@elementor/editor-elements";
-function buildAliasToCanonicalMap(schema2) {
+function buildAliasToCanonicalMap(schema) {
   const aliasToCanonical = {};
-  for (const [canonical, propType] of Object.entries(schema2)) {
+  for (const [canonical, propType] of Object.entries(schema)) {
     const aliases = propType.meta?.aliases;
     if (!Array.isArray(aliases)) {
       continue;
@@ -4585,26 +4596,26 @@ function buildAliasToCanonicalMap(schema2) {
   return aliasToCanonical;
 }
 function resolveCanonicalPropName(elementType, propertyName) {
-  const schema2 = getWidgetsCache4()?.[elementType]?.atomic_props_schema;
-  if (!schema2 || schema2[propertyName]) {
+  const schema = getWidgetsCache4()?.[elementType]?.atomic_props_schema;
+  if (!schema || schema[propertyName]) {
     return propertyName;
   }
-  return buildAliasToCanonicalMap(schema2)[propertyName] ?? propertyName;
+  return buildAliasToCanonicalMap(schema)[propertyName] ?? propertyName;
 }
 function resolveCanonicalPropKeys(elementType, props) {
-  const schema2 = getWidgetsCache4()?.[elementType]?.atomic_props_schema;
-  if (!schema2) {
+  const schema = getWidgetsCache4()?.[elementType]?.atomic_props_schema;
+  if (!schema) {
     return { ...props };
   }
-  const aliasToCanonical = buildAliasToCanonicalMap(schema2);
+  const aliasToCanonical = buildAliasToCanonicalMap(schema);
   const resolved = {};
   for (const [key, value] of Object.entries(props)) {
-    if (schema2[key]) {
+    if (schema[key]) {
       resolved[key] = value;
     }
   }
   for (const [key, value] of Object.entries(props)) {
-    if (schema2[key]) {
+    if (schema[key]) {
       continue;
     }
     const canonical = aliasToCanonical[key];
@@ -4652,9 +4663,9 @@ var dynamicTagLLMResolver = (value) => {
     }
   };
 };
-var buildStrictSettings = (schema2, provided) => {
+var buildStrictSettings = (schema, provided) => {
   const settings = {};
-  for (const [key, propType] of Object.entries(schema2)) {
+  for (const [key, propType] of Object.entries(schema)) {
     if (OMITTED_DYNAMIC_SETTING_KEYS.includes(key)) {
       continue;
     }
@@ -5081,102 +5092,49 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }`;
 }
 
-// src/mcp/tools/get-element-config/tool.ts
-import { getContainer as getContainer6, getElementStyles as getElementStyles2, getWidgetsCache as getWidgetsCache7 } from "@elementor/editor-elements";
-import { Schema as Schema3 } from "@elementor/editor-props";
+// 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 schema = {
-  elementId: z3.string()
-};
-var outputSchema2 = {
-  properties: z3.record(z3.string(), z3.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
-  style: z3.record(z3.string(), z3.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
-  childElements: z3.array(
-    z3.object({
-      id: z3.string(),
-      elementType: z3.string(),
-      childElements: z3.array(z3.any()).describe("An array of child element IDs, when applicable, same structure recursively")
-    })
-  ).describe("An array of child element IDs, when applicable, with recursive structure")
-};
-var structuredElements = (element) => {
-  const children = element.children || [];
-  return children.map((child) => {
-    return {
-      id: child.id,
-      elementType: child.model.get("elType") || child.model.get("widgetType") || "unknown",
-      childElements: structuredElements(child)
-    };
-  });
-};
-var initGetElementConfigTool = (reg) => {
+var MCP_PROXY_URL6 = "elementor/v1/mcp-proxy";
+var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
-    name: "get-element-configuration-values",
-    description: "Retrieve the element's configuration PropValues for a specific element by unique ID.",
-    schema,
-    outputSchema: outputSchema2,
-    handler: async ({ elementId }) => {
-      const element = getContainer6(elementId);
-      if (!element) {
-        throw new Error(`Element with ID ${elementId} not found.`);
-      }
-      const elementType = element.model.get("widgetType") || element.model.get("elType") || "";
-      const widgetData = getWidgetsCache7()?.[elementType];
-      if (!widgetData) {
-        throw new Error(
-          `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
-        );
-      }
-      if (!widgetData.atomic_props_schema) {
-        throw new Error(
-          `This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${elementType}`
-        );
-      }
-      const elementRawSettings = element.settings;
-      const propSchema = getWidgetsCache7()?.[elementType]?.atomic_props_schema;
-      if (!elementRawSettings || !propSchema) {
-        throw new Error(`No settings or prop schema found for element ID: ${elementId}`);
+    name: "get-page-structure",
+    description: "Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.",
+    schema: {
+      postId: z3.number().optional().describe(
+        "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
+      )
+    },
+    outputSchema: {
+      elements: z3.array(z3.any()).describe("Root-level Elementor elements for the document.")
+    },
+    handler: async ({ postId }) => {
+      const resolvedPostId = postId ?? getCurrentDocument2()?.id;
+      if (!resolvedPostId) {
+        throw new Error("No post ID provided and no active document found.");
       }
-      const propValues = {};
-      const stylePropValues = {};
-      Schema3.configurableKeys(propSchema).forEach((key) => {
-        propValues[key] = structuredClone(elementRawSettings.get(key));
-      });
-      const elementStyles = getElementStyles2(elementId) || {};
-      const localStyle = Object.values(elementStyles).find((style) => style.label === "local");
-      if (localStyle) {
-        const defaultVariant = localStyle.variants.find(
-          (variant) => variant.meta.breakpoint === "desktop" && !variant.meta.state
-        );
-        if (defaultVariant) {
-          const styleProps = defaultVariant.props || {};
-          Object.keys(styleProps).forEach((stylePropName) => {
-            if (typeof styleProps[stylePropName] !== "undefined") {
-              stylePropValues[stylePropName] = structuredClone(styleProps[stylePropName]);
-            }
-          });
-          if (defaultVariant.custom_css) {
-            stylePropValues.custom_css = atob(defaultVariant.custom_css.raw);
+      try {
+        const { data } = await httpService7().post(MCP_PROXY_URL6, {
+          tool: "get-page-structure",
+          input: {
+            post_id: resolvedPostId
           }
-        }
+        });
+        return {
+          elements: data.data.elements
+        };
+      } catch (error) {
+        throw new Error(getMcpErrorMessage(error, "get-page-structure"));
       }
-      return {
-        properties: {
-          ...propValues
-        },
-        style: {
-          ...stylePropValues
-        },
-        childElements: structuredElements(element)
-      };
     }
   });
 };
 
 // src/mcp/canvas-mcp.ts
 var initCanvasMcp = (reg) => {
-  Schema4.setDynamicTagNamesResolver(getDynamicTagNamesByCategories);
+  Schema3.setDynamicTagNamesResolver(getDynamicTagNamesByCategories);
   initWidgetsSchemaResource(reg);
   initAvailableWidgetsResource(reg);
   initDocumentStructureResource(reg);
@@ -5185,9 +5143,9 @@ var initCanvasMcp = (reg) => {
   initEditorStateResource(reg);
   initGeneralContextResource(reg);
   initBestPracticesResource(reg);
-  initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
   initBuildCompositionTool(reg);
+  initGetPageStructureTool(reg);
   initBreakpointsResource(reg);
 };
 
@@ -5387,7 +5345,7 @@ function shouldBlock(sourceElements, targetElements) {
 }
 
 // src/style-commands/paste-style.ts
-import { getContainer as getContainer7, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
+import { getContainer as getContainer6, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
 import { classesPropTypeUtil } from "@elementor/editor-props";
 import {
   __privateListenTo as listenTo5,
@@ -5396,7 +5354,7 @@ import {
 } from "@elementor/editor-v1-adapters";
 
 // src/utils/command-utils.ts
-import { getElementLabel as getElementLabel2, getWidgetsCache as getWidgetsCache8 } from "@elementor/editor-elements";
+import { getElementLabel as getElementLabel2, getWidgetsCache as getWidgetsCache7 } from "@elementor/editor-elements";
 import { CLASSES_PROP_KEY } from "@elementor/editor-props";
 import { __ as __5 } from "@wordpress/i18n";
 function hasAtomicWidgets(args) {
@@ -5421,7 +5379,7 @@ function getClassesProp(container) {
 }
 function getContainerSchema(container) {
   const type = container?.model.get("widgetType") || container?.model.get("elType");
-  const widgetsCache = getWidgetsCache8();
+  const widgetsCache = getWidgetsCache7();
   const elementType = widgetsCache?.[type];
   return elementType?.atomic_props_schema ?? null;
 }
@@ -5441,7 +5399,7 @@ function getTitleForContainers(containers) {
 import {
   createElementStyle as createElementStyle2,
   deleteElementStyle,
-  getElementStyles as getElementStyles3,
+  getElementStyles as getElementStyles2,
   updateElementStyle as updateElementStyle2
 } from "@elementor/editor-elements";
 import { ELEMENTS_STYLES_RESERVED_LABEL } from "@elementor/editor-styles-repository";
@@ -5456,7 +5414,7 @@ var undoablePasteElementStyle = () => undoable2(
         if (!classesProp) {
           return null;
         }
-        const originalStyles = getElementStyles3(container.id);
+        const originalStyles = getElementStyles2(container.id);
         const [styleId, styleDef] = Object.entries(originalStyles ?? {})[0] ?? [];
         const originalStyle = Object.keys(styleDef ?? {}).length ? styleDef : null;
         const revertData = {
@@ -5540,7 +5498,7 @@ function pasteStyles(args, pasteLocalStyle) {
   }
   const clipboardElements = getClipboardElements(storageKey);
   const [clipboardElement] = clipboardElements ?? [];
-  const clipboardContainer = getContainer7(clipboardElement.id);
+  const clipboardContainer = getContainer6(clipboardElement.id);
   if (!clipboardElement || !clipboardContainer || !isAtomicWidget(clipboardContainer)) {
     return;
   }
@@ -5586,7 +5544,7 @@ import {
 } from "@elementor/editor-v1-adapters";
 
 // src/style-commands/undoable-actions/reset-element-style.ts
-import { createElementStyle as createElementStyle3, deleteElementStyle as deleteElementStyle2, getElementStyles as getElementStyles4 } from "@elementor/editor-elements";
+import { createElementStyle as createElementStyle3, deleteElementStyle as deleteElementStyle2, getElementStyles as getElementStyles3 } from "@elementor/editor-elements";
 import { ELEMENTS_STYLES_RESERVED_LABEL as ELEMENTS_STYLES_RESERVED_LABEL2 } from "@elementor/editor-styles-repository";
 import { undoable as undoable3 } from "@elementor/editor-v1-adapters";
 import { __ as __7 } from "@wordpress/i18n";
@@ -5595,7 +5553,7 @@ var undoableResetElementStyle = () => undoable3(
     do: ({ containers }) => {
       return containers.map((container) => {
         const elementId = container.model.get("id");
-        const containerStyles = getElementStyles4(elementId);
+        const containerStyles = getElementStyles3(elementId);
         Object.keys(containerStyles ?? {}).forEach(
           (styleId) => deleteElementStyle2(elementId, styleId)
         );
@@ -5817,10 +5775,10 @@ function useEscapeOnCanvas(canvasDocument, onEscape) {
 }
 
 // src/utils/after-render.ts
-import { getContainer as getContainer8 } from "@elementor/editor-elements";
+import { getContainer as getContainer7 } from "@elementor/editor-elements";
 function doAfterRender(elementIds, callback) {
   const pending = elementIds.map((elementId) => {
-    const view = getContainer8(elementId)?.view;
+    const view = getContainer7(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-1002",
+  "version": "4.3.0-1004",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,26 +37,26 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "4.3.0-1002",
-    "@elementor/editor-controls": "4.3.0-1002",
-    "@elementor/editor-documents": "4.3.0-1002",
-    "@elementor/editor-elements": "4.3.0-1002",
-    "@elementor/editor-interactions": "4.3.0-1002",
-    "@elementor/editor-mcp": "4.3.0-1002",
-    "@elementor/editor-notifications": "4.3.0-1002",
-    "@elementor/editor-props": "4.3.0-1002",
-    "@elementor/editor-responsive": "4.3.0-1002",
-    "@elementor/editor-styles": "4.3.0-1002",
-    "@elementor/editor-styles-repository": "4.3.0-1002",
-    "@elementor/editor-ui": "4.3.0-1002",
-    "@elementor/editor-v1-adapters": "4.3.0-1002",
-    "@elementor/events": "4.3.0-1002",
-    "@elementor/http-client": "4.3.0-1002",
-    "@elementor/schema": "4.3.0-1002",
-    "@elementor/twing": "4.3.0-1002",
+    "@elementor/editor": "4.3.0-1004",
+    "@elementor/editor-controls": "4.3.0-1004",
+    "@elementor/editor-documents": "4.3.0-1004",
+    "@elementor/editor-elements": "4.3.0-1004",
+    "@elementor/editor-interactions": "4.3.0-1004",
+    "@elementor/editor-mcp": "4.3.0-1004",
+    "@elementor/editor-notifications": "4.3.0-1004",
+    "@elementor/editor-props": "4.3.0-1004",
+    "@elementor/editor-responsive": "4.3.0-1004",
+    "@elementor/editor-styles": "4.3.0-1004",
+    "@elementor/editor-styles-repository": "4.3.0-1004",
+    "@elementor/editor-ui": "4.3.0-1004",
+    "@elementor/editor-v1-adapters": "4.3.0-1004",
+    "@elementor/events": "4.3.0-1004",
+    "@elementor/http-client": "4.3.0-1004",
+    "@elementor/schema": "4.3.0-1004",
+    "@elementor/twing": "4.3.0-1004",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.3.0-1002",
-    "@elementor/wp-media": "4.3.0-1002",
+    "@elementor/utils": "4.3.0-1004",
+    "@elementor/wp-media": "4.3.0-1004",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0",
     "dompurify": "^3.2.6"

package/src/mcp/canvas-mcp.ts

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

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

@@ -1,9 +1,11 @@
 import { getCurrentDocument, reloadCurrentDocument } from '@elementor/editor-documents';
 import { getContainer, selectElement } from '@elementor/editor-elements';
 import { type MCPRegistryEntry } from '@elementor/editor-mcp';
-import { AxiosError, type HttpResponse, httpService } from '@elementor/http-client';
+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 = {
@@ -15,6 +17,7 @@ type BuildCompositionResponse = {
 	resolved_xml: string;
 	llm_instructions: string;
 	warnings?: string[];
+	removed_element_ids?: string[];
 };
 
 export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
@@ -56,6 +59,12 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 				.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()
@@ -68,8 +77,9 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 			resolvedXml: z.string(),
 			llmInstructions: z.string(),
 			warnings: z.array( z.string() ).optional(),
+			removedElementIds: z.array( z.string() ).optional(),
 		},
-		handler: async ( { xmlStructure, elementConfig, style, parentId, dryRun } ) => {
+		handler: async ( { xmlStructure, elementConfig, style, parentId, mode, dryRun } ) => {
 			const document = getCurrentDocument();
 
 			if ( ! document?.id ) {
@@ -85,6 +95,7 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 						element_config: elementConfig ?? {},
 						style: style ?? {},
 						parent_id: parentId ?? 'document',
+						mode: mode ?? 'append',
 						dry_run: dryRun ?? false,
 					},
 				} );
@@ -109,25 +120,11 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 					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( getErrorMessage( error ) );
+				throw new Error( getMcpErrorMessage( error, 'build-composition' ) );
 			}
 		},
 	} );
 };
-
-function getErrorMessage( error: unknown ): string {
-	if ( error instanceof AxiosError ) {
-		const data = error.response?.data as { message?: string; code?: string } | undefined;
-		if ( data?.message ) {
-			return data.code ? `${ data.code }: ${ data.message }` : data.message;
-		}
-	}
-
-	if ( error instanceof Error ) {
-		return error.message;
-	}
-
-	return 'build-composition failed with an unknown error.';
-}

package/src/mcp/tools/get-page-structure/tool.ts

@@ -0,0 +1,56 @@
+import { getCurrentDocument } from '@elementor/editor-documents';
+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 GetPageStructureResponse = {
+	elements: Array< Record< string, unknown > >;
+};
+
+export const initGetPageStructureTool = ( reg: MCPRegistryEntry ) => {
+	const { addTool } = reg;
+
+	addTool( {
+		name: 'get-page-structure',
+		description:
+			'Returns the Elementor element tree (widgets, containers, and nested content) for a post or page. ' +
+			'If no postId is provided, uses the currently open document. Only works for posts saved with Elementor.',
+		schema: {
+			postId: z
+				.number()
+				.optional()
+				.describe(
+					'WordPress post ID of the Elementor document. If omitted, uses the currently open document.'
+				),
+		},
+		outputSchema: {
+			elements: z.array( z.any() ).describe( 'Root-level Elementor elements for the document.' ),
+		},
+		handler: async ( { postId } ) => {
+			const resolvedPostId = postId ?? getCurrentDocument()?.id;
+
+			if ( ! resolvedPostId ) {
+				throw new Error( 'No post ID provided and no active document found.' );
+			}
+
+			try {
+				const { data } = await httpService().post< HttpResponse< GetPageStructureResponse > >( MCP_PROXY_URL, {
+					tool: 'get-page-structure',
+					input: {
+						post_id: resolvedPostId,
+					},
+				} );
+
+				return {
+					elements: data.data.elements,
+				};
+			} catch ( error ) {
+				throw new Error( getMcpErrorMessage( error, 'get-page-structure' ) );
+			}
+		},
+	} );
+};

package/src/mcp/utils/get-mcp-error-message.ts

@@ -0,0 +1,16 @@
+import { AxiosError } from '@elementor/http-client';
+
+export function getMcpErrorMessage( error: unknown, toolName: string ): string {
+	if ( error instanceof AxiosError ) {
+		const data = error.response?.data as { message?: string; code?: string } | undefined;
+		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.`;
+}

package/src/mcp/tools/get-element-config/tool.ts

@@ -1,114 +0,0 @@
-import { getContainer, getElementStyles, getWidgetsCache, type V1Element } from '@elementor/editor-elements';
-import { type MCPRegistryEntry } from '@elementor/editor-mcp';
-import { type PropValue, Schema } from '@elementor/editor-props';
-import { z } from '@elementor/schema';
-
-const schema = {
-	elementId: z.string(),
-};
-
-const outputSchema = {
-	properties: z
-		.record( z.string(), z.any() )
-		.describe( 'A record mapping PropTypes to their corresponding PropValues' ),
-	style: z
-		.record( z.string(), z.any() )
-		.describe( 'A record mapping StyleSchema properties to their corresponding PropValues' ),
-	childElements: z
-		.array(
-			z.object( {
-				id: z.string(),
-				elementType: z.string(),
-				childElements: z
-					.array( z.any() )
-					.describe( 'An array of child element IDs, when applicable, same structure recursively' ),
-			} )
-		)
-		.describe( 'An array of child element IDs, when applicable, with recursive structure' ),
-};
-type ElementStructure = {
-	id: string;
-	elementType: string;
-	childElements: ElementStructure[];
-};
-const structuredElements = ( element: V1Element ): ElementStructure[] => {
-	const children = element.children || [];
-	return children.map( ( child ) => {
-		return {
-			id: child.id,
-			elementType: child.model.get( 'elType' ) || child.model.get( 'widgetType' ) || 'unknown',
-			childElements: structuredElements( child ),
-		};
-	} );
-};
-
-export const initGetElementConfigTool = ( reg: MCPRegistryEntry ) => {
-	const { addTool } = reg;
-
-	addTool( {
-		name: 'get-element-configuration-values',
-		description: "Retrieve the element's configuration PropValues for a specific element by unique ID.",
-		schema,
-		outputSchema,
-		handler: async ( { elementId } ) => {
-			const element = getContainer( elementId );
-			if ( ! element ) {
-				throw new Error( `Element with ID ${ elementId } not found.` );
-			}
-			const elementType = element.model.get( 'widgetType' ) || element.model.get( 'elType' ) || '';
-			const widgetData = getWidgetsCache()?.[ elementType ];
-			if ( ! widgetData ) {
-				throw new Error(
-					`Unknown element type: ${ elementType }. Check the available-widgets resource for valid types.`
-				);
-			}
-			if ( ! widgetData.atomic_props_schema ) {
-				throw new Error(
-					`This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${ elementType }`
-				);
-			}
-			const elementRawSettings = element.settings;
-			const propSchema = getWidgetsCache()?.[ elementType ]?.atomic_props_schema;
-
-			if ( ! elementRawSettings || ! propSchema ) {
-				throw new Error( `No settings or prop schema found for element ID: ${ elementId }` );
-			}
-
-			const propValues: Record< string, PropValue > = {};
-			const stylePropValues: Record< string, PropValue > = {};
-
-			Schema.configurableKeys( propSchema ).forEach( ( key ) => {
-				propValues[ key ] = structuredClone( elementRawSettings.get( key ) );
-			} );
-			const elementStyles = getElementStyles( elementId ) || {};
-			const localStyle = Object.values( elementStyles ).find( ( style ) => style.label === 'local' );
-
-			if ( localStyle ) {
-				const defaultVariant = localStyle.variants.find(
-					( variant ) => variant.meta.breakpoint === 'desktop' && ! variant.meta.state
-				);
-				if ( defaultVariant ) {
-					const styleProps = defaultVariant.props || {};
-					Object.keys( styleProps ).forEach( ( stylePropName ) => {
-						if ( typeof styleProps[ stylePropName ] !== 'undefined' ) {
-							stylePropValues[ stylePropName ] = structuredClone( styleProps[ stylePropName ] );
-						}
-					} );
-					if ( defaultVariant.custom_css ) {
-						stylePropValues.custom_css = atob( defaultVariant.custom_css.raw );
-					}
-				}
-			}
-
-			return {
-				properties: {
-					...propValues,
-				},
-				style: {
-					...stylePropValues,
-				},
-				childElements: structuredElements( element ),
-			};
-		},
-	} );
-};