We deliver cutting-edge solutions for modern businesses.
", "parent_id": "container123" } } ``` **add-button** — Insert call-to-action button: ```json { "tool": "add-button", "arguments": { "post_id": 123, "text": "Get Started", "link": { "url": "https://example.com/signup", "is_external": true, "nofollow": false }, "align": "center", "button_type": "success", "parent_id": "container123" } } ``` **add-image** — Insert image widget: ```json { "tool": "add-image", "arguments": { "post_id": 123, "image": { "id": 456, "url": "https://example.com/wp-content/uploads/hero.jpg" }, "image_size": "full", "align": "center", "parent_id": "container123" } } ``` **update-widget** — Modify existing widget: ```json { "tool": "update-widget", "arguments": { "post_id": 123, "element_id": "widget789", "settings": { "title": "Updated Heading Text", "title_color": "#0066cc" } } } ``` ### Pro Widgets (Elementor Pro Required) **add-nav-menu** — Add navigation menu: ```json { "tool": "add-nav-menu", "arguments": { "post_id": 123, "menu": "primary", "layout": "horizontal", "parent_id": "header-container" } } ``` **add-loop-grid** — Create dynamic content loop: ```json { "tool": "add-loop-grid", "arguments": { "post_id": 123, "template_id": 789, "query_post_type": "post", "query_posts_per_page": 6, "columns": 3, "parent_id": "container123" } } ``` **add-popup** — Create popup template: ```json { "tool": "add-popup", "arguments": { "title": "Newsletter Signup", "triggers": [ { "type": "exit_intent", "settings": {} } ], "timing": { "delay": 5 } } } ``` ### Atomic Elements (Elementor 4.0+) **add-atomic-widget** — Add atomic element: ```json { "tool": "add-atomic-widget", "arguments": { "post_id": 123, "widget_type": "n-button", "settings": { "button_text": "Learn More", "button_link": { "url": "/about" } }, "parent_id": "container123" } } ``` Available atomic widgets: `n-flex`, `n-div`, `n-heading`, `n-paragraph`, `n-button`, `n-image`, `n-svg`, `n-youtube`, `n-video`, `n-divider` ### Global Settings **get-global-settings** — Retrieve site-wide design tokens: ```json { "tool": "get-global-settings" } ``` **update-global-colors** — Modify color palette: ```json { "tool": "update-global-colors", "arguments": { "colors": [ { "_id": "primary", "title": "Brand Primary", "color": "#0066cc" }, { "_id": "secondary", "title": "Brand Secondary", "color": "#ff6600" } ] } } ``` **update-global-typography** — Set typography presets: ```json { "tool": "update-global-typography", "arguments": { "typography": [ { "_id": "primary", "title": "Primary Heading", "typography_typography": "custom", "typography_font_family": "Roboto", "typography_font_size": { "size": 36, "unit": "px" }, "typography_font_weight": "700" } ] } } ``` ### Brand Kits **apply-brand-kit** — Apply coordinated design system (10 free kits, 50 in Pro): ```json { "tool": "apply-brand-kit", "arguments": { "kit_name": "modern-tech" } } ``` Available free kits: `modern-tech`, `classic-elegance`, `bold-creative`, `minimal-clean`, `warm-organic`, `corporate-pro`, `vibrant-startup`, `luxury-premium`, `earthy-natural`, `playful-fun` **backup-brand-kit** — Save current design tokens: ```json { "tool": "backup-brand-kit", "arguments": { "backup_name": "pre-redesign-2024" } } ``` **restore-brand-kit** — Restore previous backup: ```json { "tool": "restore-brand-kit", "arguments": { "backup_name": "pre-redesign-2024" } } ``` ### Templates **save-template** — Export page or section as reusable template: ```json { "tool": "save-template", "arguments": { "post_id": 123, "template_title": "Hero Section Layout", "template_type": "section", "element_id": "section456" } } ``` **apply-template** — Import template to page: ```json { "tool": "apply-template", "arguments": { "post_id": 123, "template_id": 789, "parent_id": "container123", "position": 0 } } ``` ### Theme Builder **create-theme-template** — Build header/footer/single/archive templates: ```json { "tool": "create-theme-template", "arguments": { "title": "Site Header", "template_type": "header", "display_conditions": { "include": [ { "type": "general", "value": "all" } ] } } } ``` ### Stock Images **search-stock-images** — Find Creative Commons images: ```json { "tool": "search-stock-images", "arguments": { "query": "business team collaboration", "limit": 10, "license": "cc0" } } ``` **sideload-image** — Import image to Media Library: ```json { "tool": "sideload-image", "arguments": { "image_url": "https://example.com/image.jpg", "title": "Team Photo", "alt_text": "Our team collaborating" } } ``` ### Custom Code **add-element-css** — Add CSS to specific element: ```json { "tool": "add-element-css", "arguments": { "post_id": 123, "element_id": "widget789", "css": "selector { border-radius: 10px; box-shadow: 0 4px 6px rgba(0,0,0,0.1); }" } } ``` **add-page-css** — Inject page-level CSS: ```json { "tool": "add-page-css", "arguments": { "post_id": 123, "css": ".custom-section { background: linear-gradient(45deg, #667eea 0%, #764ba2 100%); }" } } ``` **add-custom-code-snippet** — Create site-wide code injection: ```json { "tool": "add-custom-code-snippet", "arguments": { "title": "Analytics Script", "code": "", "location": "head", "priority": 10 } } ``` ### Composite Tools **build-page-from-structure** — Create complete page from JSON structure: ```json { "tool": "build-page-from-structure", "arguments": { "post_id": 123, "structure": { "containers": [ { "settings": { "content_width": "full", "background_background": "classic", "background_color": "#ffffff" }, "children": [ { "widget_type": "heading", "settings": { "title": "Welcome", "header_size": "h1" } }, { "widget_type": "text-editor", "settings": { "editor": "Your content here.
" } } ] } ] } } } ``` ## Common Patterns ### Building a Complete Landing Page ```json // Step 1: Create page { "tool": "create-page", "arguments": { "title": "Product Launch", "status": "draft" } } // Returns: { "post_id": 123 } // Step 2: Add hero container { "tool": "add-container", "arguments": { "post_id": 123, "settings": { "content_width": "full", "min_height": { "size": 600, "unit": "px" }, "flex_direction": "column", "flex_justify_content": "center", "flex_align_items": "center", "background_background": "gradient", "background_color": "#667eea", "background_color_b": "#764ba2" } } } // Returns: { "element_id": "hero-container" } // Step 3: Add hero heading { "tool": "add-heading", "arguments": { "post_id": 123, "title": "Revolutionary Product Launch", "header_size": "h1", "align": "center", "title_color": "#ffffff", "parent_id": "hero-container" } } // Step 4: Add CTA button { "tool": "add-button", "arguments": { "post_id": 123, "text": "Pre-Order Now", "link": { "url": "/preorder" }, "button_type": "success", "size": "lg", "parent_id": "hero-container" } } // Step 5: Add features section { "tool": "add-container", "arguments": { "post_id": 123, "settings": { "flex_direction": "row", "flex_gap": { "size": 30, "unit": "px" } } } } ``` ### Applying Dynamic Content (Pro) ```json // Create loop grid for blog posts { "tool": "add-loop-grid", "arguments": { "post_id": 123, "template_id": 456, "query_post_type": "post", "query_posts_per_page": 9, "query_orderby": "date", "query_order": "DESC", "columns": 3, "columns_tablet": 2, "columns_mobile": 1, "parent_id": "blog-container" } } ``` ### Theming Entire Site ```json // Step 1: Create header template { "tool": "create-theme-template", "arguments": { "title": "Global Header", "template_type": "header", "display_conditions": { "include": [ { "type": "general", "value": "all" } ] } } } // Step 2: Build header structure { "tool": "add-container", "arguments": { "post_id": 789, "settings": { "flex_direction": "row", "flex_justify_content": "space-between" } } } // Step 3: Add logo { "tool": "add-image", "arguments": { "post_id": 789, "image": { "id": 101 }, "parent_id": "header-container" } } // Step 4: Add navigation (Pro) { "tool": "add-nav-menu", "arguments": { "post_id": 789, "menu": "primary", "layout": "horizontal", "parent_id": "header-container" } } ``` ### Batch Operations ```json // Update multiple elements at once { "tool": "batch-update-elements", "arguments": { "post_id": 123, "updates": [ { "element_id": "heading1", "settings": { "title_color": "#0066cc" } }, { "element_id": "heading2", "settings": { "title_color": "#0066cc" } }, { "element_id": "button1", "settings": { "button_type": "primary" } } ] } } ``` ## Troubleshooting ### Connection Issues **Problem:** `401 Unauthorized` response **Solution:** Verify Application Password encoding: ```bash # Correct format (no spaces in username:password) echo -n "admin:xxxx xxxx xxxx xxxx" | base64 # Test connection curl -H "Authorization: Basic YOUR_BASE64_HERE" \ https://your-site.com/wp-json/mcp/elementor-mcp-server ``` **Problem:** `404 Not Found` on MCP endpoint **Solution:** ```bash # Flush rewrite rules wp rewrite flush # Verify plugin is active wp plugin list --status=active | grep elementor-mcp ``` ### Tool Count Issues **Problem:** Client rejects connection due to too many tools **Solution:** Enable Low-tools Mode in **EMCP Tools > Tools** or filter tools manually: ```json { "tool": "toggle-tools", "arguments": { "enabled_tools": [ "create-page", "add-container", "add-widget", "get-page-structure", "update-widget" ] } } ``` ### Widget Schema Errors **Problem:** Widget won't accept certain settings **Solution:** Inspect widget schema first: ```json { "tool": "get-widget-schema", "arguments": { "widget_type": "heading" } } ``` Check returned JSON Schema for valid property names, types, and constraints. ### Container Nesting Issues **Problem:** Elements appear in wrong location **Solution:** Always verify parent container exists: ```json // Get page structure first { "tool": "get-page-structure", "arguments": { "post_id": 123 } } // Find correct parent_id in returned tree // Then add element with verified parent_id ``` ### Dynamic Tags Not Working (Pro) **Problem:** Dynamic content not rendering **Solution:** List available tags first: ```json { "tool": "list-dynamic-tags" } ``` Then bind using exact tag name: ```json { "tool": "update-widget", "arguments": { "post_id": 123, "element_id": "widget789", "settings": { "title": "{{dynamic-tag:post-title}}" } } } ``` ### Brand Kit Not Applying **Problem:** `apply-brand-kit` returns error **Solution:** Check kit availability: ```json // Free version has 10 kits // Pro version has 50 kits // List available kits via WordPress admin: // EMCP Tools > Brand Kits tab ``` ### Custom Widget Builder Errors (Pro) **Problem:** Widget doesn't appear in editor **Solution:** Verify widget spec structure: ```json { "widget_id": "unique-id", "widget_name": "My Widget", "widget_category": "custom", "controls": [ { "id": "text", "type": "text", "label": "Content" } ], "template": "