@yashwant.dharmdas/elementor-mcp 3.10.0 → 3.11.1

package/dist/index.js

@@ -1091,13 +1091,14 @@ function createMcpServer(sites) {
         }
     });
     // ── Group 8: Page Creation & Publishing ──────────────────────────────────
-    server.tool("create-page", "Create a new WordPress page, optionally publish it immediately, and enable the Elementor editor. Returns the page ID and direct Elementor edit URL.", {
+    server.tool("create-page", "Create a new WordPress page, optionally publish it immediately, and enable the Elementor editor. Returns the page ID and direct Elementor edit URL. Supports any WordPress post type — use post_type='astra-portfolio' for Astra portfolio items, 'post' for blog posts, etc.", {
         title: z.string().describe("Page title"),
         status: z.enum(["draft", "publish", "private", "pending"]).optional().describe("Page status — default: draft"),
         page_template: z.string().optional().describe("WordPress page template filename (e.g. 'elementor_canvas'). Leave blank for default."),
         enable_elementor: z.boolean().optional().describe("Initialize the Elementor editor on this page (default: true)"),
+        post_type: z.string().optional().describe("WordPress post type. Default: 'page'. Use 'astra-portfolio' for Astra portfolio, 'post' for blog posts, or any registered custom post type."),
         site: siteParam,
-    }, async ({ title, status, page_template, enable_elementor, site }) => {
+    }, async ({ title, status, page_template, enable_elementor, post_type, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
             const body = {
@@ -1107,6 +1108,8 @@ function createMcpServer(sites) {
             };
             if (page_template)
                 body.page_template = page_template;
+            if (post_type)
+                body.post_type = post_type;
             const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages`, body, {
                 headers: { Authorization: authHeader, "Content-Type": "application/json" },
             });
@@ -1116,6 +1119,103 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error creating page: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    server.tool("import-template-to-page", "Push a local Elementor JSON file from disk directly to an existing page. The MCP server reads the file and sends it straight to WordPress — the JSON NEVER passes through Claude's context, so there is NO 25K-token limit. Use when you have generated a large Elementor JSON locally and need to push it to an existing page. File path must be accessible on this machine (where the MCP server is running).", {
+        page_id: z.string().describe("WordPress Page ID to write the Elementor data to"),
+        file_path: z.string().describe("Absolute path to the Elementor JSON file on disk (e.g. D:\\Project\\final-service-pages\\botox.json). Must contain a valid Elementor elements array."),
+        site: siteParam,
+    }, async ({ page_id, file_path, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            // Read file from local disk — bypasses Claude context entirely
+            if (!fs.existsSync(file_path)) {
+                return { content: [{ type: "text", text: `Error: File not found at path: ${file_path}` }], isError: true };
+            }
+            const raw = fs.readFileSync(file_path, "utf8");
+            let elementorData;
+            try {
+                elementorData = JSON.parse(raw);
+            }
+            catch {
+                return { content: [{ type: "text", text: `Error: File at ${file_path} is not valid JSON.` }], isError: true };
+            }
+            // Auto-unwrap Elementor export format: {"content":[...],"version":"0.4",...}
+            // The API endpoint expects a raw elements array, not the export wrapper object.
+            if (!Array.isArray(elementorData) && Array.isArray(elementorData?.content)) {
+                elementorData = elementorData.content;
+            }
+            // Push to WordPress
+            const r = await axios.put(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/data`, elementorData, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            // Clear cache
+            await axios.post(`${wpUrl}/wp-json/erc/v1/site/clear-cache`, {}, { headers: { Authorization: authHeader }, params: { post_id: page_id } }).catch(() => { });
+            return { content: [{ type: "text", text: JSON.stringify({ success: true, page_id, file: file_path, result: r.data }, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error importing template: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("create-page-from-file", "Create a new WordPress page AND populate it with Elementor data from a local JSON file — all in one step. The MCP server reads the file from disk and sends it straight to WordPress. The JSON NEVER passes through Claude's context, so there is NO 25K-token limit. This is the correct tool for the service-pages workflow: write a script that generates Elementor JSONs locally, then call this tool for each file. Supports any post_type (astra-portfolio, page, post, etc.). Steps internally: 1) create page → get ID, 2) push Elementor data from file, 3) clear cache.", {
+        title: z.string().describe("Page title"),
+        file_path: z.string().describe("Absolute path to the Elementor JSON file on disk (e.g. D:\\Project\\final-service-pages\\botox.json)"),
+        post_type: z.string().optional().describe("WordPress post type. Default: 'page'. Use 'astra-portfolio' for Astra portfolio items, 'post' for blog posts, or any registered custom post type."),
+        status: z.enum(["draft", "publish", "private", "pending"]).optional().describe("Page status — default: publish"),
+        page_template: z.string().optional().describe("WordPress page template (e.g. 'elementor_canvas'). Leave blank for default."),
+        site: siteParam,
+    }, async ({ title, file_path, post_type, status, page_template, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            // Step 1: Read the Elementor JSON from disk
+            if (!fs.existsSync(file_path)) {
+                return { content: [{ type: "text", text: `Error: File not found at path: ${file_path}` }], isError: true };
+            }
+            const raw = fs.readFileSync(file_path, "utf8");
+            let elementorData;
+            try {
+                elementorData = JSON.parse(raw);
+            }
+            catch {
+                return { content: [{ type: "text", text: `Error: File at ${file_path} is not valid JSON.` }], isError: true };
+            }
+            // Auto-unwrap Elementor export format: {"content":[...],"version":"0.4",...}
+            // The API endpoint expects a raw elements array, not the export wrapper object.
+            if (!Array.isArray(elementorData) && Array.isArray(elementorData?.content)) {
+                elementorData = elementorData.content;
+            }
+            // Step 2: Create the page
+            const createBody = {
+                title,
+                status: status ?? "publish",
+                enable_elementor: true,
+            };
+            if (post_type)
+                createBody.post_type = post_type;
+            if (page_template)
+                createBody.page_template = page_template;
+            const createRes = await axios.post(`${wpUrl}/wp-json/erc/v1/pages`, createBody, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            const page_id = createRes.data.id;
+            // Step 3: Push Elementor data from file (never entered Claude context)
+            await axios.put(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/data`, elementorData, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            // Step 4: Clear cache
+            await axios.post(`${wpUrl}/wp-json/erc/v1/site/clear-cache`, {}, { headers: { Authorization: authHeader }, params: { post_id: page_id } }).catch(() => { });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            page_id,
+                            title,
+                            post_type: post_type ?? "page",
+                            status: status ?? "publish",
+                            url: createRes.data.url,
+                            edit_url: createRes.data.elementor_edit_url,
+                            file_used: file_path,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error creating page from file: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
     server.tool("publish-page", "Change the publish status of a WordPress page (publish, draft, private, pending, trash).", {
         page_id: z.string().describe("WordPress Page ID"),
         status: z.enum(["publish", "draft", "private", "pending", "trash"]).describe("Target status"),

package/package.json

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