@yashwant.dharmdas/elementor-mcp 3.11.1 → 3.12.0

package/dist/index.js

@@ -422,9 +422,9 @@ function createMcpServer(sites) {
         }
     });
     // ── Group 2: Page & Site Config ───────────────────────────────────────────
-    server.tool("update-page-settings", "Update Elementor page-level settings (e.g. hide title, custom CSS, page layout). Merges with existing settings.", {
+    server.tool("update-page-settings", "Update Elementor page-level settings — merges with existing settings on _elementor_page_settings post meta. Common keys: hide_title ('yes' or ''), template ('elementor_canvas', 'elementor_header_footer', 'default'), custom_css. For the common 'Hide Title' toggle prefer the dedicated hide-page-title tool which handles one or many pages with a clean boolean.", {
         page_id: z.string().describe("WordPress Page ID"),
-        settings: z.string().describe("Settings object to merge as stringified JSON"),
+        settings: z.string().describe("Settings object to merge as stringified JSON, e.g. '{\"hide_title\":\"yes\"}'"),
         site: siteParam,
     }, async ({ page_id, settings, site }) => {
         let parsed;
@@ -443,6 +443,45 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error updating page settings: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    server.tool("hide-page-title", "Toggle Elementor's 'Hide Title' setting on one OR MANY pages in a single call. Equivalent to opening each page in Elementor → Page Settings → flipping the 'Hide Title' switch. Writes hide_title='yes' (or '' to unhide) to _elementor_page_settings post meta. Use this right after create-page-from-file to hide the WordPress title that appears above your Elementor hero section. Clears the Elementor cache so the change is visible immediately.", {
+        page_ids: z.array(z.string()).min(1).describe("One or more WordPress page IDs. Pass multiple to batch — e.g. all 5 service pages at once."),
+        hide: z.boolean().optional().describe("true = hide the title (default), false = show the title."),
+        site: siteParam,
+    }, async ({ page_ids, hide, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const hideValue = (hide ?? true) ? "yes" : "";
+            const results = [];
+            for (const page_id of page_ids) {
+                try {
+                    const r = await axios.patch(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/settings`, { hide_title: hideValue }, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+                    results.push({ page_id, success: true, hide_title: hideValue, result: r.data });
+                }
+                catch (err) {
+                    results.push({ page_id, success: false, error: err.response?.data?.message || err.message });
+                }
+            }
+            // Clear cache once at the end so all pages refresh
+            await axios.post(`${wpUrl}/wp-json/erc/v1/site/clear-cache`, {}, { headers: { Authorization: authHeader } }).catch(() => { });
+            const failed = results.filter(r => !r.success);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            total: page_ids.length,
+                            succeeded: results.length - failed.length,
+                            failed: failed.length,
+                            hide: hide ?? true,
+                            results,
+                        }, null, 2),
+                    }],
+                isError: failed.length === page_ids.length,
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error toggling hide-title: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
     server.tool("get-theme-context", "Get a summary of the active WordPress theme, Elementor version, active kit ID, Pro status, and viewport breakpoints.", { site: siteParam }, async ({ site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);

package/package.json

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