@elementor/elementor-v3-mcp 4.1.0-838 → 4.1.0-beta2

package/dist/index.mjs

@@ -3,6 +3,74 @@ import { getAngieSdk } from "@elementor/editor-mcp";
 import { waitForElementorEditor } from "@elementor/elementor-mcp-common";
 import { McpServer } from "@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
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 
@@ -237,6 +305,14 @@ function addAiTool(server) {
       },
       annotations: {
         title: "Manage AI Integration"
+      },
+      _meta: {
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          }
+        ]
       }
     },
     async (params) => {
@@ -321,6 +397,14 @@ function addDynamicTool(server) {
       },
       annotations: {
         title: "Manage Dynamic Content"
+      },
+      _meta: {
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          }
+        ]
       }
     },
     async (params) => {
@@ -480,12 +564,7 @@ function addPageTool(server) {
   server.registerTool(
     "page",
     {
-      description: `Manage page and document operations including undo/redo, saving, page settings, and page information. Use this tool when you need to: 
-		- Undo or redo changes (history-undo, history-redo, history-undo-all) - Use these when user asks to undo, revert, or redo recent changes
-		- Save page changes (save-draft, save-publish, save-update, save-discard)
-		- Get or update page settings like page title, description, keywords, styling (get-settings, update-settings)
-		- Open or preview pages (open, preview)
-		This tool handles document-level operations and change history.`,
+      description: `Manage page and document operations: history, save, settings, and open/preview.`,
       inputSchema: {
         action: z3.enum([
           "save-draft",
@@ -511,7 +590,11 @@ function addPageTool(server) {
         title: "Manage Page"
       },
       _meta: {
-        "angie:required-resources": [
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          },
           {
             uri: RESOURCE_URI_PAGE_SETTINGS,
             whenToUse: "When updating page settings (action=update-settings) to understand the page schema, available settings, their allowed values, and current page configuration"
@@ -692,6 +775,14 @@ function addRoutesTool(server) {
       },
       annotations: {
         title: "Manage Routes"
+      },
+      _meta: {
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          }
+        ]
       }
     },
     async (params) => {
@@ -781,28 +872,10 @@ function addStylingTool(server) {
   server.registerTool(
     "styling",
     {
-      description: `This tool provides AI-powered custom CSS styling for Elementor elements. Use this when users want advanced styling that goes beyond Elementor capabilities and can't be targeted using the element settings.
-
-**When to use this tool:**
-- Visual effects: shadows, filters, pseudo-elements, advanced selectors
-- Complex animations with custom keyframes or CSS transitions
-- Styling that requires media queries or complex CSS rules
-- Click-triggered effects or other non-motion triggers
-- Custom hover effects that don't involve motion (color changes, opacity, etc.)
-
-**When NOT to use this tool:**
-- Basic styling achievable through Elementor settings (colors, typography, spacing, borders, simple hover effects) -> use the elementor__elements with "update-settings" action.
-
-**Do NOT use this tool if the user mentions motion effects with supported triggers:**
-- "on hover" with motion (movement, rotation, scaling) \u2192 use motion-effects tool
-- "on scroll" with motion effects \u2192 use motion-effects tool  
-- "mouse move" / "follow mouse" \u2192 use motion-effects tool
-- "entrance" / "fade in" / "slide in" animations \u2192 use motion-effects tool
-
-**Actions available:**
-- **custom-css**: Generate and apply AI-powered custom CSS to elements
-
-This tool generates CSS code using AI, provides preview functionality, and handles user approval workflow for applying custom styles.`,
+      description: `Apply custom CSS to legacy/V3 elements.
+- Do NOT use for V4 elements \u2014 V4 has its own MCP and tools.
+- Do NOT use for animations or motion \u2014 use the interactions tools.
+- Do NOT use for basic styling \u2014 V3 elements support basic styling via the V3 settings tool.`,
       inputSchema: {
         action: z5.enum(["custom-css"]).describe(
           "The styling operation to perform. Currently supports custom-css for AI-generated CSS styling."
@@ -816,6 +889,14 @@ This tool generates CSS code using AI, provides preview functionality, and handl
       },
       annotations: {
         title: "Apply Custom Styling"
+      },
+      _meta: {
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          }
+        ]
       }
     },
     async (params) => {
@@ -909,6 +990,14 @@ function addUiTool(server) {
       },
       annotations: {
         title: "Manage UI"
+      },
+      _meta: {
+        "angie/requiredResources": [
+          {
+            uri: V3_DESCRIPTION_URI,
+            whenToUse: "Read to understand Elementor capabilities and limitations before using this tool."
+          }
+        ]
       }
     },
     async (params) => {
@@ -964,57 +1053,6 @@ async function handleUiPaste(params) {
 }
 
 // src/elementor-mcp-server.ts
-var SERVER_INSTRUCTIONS = `## 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.`;
 var VERSION = "2.0.0";
 async function createElementorServer() {
   await waitForElementorEditor();
@@ -1025,7 +1063,7 @@ async function createElementorServer() {
       title: "Elementor"
     },
     {
-      instructions: SERVER_INSTRUCTIONS,
+      instructions: `Controls the Elementor editor: page settings, UI, global styles, AI content, and custom CSS.`,
       capabilities: {
         resources: {
           subscribe: true
@@ -1033,6 +1071,7 @@ async function createElementorServer() {
       }
     }
   );
+  addV3DescriptionResource(server);
   addElementorResources(server);
   addPageTool(server);
   addUiTool(server);
@@ -1042,7 +1081,7 @@ async function createElementorServer() {
   addStylingTool(server);
   const sdk = getAngieSdk();
   await sdk.waitForReady();
-  sdk.registerLocalServer({ server, version: VERSION, description: SERVER_INSTRUCTIONS, name: "Elementor" });
+  sdk.registerLocalServer({ server, version: VERSION, description: V3_DESCRIPTION, name: "Elementor" });
   return server;
 }