@yashwant.dharmdas/elementor-mcp 3.7.0 → 3.9.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) {
@@ -227,6 +234,42 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    server.tool("set-element-link", "Set, replace, or clear the link on any Elementor widget that has a link (button, heading, image, icon-box, etc.). Updates the NATIVE Elementor link object (url + is_external + nofollow + custom_attributes) — exactly the same fields the editor writes when you set a link in the UI. Use this instead of patch-data or merge-element-settings for any link change; it guarantees 'Open in new tab' uses the native Elementor toggle (is_external) and not a fake HTML attribute.", {
+        page_id: z.string().describe("WordPress Page ID"),
+        element_id: z.string().describe("Elementor Element ID of the widget whose link you want to change"),
+        url: z.string().optional().describe("URL to set, e.g. 'https://example.com'. Required unless clear=true."),
+        open_in_new_tab: z.boolean().optional().describe("Native Elementor 'Open in new window' toggle. Maps to link.is_external = 'on'."),
+        nofollow: z.boolean().optional().describe("Native Elementor 'Add nofollow' toggle. Maps to link.nofollow = 'on'."),
+        custom_attributes: z.string().optional().describe("Custom HTML link attributes, Elementor format: 'key|value,key|value'."),
+        clear: z.boolean().optional().describe("Set true to remove the link entirely (url='' and all flags reset)."),
+        link_field: z.string().optional().describe("Settings key holding the link object. Default 'link'. Override only for non-standard widgets."),
+        site: siteParam,
+    }, async ({ page_id, element_id, url, open_in_new_tab, nofollow, custom_attributes, clear, link_field, site }) => {
+        try {
+            if (!clear && (url === undefined || url === null || String(url).trim() === "")) {
+                return { content: [{ type: "text", text: "Provide a non-empty url, OR set clear=true to remove the link." }], isError: true };
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {};
+            if (url !== undefined)
+                body.url = url;
+            if (open_in_new_tab !== undefined)
+                body.open_in_new_tab = open_in_new_tab;
+            if (nofollow !== undefined)
+                body.nofollow = nofollow;
+            if (custom_attributes !== undefined)
+                body.custom_attributes = custom_attributes;
+            if (clear !== undefined)
+                body.clear = clear;
+            if (link_field !== undefined)
+                body.link_field = link_field;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/elements/${element_id}/link`, 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 setting element link: ${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.7.0",
+  "version": "3.9.0",
   "description": "MCP server for controlling Elementor via Claude — supports multiple WordPress sites",
   "main": "dist/index.js",
   "type": "module",