@yashwant.dharmdas/elementor-mcp 3.8.0 → 3.10.0

package/dist/index.js

@@ -182,13 +182,20 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
         }
     });
-    server.tool("get-data", "Get the full raw Elementor JSON element tree for a page (all elements with all settings). Use this before find-elements, patch-data, or any bulk transform.", {
+    server.tool("get-data", "Get the Elementor JSON for a page. **ALWAYS pass compact=true and strip_responsive=true for any page that isn't tiny** — this strips style/typography/spacing/responsive bulk and keeps only structure + content (60-80% smaller). Without compact, large pages will exceed Claude's tool-response size limit and get auto-saved to a file (forcing slow Python parsing). For surgical lookups (find one widget by type or condition) use find-elements instead — it's even smaller and runs server-side.", {
         page_id: z.string().describe("WordPress Page ID"),
+        compact: z.boolean().optional().describe("Strip style/typography/spacing/empty fields. Use true unless you specifically need style data."),
+        strip_responsive: z.boolean().optional().describe("Also drop _tablet, _mobile, _laptop, _widescreen variants. Use true with compact=true."),
         site: siteParam,
-    }, async ({ page_id, site }) => {
+    }, async ({ page_id, compact, strip_responsive, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
-            const r = await axios.get(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/data`, { headers: { Authorization: authHeader } });
+            const params = {};
+            if (compact !== undefined)
+                params.compact = compact ? "1" : "0";
+            if (strip_responsive !== undefined)
+                params.strip_responsive = strip_responsive ? "1" : "0";
+            const r = await axios.get(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/data`, { headers: { Authorization: authHeader }, params });
             return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
         }
         catch (error) {
@@ -263,6 +270,89 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error setting element link: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    server.tool("clone-element", "Clone an existing Elementor element (button, heading, container, etc.) with optional setting overrides and insert it at a position. **PERFECT for 'add another button like this one' tasks** — preserves all styling, classes, sizing, and structure from the source widget; you just override the content (text, link, image, etc.). 100 % server-side: no full-page download or upload — uses ~95 % fewer tokens than get-data + update-data. ALWAYS prefer this over add-widget-to-page or update-data when adding similar elements.", {
+        page_id: z.string().describe("WordPress Page ID"),
+        element_id: z.string().describe("Element ID to clone (the source — its styling and structure are copied; new IDs are auto-generated for the clone)"),
+        position: z.enum(["before", "after", "first_child", "last_child"]).optional().describe("Where to place the clone relative to target_id. Default: 'after'"),
+        target_id: z.string().optional().describe("Place clone near this element instead of the source. Default: same as element_id (places clone next to source)"),
+        overrides: z.string().optional().describe("JSON object of settings to override on the clone. Example: '{\"text\":\"Go to Growth99\",\"link\":{\"url\":\"https://growth99.com\",\"is_external\":\"on\"}}'. Top-level keys deep-merge for objects, replace for scalars."),
+        site: siteParam,
+    }, async ({ page_id, element_id, position, target_id, overrides, site }) => {
+        try {
+            let parsedOverrides = {};
+            if (overrides) {
+                try {
+                    parsedOverrides = JSON.parse(overrides);
+                }
+                catch {
+                    return { content: [{ type: "text", text: "Invalid JSON in overrides parameter." }], isError: true };
+                }
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {};
+            if (position)
+                body.position = position;
+            if (target_id)
+                body.target_id = target_id;
+            if (overrides)
+                body.overrides = parsedOverrides;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/elements/${element_id}/clone`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error cloning element: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("insert-element", "Insert a brand-new Elementor element (custom JSON) at a specific position. Server-side — never downloads or uploads the full page JSON. Use this when there's no similar element to clone. For 'add another button like this one' use clone-element instead — it preserves styling automatically.", {
+        page_id: z.string().describe("WordPress Page ID"),
+        element: z.string().describe("JSON string of the element to insert. Schema: {elType, widgetType, settings, elements?}. ID auto-generated."),
+        target_id: z.string().optional().describe("Element ID to insert relative to. Omit to insert at page top/bottom."),
+        position: z.string().optional().describe("With target_id: 'before', 'after', 'first_child', 'last_child' (default 'after'). Without target_id: 'top' or 'bottom' (default 'bottom')."),
+        site: siteParam,
+    }, async ({ page_id, element, target_id, position, site }) => {
+        try {
+            let parsedElement;
+            try {
+                parsedElement = JSON.parse(element);
+            }
+            catch {
+                return { content: [{ type: "text", text: "Invalid JSON in element parameter." }], isError: true };
+            }
+            if (!parsedElement || typeof parsedElement !== "object") {
+                return { content: [{ type: "text", text: "element must be a JSON object." }], isError: true };
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = { element: parsedElement };
+            if (target_id)
+                body.target_id = target_id;
+            if (position)
+                body.position = position;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/insert-element`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error inserting element: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("move-element", "Move an existing Elementor element to a new position in the tree. Server-side — no full-page round-trip.", {
+        page_id: z.string().describe("WordPress Page ID"),
+        element_id: z.string().describe("Element ID to move"),
+        target_id: z.string().describe("Element ID to move next to"),
+        position: z.enum(["before", "after", "first_child", "last_child"]).optional().describe("Position relative to target_id. Default: 'after'"),
+        site: siteParam,
+    }, async ({ page_id, element_id, target_id, position, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = { target_id };
+            if (position)
+                body.position = position;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/elements/${element_id}/move`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error moving element: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
     server.tool("merge-element-settings", "Deep-merge settings into a specific Elementor element without replacing the full element. Use for small setting adjustments.", {
         page_id: z.string().describe("WordPress Page ID"),
         element_id: z.string().describe("Elementor Element ID"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yashwant.dharmdas/elementor-mcp",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "MCP server for controlling Elementor via Claude — supports multiple WordPress sites",
   "main": "dist/index.js",
   "type": "module",