@yashwant.dharmdas/elementor-mcp 3.4.0 → 3.5.0

package/dist/index.js

@@ -849,42 +849,70 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error: ${e.response?.data?.message || e.message}` }], isError: true };
         }
     });
-    server.tool("create-custom-code", "Create a new custom code snippet (requires Elementor Pro).", {
-        title: z.string(),
-        code: z.string(),
-        location: z.string().optional().describe("head or body"),
-        status: z.string().optional(),
+    server.tool("create-custom-code", "Create a new custom code snippet (requires Elementor Pro). Supports the full Publish Settings — set condition='entire_site' so the snippet actually applies sitewide (otherwise it has no effect even when published).", {
+        title: z.string().describe("Snippet title (e.g. 'Favicon Code')"),
+        code: z.string().describe("Raw code to inject (HTML, JS, or CSS)"),
+        location: z.string().optional().describe("Where to inject: 'head', 'body_start', 'body_end' (default: head)"),
+        status: z.string().optional().describe("Post status: 'publish' (default) or 'draft'. Use 'publish' to make the snippet active immediately."),
+        priority: z.number().optional().describe("Load priority — lower number = earlier. Default: 10"),
+        condition: z.enum(["entire_site", "specific_page", "post_type"]).optional().describe("Where the snippet applies. 'entire_site' = sitewide (most common, required for favicons/global tags). Default: entire_site"),
+        page_id: z.string().optional().describe("Required when condition='specific_page'. Apply only to this page."),
+        post_type: z.string().optional().describe("Required when condition='post_type'. WordPress post type slug (e.g. 'page', 'post', 'astra-portfolio')."),
         site: siteParam,
-    }, async ({ title, code, location, status, site }) => {
+    }, async ({ title, code, location, status, priority, condition, page_id, post_type, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
-            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/custom-code`, { title, code, location: location || "head", status: status || "draft" }, { headers: { Authorization: authHeader } });
+            const body = {
+                title,
+                code,
+                location: location || "head",
+                status: status || "publish",
+                priority: priority ?? 10,
+                condition: condition || "entire_site",
+            };
+            if (condition === "specific_page" && page_id)
+                body.page_id = page_id;
+            if (condition === "post_type" && post_type)
+                body.post_type = post_type;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/custom-code`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
             return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
         }
         catch (e) {
             return { content: [{ type: "text", text: `Error: ${e.response?.data?.message || e.message}` }], isError: true };
         }
     });
-    server.tool("update-custom-code", "Update a custom code snippet (requires Elementor Pro).", {
-        snippet_id: z.string(),
+    server.tool("update-custom-code", "Update a custom code snippet (requires Elementor Pro). Can also update Publish Settings — condition, priority, and status.", {
+        snippet_id: z.string().describe("ID of the custom code snippet"),
         title: z.string().optional(),
         code: z.string().optional(),
-        location: z.string().optional(),
-        status: z.string().optional(),
+        location: z.string().optional().describe("'head', 'body_start', or 'body_end'"),
+        status: z.string().optional().describe("'publish' or 'draft'"),
+        priority: z.number().optional().describe("Load priority (lower = earlier)"),
+        condition: z.enum(["entire_site", "specific_page", "post_type"]).optional().describe("Where the snippet applies"),
+        page_id: z.string().optional().describe("Required when condition='specific_page'"),
+        post_type: z.string().optional().describe("Required when condition='post_type'"),
         site: siteParam,
-    }, async ({ snippet_id, title, code, location, status, site }) => {
+    }, async ({ snippet_id, title, code, location, status, priority, condition, page_id, post_type, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
             const body = {};
-            if (title)
+            if (title !== undefined)
                 body.title = title;
-            if (code)
+            if (code !== undefined)
                 body.code = code;
-            if (location)
+            if (location !== undefined)
                 body.location = location;
-            if (status)
+            if (status !== undefined)
                 body.status = status;
-            const r = await axios.put(`${wpUrl}/wp-json/erc/v1/site/custom-code/${snippet_id}`, body, { headers: { Authorization: authHeader } });
+            if (priority !== undefined)
+                body.priority = priority;
+            if (condition !== undefined)
+                body.condition = condition;
+            if (page_id !== undefined)
+                body.page_id = page_id;
+            if (post_type !== undefined)
+                body.post_type = post_type;
+            const r = await axios.put(`${wpUrl}/wp-json/erc/v1/site/custom-code/${snippet_id}`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
             return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
         }
         catch (e) {
@@ -1906,6 +1934,29 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error setting Z-index: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    // ── Group 26: Favicon ─────────────────────────────────────────────────────────
+    server.tool("upload-favicon", "Set the WordPress Site Icon (favicon) — equivalent to Customize → Site Identity → Select Site Icon. Accepts either a URL of an image already in the media library, a media attachment ID, or a remote URL to fetch and upload first.", {
+        favicon_url: z.string().optional().describe("URL of the favicon image. If the URL is from the same WP media library, the existing attachment is reused; otherwise the image is downloaded and uploaded as a new media item."),
+        favicon_id: z.number().optional().describe("WordPress media attachment ID of an already-uploaded favicon image (preferred when known)"),
+        site: siteParam,
+    }, async ({ favicon_url, favicon_id, site }) => {
+        try {
+            if (!favicon_url && !favicon_id) {
+                return { content: [{ type: "text", text: "Provide either favicon_url or favicon_id." }], isError: true };
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {};
+            if (favicon_id)
+                body.favicon_id = favicon_id;
+            if (favicon_url)
+                body.favicon_url = favicon_url;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/favicon`, 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 favicon: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
     // ── Group 25: Video Overlay ───────────────────────────────────────────────────
     server.tool("update-video-overlay", "Set the image overlay on an Elementor video widget so the video appears to load immediately on page load. The overlay image (typically the video thumbnail or hero image) is shown until the user clicks play. This is the correct fix for 'video not loading immediately' QA issues — not changing the video URL.", {
         page_id: z.string().describe("WordPress Page ID containing the video widget"),

package/package.json

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