@elementor/elementor-v3-mcp 4.2.0-907 → 4.2.0-909

package/dist/index.d.mts

@@ -21,6 +21,8 @@ type McpToolResult = {
 };
 interface ElementorContainer {
     id: string;
+    label?: string;
+    type?: string;
     model: {
         id: string;
         attributes?: Record<string, unknown>;
@@ -28,6 +30,7 @@ interface ElementorContainer {
             title?: string;
         };
         get?: (key: string) => unknown;
+        widgetType?: string;
     };
     settings: {
         attributes?: Record<string, unknown>;

package/dist/index.d.ts

@@ -21,6 +21,8 @@ type McpToolResult = {
 };
 interface ElementorContainer {
     id: string;
+    label?: string;
+    type?: string;
     model: {
         id: string;
         attributes?: Record<string, unknown>;
@@ -28,6 +30,7 @@ interface ElementorContainer {
             title?: string;
         };
         get?: (key: string) => unknown;
+        widgetType?: string;
     };
     settings: {
         attributes?: Record<string, unknown>;

package/dist/index.js

@@ -36,74 +36,6 @@ var import_editor_mcp = require("@elementor/editor-mcp");
 var import_elementor_mcp_common = require("@elementor/elementor-mcp-common");
 var import_mcp2 = require("@modelcontextprotocol/sdk/server/mcp.js");
 
-// src/mcp-description-resource.ts
-var V3_DESCRIPTION_URI = "elementor://elementor/server-description";
-var V3_DESCRIPTION = `## Elementor Page Builder
-
-### Capabilities:
-**Page Management:**
-- Manage page settings, saving and routing pages
-- Control the editor UI, including switching between desktop, tablet, and mobile views
-
-**Global Styles:**
-- Work with global styles, helping manage shared design settings like colors and fonts across the site
-
-**AI-Powered Content Creation:**
-- Generate and edit text and insert it into the page
-- Generate images and place them on the canvas
-
-**Custom Styling & Code:**
-- Apply custom CSS to elements
-- Generate supported code snippets
-
-### Limitations:
-**Element Management (Not Supported):**
-- Cannot create or edit individual Elementor elements such as widgets or containers
-- Cannot build page layouts or create containers
-- Cannot modify widget-level settings
-- Cannot apply motion effects
-- Cannot reorder sections or perform detailed canvas-level edits
-- Cannot create fully designed or polished pages
-- Cannot fully resolve responsiveness issues
-- Support for these editor-level capabilities is planned for Editor V4
-
-**Theme Builder:**
-- Cannot create or manage Theme Builder templates, including headers, footers, single posts, archives, products, loop items, or 404 pages
-- Cannot set display conditions for templates
-- Cannot configure popup triggers and advanced rules
-
-**System Settings:**
-- Cannot change Elementor system-level settings
-- Cannot activate or work with Editor V4
-- Cannot manage form submissions
-- Cannot add custom fonts or icons
-- Cannot manage user roles
-- Cannot roll back Elementor versions
-- Cannot place the site in maintenance mode
-- Cannot export the website
-- Cannot apply full website templates
-
-**Code & Widgets:**
-- Cannot register PHP code or create new custom widgets, though Angie may provide guidance, code snippets, or plugin suggestions where helpful
-
-**Note**: While page names can include terms like "header" or "footer", these won't function as actual theme parts without Theme Builder access.
-
-**Important**: When users ask "What can Angie do?" or similar questions about Angie's general capabilities, use the \`what-can-angie-do\` tool from the knowledge MCP server instead of generating your own response.`;
-function addV3DescriptionResource(server) {
-  server.registerResource(
-    "elementor-v3-server-description",
-    V3_DESCRIPTION_URI,
-    {
-      title: "Elementor V3 Server Description",
-      description: "Elementor V3 MCP capabilities and limitations",
-      mimeType: "text/plain"
-    },
-    async (uri) => ({
-      contents: [{ uri: uri.href, mimeType: "text/plain", text: V3_DESCRIPTION }]
-    })
-  );
-}
-
 // src/resources.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 
@@ -111,6 +43,9 @@ var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var getElementor = () => window.elementor;
 var get$e = () => window.$e;
 var getElementorCommon = () => window.elementorCommon;
+function getCurrentSelection() {
+  return Object.keys(getElementor()?.selection?.elements || {});
+}
 function encodeToolJson(data) {
   return JSON.stringify(data).replaceAll('"', "'");
 }
@@ -202,6 +137,61 @@ function loadDocumentSchema(documentId) {
   return getDocumentSchema(documentId);
 }
 
+// src/get-current-editor-selection.ts
+var ELEMENT_TYPE_LABELS = {
+  container: "Container",
+  section: "Section"
+};
+function getEditorPageTitle() {
+  const title = getElementor()?.documents?.getCurrent()?.config?.settings?.settings?.post_title;
+  return title || "Untitled";
+}
+function getElementDisplayName(container) {
+  if (container.label) {
+    return container.label;
+  }
+  const widgetType = container.model?.attributes?.widgetType ?? container.model?.widgetType;
+  if (widgetType) {
+    return widgetType.charAt(0).toUpperCase() + widgetType.slice(1).replace(/-/g, " ");
+  }
+  return ELEMENT_TYPE_LABELS[container.type ?? ""] ?? `Element ${container.id}`;
+}
+function getCurrentEditorSelection() {
+  const elementor = getElementor();
+  if (!elementor?.documents?.getCurrent) {
+    return { error: "Elementor is not available" };
+  }
+  const document = elementor.documents.getCurrent();
+  if (!document) {
+    return { error: "No active document found" };
+  }
+  const pageTitle = getEditorPageTitle();
+  const primaryId = getCurrentSelection()[0];
+  const container = primaryId ? elementor.getContainer(primaryId) : null;
+  const base = {
+    displayName: pageTitle,
+    documentId: document.id,
+    pageTitle,
+    selectedElementId: null,
+    selectedParentId: null,
+    selectedWidgetType: null,
+    selectedElementType: null
+  };
+  if (!container?.id) {
+    return base;
+  }
+  const widgetType = container.model?.attributes?.widgetType ?? null;
+  const elementType = container.type ?? container.model?.attributes?.elType ?? "widget";
+  return {
+    ...base,
+    displayName: `${pageTitle} > ${getElementDisplayName(container)}`,
+    selectedElementId: container.id,
+    selectedParentId: container.parent?.id ?? null,
+    selectedWidgetType: widgetType,
+    selectedElementType: elementType
+  };
+}
+
 // src/resources.ts
 var RESOURCE_NAME_ELEMENT_SETTINGS = "elementor-element-settings";
 var RESOURCE_URI_ELEMENT_SETTINGS_TEMPLATE = "elementor://editor/element-settings/{elementId}";
@@ -209,6 +199,8 @@ var RESOURCE_NAME_WIDGET_CONFIG = "elementor-widget-config";
 var RESOURCE_URI_WIDGET_CONFIG_TEMPLATE = "elementor://editor/widget-config/{widgetType}";
 var RESOURCE_NAME_PAGE_SETTINGS = "elementor-page-settings";
 var RESOURCE_URI_PAGE_SETTINGS = "elementor://editor/page-settings";
+var RESOURCE_NAME_CURRENT_CONTEXT = "elementor-current-context";
+var RESOURCE_URI_CURRENT_CONTEXT = "elementor://context/current-page";
 function decodeResourceVariable(value) {
   try {
     let decoded = decodeURIComponent(value).replace(/[·]/g, "");
@@ -324,6 +316,133 @@ function addElementorResources(server) {
       };
     }
   );
+  server.resource(
+    RESOURCE_NAME_CURRENT_CONTEXT,
+    RESOURCE_URI_CURRENT_CONTEXT,
+    {
+      description: 'Current Elementor editor focus: which page the user is working on and which element (if any) is selected. Returns displayName formatted as "<PageTitle>" or "<PageTitle> > <ElementName>", plus documentId, selectedElementId, selectedParentId, selectedWidgetType, and selectedElementType.'
+    },
+    async (uri) => {
+      const snapshot = getCurrentEditorSelection();
+      if ("error" in snapshot) {
+        throw new Error(snapshot.error);
+      }
+      return {
+        contents: [
+          {
+            uri: uri.toString(),
+            mimeType: "application/json",
+            text: JSON.stringify(snapshot)
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/editor-selection-listener.ts
+var SELECTION_COMMANDS = /* @__PURE__ */ new Set([
+  "document/elements/select",
+  "document/elements/deselect",
+  "document/elements/deselect-all",
+  "document/elements/toggle-selection",
+  "document/elements/select-all",
+  "editor/documents/switch"
+]);
+var DEBOUNCE_MS = 50;
+var COMMAND_EVENT_NAME = "elementor/commands/run/after";
+function setupEditorSelectionListener(server) {
+  let debounceTimer = null;
+  const sendUpdate = () => {
+    void server.server.sendResourceUpdated({ uri: RESOURCE_URI_CURRENT_CONTEXT }).catch((error) => {
+      const isSafeError = error?.message?.includes("Not connected") || error?.message?.includes("does not support notifying about resources");
+      if (!isSafeError) {
+        throw error;
+      }
+    });
+  };
+  const handleCommandRun = (event) => {
+    if (!(event instanceof CustomEvent)) {
+      return;
+    }
+    const command = event.detail?.command;
+    if (!command || !SELECTION_COMMANDS.has(command)) {
+      return;
+    }
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(sendUpdate, DEBOUNCE_MS);
+  };
+  window.addEventListener(COMMAND_EVENT_NAME, handleCommandRun);
+}
+
+// src/mcp-description-resource.ts
+var V3_DESCRIPTION_URI = "elementor://elementor/server-description";
+var V3_DESCRIPTION = `## Elementor Page Builder
+
+### Capabilities:
+**Page Management:**
+- Manage page settings, saving and routing pages
+- Control the editor UI, including switching between desktop, tablet, and mobile views
+
+**Global Styles:**
+- Work with global styles, helping manage shared design settings like colors and fonts across the site
+
+**AI-Powered Content Creation:**
+- Generate and edit text and insert it into the page
+- Generate images and place them on the canvas
+
+**Custom Styling & Code:**
+- Apply custom CSS to elements
+- Generate supported code snippets
+
+### Limitations:
+**Element Management (Not Supported):**
+- Cannot create or edit individual Elementor elements such as widgets or containers
+- Cannot build page layouts or create containers
+- Cannot modify widget-level settings
+- Cannot apply motion effects
+- Cannot reorder sections or perform detailed canvas-level edits
+- Cannot create fully designed or polished pages
+- Cannot fully resolve responsiveness issues
+- Support for these editor-level capabilities is planned for Editor V4
+
+**Theme Builder:**
+- Cannot create or manage Theme Builder templates, including headers, footers, single posts, archives, products, loop items, or 404 pages
+- Cannot set display conditions for templates
+- Cannot configure popup triggers and advanced rules
+
+**System Settings:**
+- Cannot change Elementor system-level settings
+- Cannot activate or work with Editor V4
+- Cannot manage form submissions
+- Cannot add custom fonts or icons
+- Cannot manage user roles
+- Cannot roll back Elementor versions
+- Cannot place the site in maintenance mode
+- Cannot export the website
+- Cannot apply full website templates
+
+**Code & Widgets:**
+- Cannot register PHP code or create new custom widgets, though Angie may provide guidance, code snippets, or plugin suggestions where helpful
+
+**Note**: While page names can include terms like "header" or "footer", these won't function as actual theme parts without Theme Builder access.
+
+**Important**: When users ask "What can Angie do?" or similar questions about Angie's general capabilities, use the \`what-can-angie-do\` tool from the knowledge MCP server instead of generating your own response.`;
+function addV3DescriptionResource(server) {
+  server.registerResource(
+    "elementor-v3-server-description",
+    V3_DESCRIPTION_URI,
+    {
+      title: "Elementor V3 Server Description",
+      description: "Elementor V3 MCP capabilities and limitations",
+      mimeType: "text/plain"
+    },
+    async (uri) => ({
+      contents: [{ uri: uri.href, mimeType: "text/plain", text: V3_DESCRIPTION }]
+    })
+  );
 }
 
 // src/tools/ai-tool.ts
@@ -1112,6 +1231,7 @@ async function createElementorServer() {
   addRoutesTool(server);
   addAiTool(server);
   addStylingTool(server);
+  setupEditorSelectionListener(server);
   const sdk = (0, import_editor_mcp.getAngieSdk)();
   await sdk.waitForReady();
   sdk.registerLocalServer({ server, version: VERSION, description: V3_DESCRIPTION, name: "Elementor" });