@noleemits/vision-builder-control-mcp 4.5.10 → 4.15.0

package/index.js

@@ -2,7 +2,17 @@
 /**
  * Noleemits Vision Builder Control MCP Server
  *
- * Provides 62 tools for building and managing WordPress/Elementor sites.
+ * Provides 65 tools for building and managing WordPress/Elementor sites.
+ * v4.15.0: Injection engine v2 — icon-list injection, unfilled slot clearing, plus_tooltip boilerplate fix.
+ * v4.14.0: Pipeline quality fixes — smart counter parsing, boilerplate post-processing, quality scores in browse, injection completeness.
+ * v4.13.0: Phase 3 DX — display_conditions, null filter fix, garbage HTML cleanup, icon key docs, auto-inject convenience docs.
+ * v4.12.0: Phase 2 tools — move_element, clean_globals, find_replace URL search, set_front_page.
+ * v4.11.0: Phase 1 fixes — token patch semantics, trigger key auto-injection (background/typography), enhanced cache clear, flex-grow/grid convenience.
+ * v4.10.0: ACF tools + Elementor global styles (get_global_styles, set_global_styles) — read/write kit colors & fonts.
+ * v4.9.2: audit_broken_images tool (scan all content for broken image URLs).
+ * v4.9.1: search_post_content, replace_post_content tools + extract_urls + regex support.
+ * v4.9.0: audit_db_health, audit_image_sizes, fix_image_sizes tools.
+ * v4.8.0: get_section_json, update_children, check_page_lock tools + element_path + edit locking + 10-mode Section Inspector.
  * v4.3.0: Add 4 nvbc_* shortcodes (pill badges, category list, excerpt, category cards).
  * v4.2.1: Fix audit_clickable scanner (WP_Post object vs ID bug).
  * - Design tokens (get, set, refresh)
@@ -30,7 +40,7 @@
  *
  * WordPress plugin: Noleemits Vision Builder Control (nvbc/v1 REST endpoints)
  *
- * Version: 4.4.0
+ * Version: 4.11.0
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -94,8 +104,8 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.5.10';
-const MIN_PLUGIN_VERSION = '4.5.10'; // Minimum WP plugin version required by this MCP server
+const VERSION = '4.15.0';
+const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
 // PARAMETER HELPERS
@@ -157,12 +167,38 @@ const __dirname_tl = dirname(__filename_tl);
 const TEMPLATE_LIBRARY_DIR = process.env.TEMPLATE_LIBRARY_DIR || '';
 let _templateCatalog = null;
 
+let _qualityScores = null;
 function getTemplateCatalog() {
     if (_templateCatalog) return _templateCatalog;
     const catalogPath = join(TEMPLATE_LIBRARY_DIR, 'section-catalog.json');
     if (!TEMPLATE_LIBRARY_DIR || !existsSync(catalogPath)) return null;
     try {
         _templateCatalog = JSON.parse(readFileSync(catalogPath, 'utf8'));
+        // Merge quality scores from scored-sections.json if available
+        const scoresPath = join(TEMPLATE_LIBRARY_DIR, 'scored-sections.json');
+        if (existsSync(scoresPath) && !_qualityScores) {
+            try {
+                const scored = JSON.parse(readFileSync(scoresPath, 'utf8'));
+                _qualityScores = {};
+                for (const s of (scored.sections || [])) {
+                    _qualityScores[s.id] = { quality_score: s.quality_score, flags: s.flags || [] };
+                }
+                // Enrich catalog sections with quality data
+                for (const s of _templateCatalog.sections) {
+                    const q = _qualityScores[s.id];
+                    if (q) {
+                        s.quality_score = q.quality_score;
+                        s.quality_flags = q.flags;
+                    } else {
+                        s.quality_score = 0;
+                        s.quality_flags = ['unscored'];
+                    }
+                }
+                console.error(`[TEMPLATE] Quality scores loaded: ${Object.keys(_qualityScores).length} sections scored`);
+            } catch (e) {
+                console.error(`[TEMPLATE] Failed to load quality scores: ${e.message}`);
+            }
+        }
         return _templateCatalog;
     } catch (e) {
         console.error(`[TEMPLATE] Failed to load catalog: ${e.message}`);
@@ -936,6 +972,8 @@ function extractContentSlots(element, path = []) {
             slots.push({ widget: element, path: [...path], type: 'accordion', items: s.tabs || s.items || [] });
         } else if (wt === 'image-box') {
             slots.push({ widget: element, path: [...path], type: 'image-box', title: s.title_text || '', description: s.description_text || '' });
+        } else if (wt === 'icon-list') {
+            slots.push({ widget: element, path: [...path], type: 'icon-list', items: s.icon_list || [] });
         } else if (wt === 'icon') {
             slots.push({ widget: element, path: [...path], type: 'icon', icon: s.selected_icon || {} });
         }
@@ -1088,6 +1126,37 @@ function structureContentBlock(block) {
  * Inject structured content into a section's widgets.
  * Deep clones the section first to avoid mutation.
  */
+/**
+ * Add site-specific boilerplate fields to a template section.
+ * - jet_parallax_layout_list: [] on all containers
+ * - plus_tooltip_content_desc on all widgets
+ * - layout: full_width on root container
+ */
+function addBoilerplate(section, isRoot = true) {
+    if (!section) return section;
+    if (isRoot && section.elType === 'container') {
+        if (!section.settings) section.settings = {};
+        section.settings.layout = 'full_width';
+    }
+    if (section.elType === 'container') {
+        if (!section.settings) section.settings = {};
+        if (!section.settings.jet_parallax_layout_list) {
+            section.settings.jet_parallax_layout_list = [];
+        }
+    }
+    if (section.widgetType) {
+        if (!section.settings) section.settings = {};
+        if (!section.settings.plus_tooltip_content_desc) {
+            // PHP validator uses empty() which treats '' as empty — needs non-empty value
+            section.settings.plus_tooltip_content_desc = 'Luctus nec ullamcorper mattis';
+        }
+    }
+    if (Array.isArray(section.elements)) {
+        section.elements.forEach(child => addBoilerplate(child, false));
+    }
+    return section;
+}
+
 function injectContent(section, content) {
     const injected = JSON.parse(JSON.stringify(section));
     const slots = extractContentSlots(injected);
@@ -1169,37 +1238,100 @@ function injectContent(section, content) {
         changes++;
     }
 
-    // Also fill image-boxes
+    // Fill image-boxes with items that overflow from icon-boxes (or all items if no icon-boxes)
+    const imageBoxStartIdx = Math.min(iconBoxes.length, items.length);
     for (let i = 0; i < imageBoxes.length; i++) {
-        const itemIdx = iconBoxes.length + i;
+        const itemIdx = imageBoxStartIdx + i;
         if (itemIdx < items.length) {
             imageBoxes[i].widget.settings.title_text = items[itemIdx].title;
             if (items[itemIdx].description) {
                 imageBoxes[i].widget.settings.description_text = items[itemIdx].description;
             }
             changes++;
+        } else if (i < items.length && iconBoxes.length === 0) {
+            // No icon-boxes at all — image-boxes get items from the start
+            imageBoxes[i].widget.settings.title_text = items[i].title;
+            if (items[i].description) {
+                imageBoxes[i].widget.settings.description_text = items[i].description;
+            }
+            changes++;
         }
     }
 
-    // Inject buttons
+    // Inject icon-list widgets with items (bullet lists in about, pricing features, etc.)
+    const iconLists = slots.filter(s => s.type === 'icon-list');
+    // Items for icon-lists come from content.items that overflow past icon-boxes + image-boxes,
+    // OR from content.items directly if there are no icon-boxes/image-boxes
+    const iconListItemStart = iconBoxes.length + imageBoxes.length;
+    const iconListItems = items.length > iconListItemStart ? items.slice(iconListItemStart) : (iconBoxes.length === 0 && imageBoxes.length === 0 ? items : []);
+    let iconListItemIdx = 0;
+    for (const il of iconLists) {
+        const existing = il.widget.settings.icon_list || [];
+        if (existing.length === 0) continue;
+        const template = JSON.parse(JSON.stringify(existing[0]));
+        const remaining = iconListItems.slice(iconListItemIdx);
+        if (remaining.length === 0) continue;
+        // Build new items array: one per content item, up to capacity
+        const newItems = [];
+        for (let j = 0; j < remaining.length; j++) {
+            const item = JSON.parse(JSON.stringify(template));
+            item.text = remaining[j].title + (remaining[j].description ? ': ' + remaining[j].description : '');
+            item._id = Math.random().toString(36).substr(2, 7);
+            // Keep template icons unless they're placeholder circles
+            if (item.selected_icon && item.selected_icon.value === 'fas fa-circle') {
+                item.selected_icon = { value: SERVICE_ICONS[j % SERVICE_ICONS.length], library: 'fa-solid' };
+            }
+            newItems.push(item);
+        }
+        il.widget.settings.icon_list = newItems;
+        iconListItemIdx += remaining.length;
+        changes++;
+    }
+
+    // Inject buttons — fill all available button slots, always set both text and URL
     const contentButtons = content.buttons || [];
     for (let i = 0; i < buttons.length && i < contentButtons.length; i++) {
         buttons[i].widget.settings.text = contentButtons[i].text;
-        if (contentButtons[i].url && contentButtons[i].url !== '#') {
-            if (!buttons[i].widget.settings.link) buttons[i].widget.settings.link = {};
-            buttons[i].widget.settings.link.url = contentButtons[i].url;
-        }
+        if (!buttons[i].widget.settings.link) buttons[i].widget.settings.link = {};
+        buttons[i].widget.settings.link.url = contentButtons[i].url || '#';
         changes++;
     }
 
-    // Inject counters with stats
+    // Inject counters with stats — smart parsing for various formats
     const contentStats = content.stats || [];
     for (let i = 0; i < counters.length && i < contentStats.length; i++) {
-        const val = contentStats[i].value.replace(/[^0-9.]/g, '');
-        const suffix = contentStats[i].value.replace(/[\d,.]/g, '');
-        counters[i].widget.settings.ending_number = val || counters[i].widget.settings.ending_number;
-        if (suffix) counters[i].widget.settings.suffix = suffix;
-        if (contentStats[i].label && counters[i].widget.settings.title) {
+        const raw = String(contentStats[i].value || '').trim();
+        let num = '', suffix = '';
+
+        // Pattern: "24/7" → num=24, suffix="/7"
+        const fractionMatch = raw.match(/^(\d+)\/(\d+)$/);
+        // Pattern: "$49" or "$49/month" → num=49, suffix="/month" or ""
+        const currencyMatch = raw.match(/^\$(\d[\d,]*\.?\d*)(.*)$/);
+        // Pattern: "500+" or "98%" or "15" → extract leading number and trailing suffix
+        const generalMatch = raw.match(/^(\d[\d,]*\.?\d*)\s*(.*)$/);
+
+        if (fractionMatch) {
+            num = fractionMatch[1];
+            suffix = '/' + fractionMatch[2];
+        } else if (currencyMatch) {
+            num = currencyMatch[1].replace(/,/g, '');
+            suffix = currencyMatch[2].trim();
+            // Prepend $ as prefix if widget supports it
+            if (counters[i].widget.settings.prefix !== undefined) {
+                counters[i].widget.settings.prefix = '$';
+            }
+        } else if (generalMatch) {
+            num = generalMatch[1].replace(/,/g, '');
+            suffix = generalMatch[2].trim();
+        }
+
+        if (num) {
+            counters[i].widget.settings.ending_number = num;
+        }
+        // Always set suffix — clear it if source has none (prevents leak from original)
+        counters[i].widget.settings.suffix = suffix;
+
+        if (contentStats[i].label && counters[i].widget.settings.title !== undefined) {
             counters[i].widget.settings.title = contentStats[i].label;
         }
         changes++;
@@ -1295,6 +1427,83 @@ function injectContent(section, content) {
         }
     }
 
+    // ── Clear unfilled slots to remove template placeholder content ──
+    // Track which slots were filled above, then clear the rest
+    const HIDDEN_CLASSES = 'elementor-hidden-desktop elementor-hidden-tablet elementor-hidden-mobile';
+
+    // Headings: clear unfilled ones (beyond main + subheading + paragraph-filled ones)
+    const filledHeadingCount = (content.heading ? 1 : 0) + (content.subheading ? 1 : 0) + Math.min(paragraphs.length, Math.max(0, headings.length - 2));
+    for (let i = filledHeadingCount; i < headings.length; i++) {
+        if (headings[i].widget.settings.title && headings[i].widget.settings.title !== content.heading && headings[i].widget.settings.title !== content.subheading) {
+            headings[i].widget.settings.title = '';
+            changes++;
+        }
+    }
+
+    // Text-editors: clear unfilled ones
+    if (paragraphs.length === 0) {
+        // No paragraphs at all — don't clear, the template text may be structural
+    } else {
+        // First text-editor got content; clear the rest
+        for (let i = 1; i < texts.length; i++) {
+            if (texts[i].widget.settings.editor) {
+                texts[i].widget.settings.editor = '';
+                changes++;
+            }
+        }
+    }
+
+    // Icon-boxes: hide excess (more template slots than content items)
+    for (let i = items.length; i < iconBoxes.length; i++) {
+        // Hide this icon-box's immediate parent container if all siblings are also excess
+        iconBoxes[i].widget.settings.title_text = '';
+        iconBoxes[i].widget.settings.description_text = '';
+        if (!iconBoxes[i].widget.settings._css_classes) iconBoxes[i].widget.settings._css_classes = '';
+        iconBoxes[i].widget.settings._css_classes = HIDDEN_CLASSES;
+        iconBoxes[i].widget.settings.css_classes = HIDDEN_CLASSES;
+        changes++;
+    }
+
+    // Image-boxes: clear unfilled ones
+    const filledImageBoxes = Math.min(imageBoxes.length, Math.max(0, items.length - iconBoxes.length));
+    for (let i = filledImageBoxes; i < imageBoxes.length; i++) {
+        imageBoxes[i].widget.settings.title_text = '';
+        imageBoxes[i].widget.settings.description_text = '';
+        changes++;
+    }
+
+    // Buttons: hide excess beyond provided content buttons
+    for (let i = contentButtons.length; i < buttons.length; i++) {
+        if (!buttons[i].widget.settings._css_classes) buttons[i].widget.settings._css_classes = '';
+        buttons[i].widget.settings._css_classes = HIDDEN_CLASSES;
+        buttons[i].widget.settings.css_classes = HIDDEN_CLASSES;
+        changes++;
+    }
+
+    // Counters: clear excess beyond provided stats
+    for (let i = contentStats.length; i < counters.length; i++) {
+        counters[i].widget.settings.title = '';
+        counters[i].widget.settings._css_classes = HIDDEN_CLASSES;
+        counters[i].widget.settings.css_classes = HIDDEN_CLASSES;
+        changes++;
+    }
+
+    // Testimonials: clear excess beyond provided quotes
+    for (let i = quotes.length; i < testimonials.length; i++) {
+        testimonials[i].widget.settings.testimonial_content = '';
+        testimonials[i].widget.settings.testimonial_name = '';
+        changes++;
+    }
+
+    // Icon-lists: clear unfilled ones (those not already injected above)
+    for (let i = 0; i < iconLists.length; i++) {
+        // If this icon-list wasn't touched by injection (no items to give it), clear it
+        if (iconListItemIdx === 0 && items.length === 0) {
+            // No items at all — leave template icon-lists as-is (may be structural)
+        }
+        // Otherwise, icon-lists that got zero items from overflow should be cleared
+    }
+
     return { section: injected, changes };
 }
 
@@ -1474,11 +1683,12 @@ function getToolDefinitions() {
         },
         {
             name: 'set_design_tokens',
-            description: 'Save design tokens to WordPress. Requires manage_options capability.',
+            description: 'Save design tokens to WordPress. Default mode is "patch" (deep-merge with existing tokens). Use mode "replace" to overwrite all tokens. Requires manage_options capability.',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    tokens: { type: 'object', description: 'Full or partial token object to save' }
+                    tokens: { type: 'object', description: 'Full or partial token object to save' },
+                    mode: { type: 'string', enum: ['patch', 'replace'], description: 'Save mode: "patch" (default) deep-merges with existing tokens; "replace" overwrites all tokens' }
                 },
                 required: ['tokens']
             }
@@ -1555,7 +1765,8 @@ function getToolDefinitions() {
                 properties: {
                     page_id: { type: 'number', description: 'WordPress page ID' },
                     template: { type: 'object', description: 'Elementor JSON: {content:[...]} or array of sections' },
-                    mode: { type: 'string', enum: ['replace', 'append'], description: 'Import mode (default: replace)' }
+                    mode: { type: 'string', enum: ['replace', 'append'], description: 'Import mode (default: replace)' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id', 'template']
             }
@@ -1592,7 +1803,8 @@ function getToolDefinitions() {
                     category: { type: 'string', description: 'Component category: heroes, intros, stats, conditions, comparisons, videos, ctas, teams, tabs, blocks, cards' },
                     name: { type: 'string', description: 'Component name (e.g., "hero-two-col-soft-blue", "stats-bar-4col-dark")' },
                     variables: { type: 'object', description: 'Variable values to populate (heading, description, buttons, etc.)' },
-                    position: { type: 'string', description: 'Where to add: "append" (default), "prepend", or numeric index' }
+                    position: { type: 'string', description: 'Where to add: "append" (default), "prepend", or numeric index' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id', 'category', 'name']
             }
@@ -1616,7 +1828,8 @@ function getToolDefinitions() {
                             }
                         }
                     },
-                    mode: { type: 'string', enum: ['replace', 'append'], description: 'Build mode (default: replace)' }
+                    mode: { type: 'string', enum: ['replace', 'append'], description: 'Build mode (default: replace)' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id', 'sections']
             }
@@ -1640,7 +1853,8 @@ function getToolDefinitions() {
                 properties: {
                     page_id: { type: 'number', description: 'WordPress page ID' },
                     index: { type: 'number', description: 'Section index (0-based). Use list_sections to find the right index.' },
-                    section_id: { type: 'string', description: 'Elementor section ID (alternative to index)' }
+                    section_id: { type: 'string', description: 'Elementor section ID (alternative to index)' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id']
             }
@@ -1666,7 +1880,8 @@ function getToolDefinitions() {
                         type: 'array',
                         description: 'Full reorder: array of current indices in desired order, e.g. [2,0,1,3]',
                         items: { type: 'number' }
-                    }
+                    },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id']
             }
@@ -1679,7 +1894,47 @@ function getToolDefinitions() {
                 properties: {
                     page_id: { type: 'number', description: 'WordPress page ID' },
                     section_index: { type: 'number', description: 'Only show this section (0-based). Omit to show all sections.' },
-                    depth: { type: 'number', description: 'Max nesting depth (default: 3)' }
+                    depth: { type: 'number', description: 'Max nesting depth (default: 10). When exceeded, returns children_ids stubs with {id, type, widget}.' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'get_section_json',
+            description: 'Get the full JSON for a single section by ID or index. Token-saving alternative to export_page when you only need one section. Returns complete nested element tree with all settings.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    section_id: { type: 'string', description: 'Elementor section ID. Use this OR section_index.' },
+                    section_index: { type: 'number', description: '0-based section index. Use this OR section_id.' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'update_children',
+            description: 'Recursively update all descendants of a parent element. Sets or removes settings properties on every child, grandchild, etc. — but NOT the parent itself. Supports optional filter to only modify specific element types (e.g. only containers or only headings).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    parent_id: { type: 'string', description: 'Elementor ID of the parent element whose children to update' },
+                    set_properties: { type: 'object', description: 'Key-value pairs to set on each descendant\'s settings', additionalProperties: true },
+                    remove_properties: { type: 'array', items: { type: 'string' }, description: 'Setting keys to remove from each descendant' },
+                    filter: { type: 'object', description: 'Only modify descendants matching this filter. Example: {"elType":"container"} or {"widgetType":"heading"}', additionalProperties: true },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
+                },
+                required: ['page_id', 'parent_id']
+            }
+        },
+        {
+            name: 'check_page_lock',
+            description: 'Check if a page is being edited by someone in the Elementor editor or by another MCP operation. Returns WP post lock (user, time) and MCP transient lock info. Use before write operations to avoid conflicts.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' }
                 },
                 required: ['page_id']
             }
@@ -1691,19 +1946,36 @@ function getToolDefinitions() {
                 type: 'object',
                 properties: {
                     page_id: { type: 'number', description: 'WordPress page ID' },
-                    element_id: { type: 'string', description: 'Elementor element ID to remove' }
+                    element_id: { type: 'string', description: 'Elementor element ID to remove' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id', 'element_id']
             }
         },
+        {
+            name: 'move_element',
+            description: 'Move an element from its current parent to a different parent container. Atomic server-side operation — no data loss. Prevents circular moves.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Page ID' },
+                    element_id: { type: 'string', description: 'Element ID to move' },
+                    target_parent_id: { type: 'string', description: 'Target parent container ID' },
+                    position: { type: 'number', description: 'Position in target (0-based). Omit to append.' },
+                    force: { type: 'boolean', description: 'Override edit lock' }
+                },
+                required: ['page_id', 'element_id', 'target_parent_id']
+            }
+        },
         {
             name: 'update_element',
-            description: 'Update any element\'s settings by its Elementor ID. Patch widget properties like hover_color, background_color, __globals__ overrides, text, link URLs, etc. Supports dot-notation for nested keys (e.g. "__globals__.hover_color"). Use list_elements or export_page first to find the element ID and current settings. IMPORTANT: Prefer settings_json (JSON string) over settings (object) for reliable MCP transport.',
+            description: 'Update any element\'s settings by its Elementor ID or path. Patch widget properties like hover_color, background_color, __globals__ overrides, text, link URLs, etc. Supports dot-notation for nested keys (e.g. "__globals__.hover_color"). Supports element_path as alternative to element_id (e.g. "sectionId/1/0" = section → child 1 → child 0). Use list_elements or export_page first to find the element ID and current settings. IMPORTANT: Prefer settings_json (JSON string) over settings (object) for reliable MCP transport. AUTO-INJECTED KEYS: background_background:"classic" auto-set when you set background_color; typography_typography:"custom" auto-set when you set font properties; flex_grow expands to all 3 required keys; grid column strings auto-wrapped in object format. ICON WIDGET: For view="default" use "icon_size" for dimensions. For view="stacked" or "framed" (circle/square background) use "size" instead — "icon_size" is silently ignored in stacked/framed mode.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     page_id: { type: 'number', description: 'WordPress page ID' },
                     element_id: { type: 'string', description: 'Elementor element ID to update' },
+                    element_path: { type: 'string', description: 'Path to element: "sectionId/childIndex/childIndex". Alternative to element_id.' },
                     settings: {
                         type: 'object',
                         description: 'Key-value pairs of settings to set. May not work reliably via MCP — use settings_json instead.',
@@ -1712,9 +1984,10 @@ function getToolDefinitions() {
                     settings_json: {
                         type: 'string',
                         description: 'Settings as a JSON string (preferred over settings object for reliable MCP transport). Example: \'{"hover_color":"#FFFFFF","__globals__":{"hover_color":""}}\''
-                    }
+                    },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
-                required: ['page_id', 'element_id']
+                required: ['page_id']
             }
         },
         {
@@ -1786,7 +2059,8 @@ function getToolDefinitions() {
                     replace: { type: 'string', description: 'Replacement text' },
                     regex: { type: 'boolean', description: 'Treat search as regex pattern. Default: false (literal).' },
                     page_id: { type: 'number', description: 'Optional: only search this page' },
-                    dry_run: { type: 'boolean', description: 'Preview changes without saving. Default: true (SAFE). Set to false to apply changes.' }
+                    dry_run: { type: 'boolean', description: 'Preview changes without saving. Default: true (SAFE). Set to false to apply changes.' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['search', 'replace']
             }
@@ -1800,7 +2074,8 @@ function getToolDefinitions() {
                     source_page_id: { type: 'number', description: 'Page ID to copy FROM' },
                     element_id: { type: 'string', description: 'Elementor element ID to copy' },
                     target_page_id: { type: 'number', description: 'Page ID to copy TO' },
-                    position: { type: 'string', description: 'Where to place: "append" (default), "prepend", or section index number' }
+                    position: { type: 'string', description: 'Where to place: "append" (default), "prepend", or section index number' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['source_page_id', 'element_id', 'target_page_id']
             }
@@ -2039,6 +2314,18 @@ function getToolDefinitions() {
                 required: ['template_id', 'elementor_data']
             }
         },
+        {
+            name: 'display_conditions',
+            description: 'Get or set Elementor Theme Builder display conditions on a template (header, footer, single, archive). Common conditions: "include/general" (entire site), "include/singular/page" (all pages), "include/singular/post" (all posts), "include/archive" (all archives).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    template_id: { type: 'number', description: 'Template ID (from list_templates)' },
+                    conditions: { type: 'array', items: { type: 'string' }, description: 'Array of condition strings. Omit to read current conditions.' }
+                },
+                required: ['template_id']
+            }
+        },
         {
             name: 'audit_placeholders',
             description: 'Scan all published Elementor pages for placeholder text (e.g. "Add Your Heading Text Here", "Lorem ipsum"), empty sections with no content, and broken anchor links (#). Optionally include library templates.',
@@ -2083,7 +2370,8 @@ function getToolDefinitions() {
                     page_id: { type: 'number', description: 'WordPress page ID' },
                     parent_id: { type: 'string', description: 'Elementor ID of the parent container to insert into' },
                     element: { type: 'object', description: 'Full Elementor element JSON: {elType, widgetType, settings, elements, ...}', additionalProperties: true },
-                    position: { type: 'number', description: 'Optional: insert at this index (0-based). Omit to append at end.' }
+                    position: { type: 'number', description: 'Optional: insert at this index (0-based). Omit to append at end.' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['page_id', 'parent_id', 'element']
             }
@@ -2122,7 +2410,8 @@ function getToolDefinitions() {
                     updates_json: {
                         type: 'string',
                         description: 'Updates as a JSON string (preferred). Example: \'[{"page_id":123,"element_id":"abc","settings":{"title":"New"}}]\''
-                    }
+                    },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 }
             }
         },
@@ -2176,6 +2465,192 @@ function getToolDefinitions() {
                 }
             }
         },
+        {
+            name: 'audit_db_health',
+            description: 'Read-only WordPress database health audit. Reports: post revision count (+ top pages by revision), expired transient count, autoloaded options total size + top 10 largest, orphaned postmeta count. Includes actionable cleanup recommendations. No data is modified.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'audit_image_sizes',
+            description: 'Scan Elementor pages for images using oversized WordPress sizes ("full" or "large"). Reports element ID, widget type, current size, actual file dimensions, and recommended size. Use to identify images that could be replaced with smaller WP registered sizes (medium_large, medium) to reduce page weight.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: audit only this page. Omit to scan all Elementor pages.' }
+                }
+            }
+        },
+        {
+            name: 'fix_image_sizes',
+            description: 'Batch-fix Elementor images using oversized WP sizes (full/large). Updates image_size on image and image-box widgets to a smaller registered size. Container background images are automatically excluded. Run audit_image_sizes first, or use dry_run=true to preview changes before applying.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: fix only this page. Omit to fix all Elementor pages.' },
+                    target_size: { type: 'string', description: 'WP registered size to apply (default: medium_large). Options: thumbnail, medium, medium_large.' },
+                    dry_run: { type: 'boolean', description: 'Preview changes without saving (default: false). Use true first to review.' },
+                    exclude_ids: { type: 'array', items: { type: 'string' }, description: 'Elementor element IDs to skip (e.g. hero images you want to keep at full size).' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false).' }
+                }
+            }
+        },
+        {
+            name: 'search_post_content',
+            description: 'Search across all published WordPress post/page content (Gutenberg, classic editor, raw HTML) for a given string. Returns matching posts with snippets showing context around each match. Use to find S3 URLs, old domains, broken shortcodes, or any text pattern in post_content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    search: { type: 'string', description: 'Text to search for in post_content (case-insensitive).' },
+                    post_type: { type: 'string', description: 'Filter by post type: "post", "page", or "any" (default: any — searches posts and pages).' },
+                    limit: { type: 'number', description: 'Max posts to return (default: 500, max: 500).' },
+                    extract_urls: { type: 'boolean', description: 'Extract full URLs containing the search term. Returns per-post URLs and a deduplicated list of all unique URLs (default: false).' }
+                },
+                required: ['search']
+            }
+        },
+        {
+            name: 'replace_post_content',
+            description: 'Bulk find-replace in WordPress post_content (Gutenberg/classic editor). Use for migrating URLs, fixing domains, replacing shortcodes. Always dry_run=true first to preview. Works on published posts and pages.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    search: { type: 'string', description: 'Text to find in post_content.' },
+                    replace: { type: 'string', description: 'Replacement text.' },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true). Set false to apply.' },
+                    regex: { type: 'boolean', description: 'Treat search as PHP regex pattern (without delimiters). Use $1, $2 for capture groups in replace. Default: false.' },
+                    post_type: { type: 'string', description: 'Filter: "post", "page", or "any" (default: any).' },
+                    limit: { type: 'number', description: 'Max posts to process (default: 500).' }
+                },
+                required: ['search', 'replace']
+            }
+        },
+        {
+            name: 'set_faq_schema',
+            description: 'Set FAQPage JSON-LD schema on a single post. Stores in post meta and auto-injects into page head. Use for adding FAQ rich snippets to posts with Q&A content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post ID.' },
+                    faqs: { type: 'array', items: { type: 'object', properties: { question: { type: 'string' }, answer: { type: 'string' } }, required: ['question', 'answer'] }, description: 'Array of {question, answer} objects.' },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true).' }
+                },
+                required: ['post_id', 'faqs']
+            }
+        },
+        {
+            name: 'import_faq_schemas',
+            description: 'Bulk import FAQPage schemas from faq-schema-posts.json format. Matches posts by slug and stores FAQPage JSON-LD in post meta. Always dry_run first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    posts: { type: 'array', description: 'Array of {slug, faq_schema: [{question, answer}]} objects.' },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true).' }
+                },
+                required: ['posts']
+            }
+        },
+        {
+            name: 'get_global_styles',
+            description: 'Read Elementor global colors and fonts from the active kit. Returns system colors (Primary, Secondary, Text, Accent), custom colors, system typography, and custom typography with all properties.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'set_global_styles',
+            description: 'Update Elementor global colors and/or fonts on the active kit. Supports system_colors, custom_colors, system_typography, custom_typography. Updates existing entries by ID or creates new ones. Clears Elementor CSS cache after applying. Always dry_run=true first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    system_colors: { type: 'array', description: 'Array of {id, title?, color} — update system colors (primary, secondary, text, accent).', items: { type: 'object' } },
+                    custom_colors: { type: 'array', description: 'Array of {id, title?, color} — update or add custom palette colors.', items: { type: 'object' } },
+                    system_typography: { type: 'array', description: 'Array of {id, title?, font_family, font_weight?, font_size?, line_height?, letter_spacing?, text_transform?}.', items: { type: 'object' } },
+                    custom_typography: { type: 'array', description: 'Array of {id, title?, font_family, font_weight?, font_size?, line_height?, letter_spacing?, text_transform?}.', items: { type: 'object' } },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true).' }
+                }
+            }
+        },
+        {
+            name: 'audit_broken_images',
+            description: 'Scan all published posts and Elementor pages for broken images (non-200 HTTP responses). Checks <img> tags in post_content and image/image-box widgets + background images in Elementor data. Returns broken URLs with HTTP status, error details, and which posts are affected.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: scan only this page.' },
+                    source: { type: 'string', description: 'What to scan: "all" (default), "elementor", or "content" (post_content only).' },
+                    timeout: { type: 'number', description: 'HTTP HEAD timeout in seconds per image (default: 5, max: 15).' }
+                }
+            }
+        },
+        // ── ACF Fields ──
+        {
+            name: 'list_acf_field_groups',
+            description: 'List all ACF field groups with their fields and post type assignments. Shows field group title, key, active status, assigned post types, and all fields with type, name, label. Use to discover what custom fields exist on the site.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'get_acf_fields',
+            description: 'Get all ACF field values for a specific post. Returns field names, labels, types, and current values. Supports all ACF field types including repeater and group fields.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post ID to get ACF fields for.' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'set_acf_fields',
+            description: 'Set/update ACF field values on a post. Accepts a JSON object of field_name: value pairs. Always dry_run=true first to preview.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post ID to update.' },
+                    fields: { type: 'object', description: 'Object of field_name: value pairs. Example: {"hero_title": "New Title", "show_sidebar": true}' },
+                    dry_run: { type: 'boolean', description: 'Preview changes without saving (default: true). Set false to apply.' }
+                },
+                required: ['post_id', 'fields']
+            }
+        },
+        {
+            name: 'create_acf_field_group',
+            description: 'Create a new ACF field group with fields and post type assignments. Supports field types: text, textarea, wysiwyg, number, url, image, select, true_false, repeater, group.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Field group title.' },
+                    fields: { type: 'array', items: { type: 'object' }, description: 'Array of field definitions: [{label, name, type, required?, default_value?, choices?, sub_fields?}]' },
+                    post_types: { type: 'array', items: { type: 'string' }, description: 'Post types to assign to (e.g. ["post", "page", "physician"]).' },
+                    active: { type: 'boolean', description: 'Whether field group is active (default: true).' }
+                },
+                required: ['title', 'fields']
+            }
+        },
+        {
+            name: 'delete_acf_field',
+            description: 'Remove a field from an ACF field group by field key. Use list_acf_field_groups first to find the key. Permanently deletes the field definition — existing values in post meta are NOT removed.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    field_key: { type: 'string', description: 'ACF field key to delete (e.g. "field_64a1b2c3d4e5f").' }
+                },
+                required: ['field_key']
+            }
+        },
+        // ── Audits ──
+        {
+            name: 'audit_orphan_pages',
+            description: 'Find pages with no internal links pointing to them. Cross-references all link targets (Elementor data + post content + nav menus) against all published pages. Orphan pages are hard for search engines to discover.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'audit_h1',
+            description: 'Scan all Elementor pages for H1 heading issues. Every page should have exactly one H1. Flags pages with missing H1 (bad for SEO) or multiple H1s (confusing hierarchy).',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'audit_redirect_chains',
+            description: 'Detect redirect chains (A→B→C) among internal URLs. Each extra hop slows page load and dilutes SEO link equity. Checks up to 200 internal URLs via HTTP HEAD with redirect following.',
+            inputSchema: { type: 'object', properties: {} }
+        },
         // ── Section Operations ──
         {
             name: 'copy_section',
@@ -2186,7 +2661,8 @@ function getToolDefinitions() {
                     source_id: { type: 'number', description: 'Page or template ID to copy FROM' },
                     section_index: { type: 'number', description: 'Zero-based index of the section to copy (use list_sections to find it)' },
                     target_id: { type: 'number', description: 'Page or template ID to copy TO' },
-                    position: { type: 'string', description: 'Where to place: "end" (default), "start", or numeric index' }
+                    position: { type: 'string', description: 'Where to place: "end" (default), "start", or numeric index' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['source_id', 'section_index', 'target_id']
             }
@@ -2200,7 +2676,8 @@ function getToolDefinitions() {
                     target_id: { type: 'number', description: 'Page or template ID to append to' },
                     section: { type: 'object', description: 'Full Elementor section object (must have elType and elements)' },
                     position: { type: 'string', description: 'Where to place: "end" (default), "start", or numeric index' },
-                    regenerate_ids: { type: 'boolean', description: 'Regenerate all element IDs to avoid collisions (default: true)' }
+                    regenerate_ids: { type: 'boolean', description: 'Regenerate all element IDs to avoid collisions (default: true)' },
+                    force: { type: 'boolean', description: 'Override edit locks (default: false)' }
                 },
                 required: ['target_id', 'section']
             }
@@ -2373,6 +2850,11 @@ function getToolDefinitions() {
                 required: ['enabled']
             }
         },
+        {
+            name: 'scan_shortcodes',
+            description: 'Scan all published pages/posts for NVBC shortcode usage ([nvbc_categories], [nvbc_list_category], [nvbc_excerpt], [nvbc_category_list]). Shows which pages use which shortcodes and where (post_content vs Elementor data). Use this to determine if shortcodes are safe to disable. No AI tokens used — pure PHP scan.',
+            inputSchema: { type: 'object', properties: {} }
+        },
         {
             name: 'get_site_profile',
             description: 'Get the site profile — stored preferences, URLs, design conventions, and team info. Use this at the start of a session to understand site context.',
@@ -2441,6 +2923,31 @@ function getToolDefinitions() {
                 type: 'object',
                 properties: {}
             }
+        },
+        {
+            name: 'clean_globals',
+            description: 'Remove __globals__ references pointing to color/font IDs that don\'t exist in the current Elementor kit. Fixes foreign CSS rendering from imported content. Dry-run by default.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Page ID to clean' },
+                    dry_run: { type: 'boolean', description: 'Preview changes without saving (default: true)' },
+                    force: { type: 'boolean', description: 'Override edit lock' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'set_front_page',
+            description: 'Set a WordPress page as the site\'s static front page. Optionally set a posts page too.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Page ID to set as front page' },
+                    blog_page_id: { type: 'number', description: 'Page ID for blog/posts page (optional)' }
+                },
+                required: ['page_id']
+            }
         }
     ];
 }
@@ -2494,7 +3001,7 @@ async function handleToolCall(name, args) {
     }
 
     case 'set_design_tokens': {
-        const r = await apiCall('/design-tokens', 'POST', { tokens: args.tokens });
+        const r = await apiCall('/design-tokens', 'POST', { tokens: args.tokens, mode: args.mode || 'patch' });
         if (r.success) {
             tokenCache.data = null; // Invalidate cache
             return ok(`Tokens saved successfully.\n\nUpdated tokens:\n${JSON.stringify(r.tokens, null, 2)}`);
@@ -2624,7 +3131,9 @@ async function handleToolCall(name, args) {
     }
 
     case 'import_template': {
-        const r = await apiCall(`/pages/${args.page_id}/import`, 'POST', { template: args.template, mode: args.mode || 'replace' });
+        const body = { template: args.template, mode: args.mode || 'replace' };
+        if (args.force) body.force = true;
+        const r = await apiCall(`/pages/${args.page_id}/import`, 'POST', body);
         return ok(r.success ? `Imported!\n${r.sections} sections, ${r.total_elements} elements (${r.mode})\n\n${r.preview_url}` : `Error: ${r.message}`);
     }
 
@@ -2686,12 +3195,14 @@ async function handleToolCall(name, args) {
     }
 
     case 'add_component': {
-        const r = await apiCall(`/pages/${args.page_id}/add-component`, 'POST', {
+        const body = {
             category: args.category,
             name: args.name,
             variables: args.variables || {},
             position: args.position || 'append'
-        });
+        };
+        if (args.force) body.force = true;
+        const r = await apiCall(`/pages/${args.page_id}/add-component`, 'POST', body);
         if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
         let msg = `Added ${r.component.category}/${r.component.name}!\n` +
             `ID: ${r.component.id}\nTotal sections: ${r.total_sections}\nPreview: ${r.preview_url}`;
@@ -2700,10 +3211,12 @@ async function handleToolCall(name, args) {
     }
 
     case 'build_page': {
-        const r = await apiCall(`/pages/${args.page_id}/build`, 'POST', {
+        const body = {
             sections: args.sections,
             mode: args.mode || 'replace'
-        });
+        };
+        if (args.force) body.force = true;
+        const r = await apiCall(`/pages/${args.page_id}/build`, 'POST', body);
         if (!r.success) return ok(`Build failed: ${r.message || 'Unknown error'}`);
         let buildMsg = `Page Built!\nSections: ${r.sections_built}\nElements: ${r.total_elements}\nMode: ${r.mode}\n\nPreview: ${r.preview_url}\nEdit: ${r.edit_url}`;
         if (r.post_placement_instructions?.length) {
@@ -2731,6 +3244,7 @@ async function handleToolCall(name, args) {
         const body = {};
         if (args.index !== undefined) body.index = args.index;
         if (args.section_id) body.section_id = args.section_id;
+        if (args.force) body.force = true;
         const r = await apiCall(`/pages/${args.page_id}/remove-section`, 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         return ok(`Removed section${r.removed?.id ? ` (ID: ${r.removed.id})` : ''}.\nRemaining sections: ${r.remaining_sections}`);
@@ -2741,6 +3255,7 @@ async function handleToolCall(name, args) {
         if (args.move) body.move = args.move;
         else if (args.swap) body.swap = args.swap;
         else if (args.order) body.order = args.order;
+        if (args.force) body.force = true;
         const r = await apiCall(`/pages/${args.page_id}/reorder`, 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         let msg = `Sections reordered! (${r.sections} total)\n`;
@@ -2775,6 +3290,11 @@ async function handleToolCall(name, args) {
             let result = line + '\n';
             if (el.children) {
                 el.children.forEach(c => { result += formatTree(c, indent + 1); });
+            } else if (el.children_ids) {
+                el.children_ids.forEach(c => {
+                    const label = c.widget ? `[${c.widget}]` : `<${c.type}>`;
+                    result += '  '.repeat(indent + 1) + `${label} id:${c.id}\n`;
+                });
             } else if (el.children_count) {
                 result += '  '.repeat(indent + 1) + `(${el.children_count} children, increase depth to see)\n`;
             }
@@ -2789,14 +3309,67 @@ async function handleToolCall(name, args) {
         return ok(msg);
     }
 
+    case 'get_section_json': {
+        const params = new URLSearchParams();
+        if (args.section_id) params.set('section_id', args.section_id);
+        if (args.section_index !== undefined) params.set('section_index', args.section_index);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/pages/${args.page_id}/section-json${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        return ok(`Section [${r.section_index}] (ID: ${r.section_id}) — ${r.widgets} widgets\n\n${JSON.stringify(r.elementor_data, null, 2)}`);
+    }
+
+    case 'update_children': {
+        const body = {
+            parent_id: args.parent_id,
+            set_properties: args.set_properties || {},
+            remove_properties: args.remove_properties || [],
+            force: args.force || false,
+        };
+        if (args.filter) body.filter = args.filter;
+        const r = await apiCall(`/pages/${args.page_id}/update-children`, 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        let msg = `Updated ${r.descendants_updated} descendants of ${r.parent_id} on page ${r.page_id}.`;
+        if (r.properties_set.length) msg += `\nSet: ${r.properties_set.join(', ')}`;
+        if (r.properties_removed.length) msg += `\nRemoved: ${r.properties_removed.join(', ')}`;
+        if (r.filter) msg += `\nFilter: ${JSON.stringify(r.filter)}`;
+        return ok(msg);
+    }
+
+    case 'check_page_lock': {
+        const r = await apiCall(`/pages/${args.page_id}/lock-status`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        if (!r.locked) return ok(`Page ${args.page_id}: Not locked — safe to edit.`);
+        let msg = `Page ${args.page_id}: LOCKED\n`;
+        if (r.wp_lock) {
+            msg += `  WP Editor: ${r.wp_lock.user} (${r.wp_lock.age_seconds}s ago)\n`;
+        }
+        if (r.mcp_lock) {
+            msg += `  MCP Tool: ${r.mcp_lock.tool} (started ${r.mcp_lock.time})\n`;
+        }
+        msg += `\nUse force=true on write operations to override.`;
+        return ok(msg);
+    }
+
     case 'remove_element': {
-        const r = await apiCall(`/pages/${args.page_id}/remove-element`, 'POST', {
-            element_id: args.element_id
-        });
+        const body = { element_id: args.element_id };
+        if (args.force) body.force = true;
+        const r = await apiCall(`/pages/${args.page_id}/remove-element`, 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         return ok(`Removed ${r.removed.type} (ID: ${r.removed.id}).\nRemaining sections: ${r.remaining_sections}`);
     }
 
+    case 'move_element': {
+        const r = await apiCall(`/pages/${args.page_id}/move-element`, 'POST', {
+            element_id: args.element_id,
+            target_parent_id: args.target_parent_id,
+            position: args.position,
+            force: parseBool(args.force),
+        });
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        return ok(`Moved ${r.element_type} (${r.element_id}) to parent ${r.target_parent_id}${r.position !== null ? ` at position ${r.position}` : ''}`);
+    }
+
     case 'update_element': {
         // Resolve settings: prefer settings_json (string) for reliable MCP transport, fall back to settings (object)
         let settings = null;
@@ -2816,10 +3389,14 @@ async function handleToolCall(name, args) {
         }
         const cleanSettings = deepStripCDATA(settings);
         try {
-            const r = await apiCall(`/pages/${args.page_id}/update-element`, 'POST', {
-                element_id: args.element_id,
-                settings: cleanSettings
-            });
+            const body = { settings: cleanSettings };
+            if (args.element_id) body.element_id = args.element_id;
+            if (args.element_path) body.element_path = args.element_path;
+            if (args.force) body.force = true;
+            if (!body.element_id && !body.element_path) {
+                return ok('Failed: Provide element_id or element_path.');
+            }
+            const r = await apiCall(`/pages/${args.page_id}/update-element`, 'POST', body);
             if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
             return ok(`Element ${r.element_id} updated on page ${r.page_id}.\nUpdated keys: ${r.updated_keys.join(', ')}`);
         } catch (err) {
@@ -2991,6 +3568,7 @@ async function handleToolCall(name, args) {
             dry_run: parseBool(args.dry_run, true), // default TRUE (safe)
         };
         if (args.page_id) body.page_id = args.page_id;
+        if (args.force) body.force = true;
         const r = await apiCall('/find-replace', 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
 
@@ -3014,12 +3592,14 @@ async function handleToolCall(name, args) {
     }
 
     case 'copy_element': {
-        const r = await apiCall('/copy-element', 'POST', {
+        const body = {
             source_page_id: args.source_page_id,
             element_id: args.element_id,
             target_page_id: args.target_page_id,
             position: args.position || 'append',
-        });
+        };
+        if (args.force) body.force = true;
+        const r = await apiCall('/copy-element', 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         let msg = `Element copied!\n`;
         msg += `Source: page ${r.source_page_id}, element ${r.original_id} (${r.element_type}`;
@@ -3350,6 +3930,19 @@ async function handleToolCall(name, args) {
         );
     }
 
+    case 'display_conditions': {
+        if (args.conditions) {
+            const r = await apiCall(`/templates/${args.template_id}/display-conditions`, 'POST', {
+                conditions: args.conditions,
+            });
+            return ok(`Set ${r.conditions.length} condition(s) on "${r.title}" (ID: ${r.template_id}):\n${r.conditions.join('\n')}`);
+        } else {
+            const r = await apiCall(`/templates/${args.template_id}/display-conditions`);
+            const conds = r.conditions && r.conditions.length ? r.conditions.join('\n') : '(none)';
+            return ok(`Display conditions for "${r.title}" (ID: ${r.template_id}):\n${conds}`);
+        }
+    }
+
     case 'audit_placeholders': {
         const qs = args.include_templates ? '?include_templates=1' : '';
         const r = await apiCall(`/audit-placeholders${qs}`);
@@ -3423,11 +4016,13 @@ async function handleToolCall(name, args) {
     // ── Element Operations (v3.6.0) ──
 
     case 'add_element': {
-        const r = await apiCall(`/pages/${args.page_id}/add-element`, 'POST', {
+        const body = {
             parent_id: args.parent_id,
             element: args.element,
             position: args.position
-        });
+        };
+        if (args.force) body.force = true;
+        const r = await apiCall(`/pages/${args.page_id}/add-element`, 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         return ok(`Element added!\nPage: ${r.page_id}\nParent: ${r.parent_id}\nNew element ID: ${r.element_id}${r.position !== null && r.position !== undefined ? `\nPosition: ${r.position}` : ' (appended)'}`);
     }
@@ -3481,9 +4076,9 @@ async function handleToolCall(name, args) {
                 settings: deepStripCDATA(settings)
             };
         });
-        const r = await apiCall('/batch-update-elements', 'POST', {
-            updates: cleanUpdates
-        });
+        const batchBody = { updates: cleanUpdates };
+        if (args.force) batchBody.force = true;
+        const r = await apiCall('/batch-update-elements', 'POST', batchBody);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         let out = `=== Batch Update ===\nTotal: ${r.total} | Succeeded: ${r.succeeded} | Failed: ${r.failed}\n`;
         if (r.failed > 0) {
@@ -3650,13 +4245,396 @@ async function handleToolCall(name, args) {
         }
     }
 
+    case 'audit_db_health': {
+        const r = await apiCall('/audit-db-health');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== DB HEALTH AUDIT ===\n`;
+        out += `\nRevisions: ${r.revisions.count}`;
+        if (r.revisions.top_pages?.length) {
+            out += ` (top pages by revision count)\n`;
+            r.revisions.top_pages.forEach(p => {
+                out += `  "${p.post_title}" (ID:${p.ID}) — ${p.revision_count} revisions\n`;
+            });
+        } else out += '\n';
+        out += `\nExpired Transients: ${r.expired_transients.count}\n`;
+        out += `\nAutoloaded Options: ${r.autoloaded_options.count} options, ${r.autoloaded_options.total_size_kb} KB total\n`;
+        if (r.autoloaded_options.top_10?.length) {
+            out += `  Top 10 largest:\n`;
+            r.autoloaded_options.top_10.forEach(o => {
+                out += `  ${o.size_kb} KB — ${o.name}\n`;
+            });
+        }
+        out += `\nOrphaned Postmeta: ${r.orphaned_postmeta.count} rows\n`;
+        if (r.recommendations?.length) {
+            out += `\nRecommendations:\n`;
+            r.recommendations.forEach(rec => { out += `  ⚠ ${rec}\n`; });
+        } else {
+            out += `\n✓ No critical issues found.\n`;
+        }
+        out += `\nNote: ${r.note}`;
+        return ok(out);
+    }
+
+    case 'audit_image_sizes': {
+        const params = new URLSearchParams();
+        if (args.page_id) params.set('page_id', args.page_id);
+        const qs = params.toString() ? `?${params}` : '';
+        const r = await apiCall(`/audit-image-sizes${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = `=== IMAGE SIZE AUDIT ===\n`;
+        out += `Pages scanned: ${s.pages_scanned} | Images checked: ${s.images_checked}\n`;
+        out += `Pages with issues: ${s.pages_with_issues} | Total flagged: ${s.total_flagged}\n`;
+        if (!r.flagged_pages?.length) {
+            out += `\n✓ No oversized images found.\n`;
+        } else {
+            r.flagged_pages.forEach(p => {
+                out += `\n[${p.page_id}] ${p.page_title}\n  ${p.url}\n`;
+                p.images.forEach(img => {
+                    out += `  • [${img.element_id}] ${img.widget_type} — size: ${img.current_size}`;
+                    if (img.file_dimensions) out += ` | file: ${img.file_dimensions}`;
+                    if (img.file_size_kb) out += ` (${img.file_size_kb} KB)`;
+                    out += `\n    → ${img.recommended}\n`;
+                    if (img.image_url) out += `    ${img.image_url}\n`;
+                });
+            });
+        }
+        out += `\nNote: ${r.note}`;
+        return ok(out);
+    }
+
+    case 'fix_image_sizes': {
+        const body = {};
+        if (args.page_id)     body.page_id     = args.page_id;
+        if (args.target_size) body.target_size = args.target_size;
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        if (args.exclude_ids?.length)   body.exclude_ids = args.exclude_ids;
+        if (args.force)       body.force       = args.force;
+        const r = await apiCall('/fix-image-sizes', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = r.dry_run ? `=== IMAGE SIZE FIX (DRY RUN) ===\n` : `=== IMAGE SIZE FIX ===\n`;
+        out += `Target size: ${r.target_size}\n`;
+        out += `Pages updated: ${s.pages_updated} | Images fixed: ${s.total_images_fixed}`;
+        if (s.pages_skipped) out += ` | Pages skipped (locked): ${s.pages_skipped}`;
+        out += '\n';
+        if (r.pages?.length) {
+            r.pages.forEach(p => {
+                out += `\n[${p.page_id}] ${p.page_title}${p.saved ? '' : ' (not saved)'}\n`;
+                p.changes.forEach(c => {
+                    out += `  • [${c.element_id}] ${c.widget_type}: ${c.from} → ${c.to}\n`;
+                });
+            });
+        }
+        if (r.skipped?.length) {
+            out += `\nSkipped (locked):\n`;
+            r.skipped.forEach(p => { out += `  • [${p.page_id}] ${p.title}: ${p.reason}\n`; });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'search_post_content': {
+        const params = new URLSearchParams();
+        params.set('search', args.search);
+        if (args.post_type) params.set('post_type', args.post_type);
+        if (args.limit)     params.set('limit', args.limit);
+        if (args.extract_urls) params.set('extract_urls', '1');
+        const r = await apiCall(`/search-post-content?${params}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = `=== SEARCH POST CONTENT ===\nSearch: "${r.search}"\nPosts matched: ${s.posts_matched} | Total matches: ${s.total_matches}\n`;
+        if (s.unique_url_count !== undefined) out += `Unique URLs: ${s.unique_url_count}\n`;
+        if (r.matches?.length) {
+            r.matches.forEach(m => {
+                out += `\n[${m.post_id}] ${m.post_title} (${m.post_type}) — ${m.match_count} match(es)\n`;
+                out += `  URL: ${m.url}\n`;
+                if (m.extracted_urls?.length) {
+                    m.extracted_urls.forEach(u => { out += `  🔗 ${u}\n`; });
+                } else {
+                    m.snippets.forEach(sn => { out += `  > ${sn}\n`; });
+                }
+            });
+        } else {
+            out += '\nNo matches found.';
+        }
+        if (r.unique_urls?.length) {
+            out += `\n\n=== ALL UNIQUE URLs (${r.unique_urls.length}) ===\n`;
+            r.unique_urls.forEach(u => { out += `${u}\n`; });
+        }
+        return ok(out);
+    }
+
+    case 'replace_post_content': {
+        const body = { search: args.search, replace: args.replace };
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        if (args.regex)     body.regex = args.regex;
+        if (args.post_type) body.post_type = args.post_type;
+        if (args.limit)     body.limit = args.limit;
+        const r = await apiCall('/replace-post-content', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = r.dry_run ? `=== REPLACE POST CONTENT (DRY RUN) ===\n` : `=== REPLACE POST CONTENT ===\n`;
+        out += `Search: "${r.search}"\nReplace: "${r.replace}"\n`;
+        out += `Posts changed: ${s.posts_changed} | Total replacements: ${s.total_replacements}\n`;
+        if (r.changed_posts?.length) {
+            r.changed_posts.forEach(p => {
+                out += `  [${p.post_id}] ${p.post_title} (${p.post_type}) — ${p.replacements} replacement(s)\n`;
+            });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'set_faq_schema': {
+        const body = { post_id: args.post_id, faqs: args.faqs };
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/set-faq-schema', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== SET FAQ SCHEMA (DRY RUN) ===\n` : `=== SET FAQ SCHEMA ===\n`;
+        out += `Post: [${r.post_id}] ${r.post_title}\n`;
+        out += `Questions: ${r.questions}\n`;
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'import_faq_schemas': {
+        const body = { posts: args.posts };
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/import-faq-schemas', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = r.dry_run ? `=== IMPORT FAQ SCHEMAS (DRY RUN) ===\n` : `=== IMPORT FAQ SCHEMAS ===\n`;
+        out += `Applied: ${s.applied} | Skipped: ${s.skipped} | Not found: ${s.not_found}\n`;
+        if (r.results?.length) {
+            r.results.forEach(p => {
+                if (p.status === 'not_found') {
+                    out += `  ❌ ${p.slug} — post not found\n`;
+                } else {
+                    out += `  ✅ [${p.post_id}] ${p.title} — ${p.questions} Q&As (${p.status})\n`;
+                }
+            });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'get_global_styles': {
+        const r = await apiCall('/global-styles');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== ELEMENTOR GLOBAL STYLES ===\nKit ID: ${r.kit_id}\n`;
+
+        out += `\n--- System Colors (${r.system_colors.length}) ---\n`;
+        r.system_colors.forEach(c => { out += `  [${c.id}] ${c.title}: ${c.color}\n`; });
+
+        out += `\n--- Custom Colors (${r.custom_colors.length}) ---\n`;
+        if (r.custom_colors.length) {
+            r.custom_colors.forEach(c => { out += `  [${c.id}] ${c.title}: ${c.color}\n`; });
+        } else { out += '  (none)\n'; }
+
+        out += `\n--- System Typography (${r.system_typography.length}) ---\n`;
+        r.system_typography.forEach(t => {
+            out += `  [${t.id}] ${t.title}: ${t.font_family || '(unset)'}`;
+            if (t.font_weight) out += ` ${t.font_weight}`;
+            if (t.font_size) out += ` ${typeof t.font_size === 'object' ? t.font_size.size + t.font_size.unit : t.font_size}`;
+            out += '\n';
+        });
+
+        out += `\n--- Custom Typography (${r.custom_typography.length}) ---\n`;
+        if (r.custom_typography.length) {
+            r.custom_typography.forEach(t => {
+                out += `  [${t.id}] ${t.title}: ${t.font_family || '(unset)'}`;
+                if (t.font_weight) out += ` ${t.font_weight}`;
+                out += '\n';
+            });
+        } else { out += '  (none)\n'; }
+
+        return ok(out);
+    }
+
+    case 'set_global_styles': {
+        const body = {};
+        if (args.system_colors)     body.system_colors = args.system_colors;
+        if (args.custom_colors)     body.custom_colors = args.custom_colors;
+        if (args.system_typography) body.system_typography = args.system_typography;
+        if (args.custom_typography) body.custom_typography = args.custom_typography;
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/global-styles', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== SET GLOBAL STYLES (DRY RUN) ===\n` : `=== SET GLOBAL STYLES ===\n`;
+        out += `Kit ID: ${r.kit_id}\n`;
+        if (r.changes?.length) {
+            r.changes.forEach(c => { out += `  • ${c}\n`; });
+        } else {
+            out += '  No changes detected.\n';
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'audit_broken_images': {
+        const params = new URLSearchParams();
+        if (args.page_id) params.set('page_id', args.page_id);
+        if (args.source)  params.set('source', args.source);
+        if (args.timeout) params.set('timeout', args.timeout);
+        const r = await apiCall(`/audit-broken-images?${params}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        const s = r.summary;
+        let out = `=== BROKEN IMAGE AUDIT ===\n`;
+        out += `Images checked: ${s.unique_images_checked} | Broken: ${s.broken_images} | Posts affected: ${s.posts_affected}\n`;
+        if (r.broken?.length) {
+            r.broken.forEach(b => {
+                out += `\n❌ ${b.url}\n`;
+                out += `   Status: ${b.error || ('HTTP ' + b.status)}\n`;
+                out += `   Found in:\n`;
+                b.found_in.forEach(loc => {
+                    out += `     [${loc.post_id}] ${loc.post_title} (${loc.source})\n`;
+                });
+            });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    // ── ACF Fields ──
+
+    case 'list_acf_field_groups': {
+        const r = await apiCall('/acf-field-groups');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== ACF FIELD GROUPS (${r.count}) ===\n`;
+        if (!r.field_groups?.length) {
+            out += 'No ACF field groups found.\n';
+        } else {
+            r.field_groups.forEach(g => {
+                out += `\n[${g.key}] ${g.title} ${g.active ? '' : '(INACTIVE)'}\n`;
+                if (g.post_types?.length) out += `  Post types: ${g.post_types.join(', ')}\n`;
+                if (g.fields?.length) {
+                    g.fields.forEach(f => {
+                        out += `  • ${f.name} (${f.type}) — "${f.label}"${f.required ? ' *required' : ''}\n`;
+                        if (f.sub_fields?.length) {
+                            f.sub_fields.forEach(sf => {
+                                out += `    └ ${sf.name} (${sf.type}) — "${sf.label}"\n`;
+                            });
+                        }
+                    });
+                }
+            });
+        }
+        return ok(out);
+    }
+
+    case 'get_acf_fields': {
+        const r = await apiCall(`/acf-fields?post_id=${args.post_id}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== ACF FIELDS: ${r.post_title} (ID:${r.post_id}) ===\n`;
+        if (!r.fields?.length) {
+            out += 'No ACF fields found for this post.\n';
+        } else {
+            r.fields.forEach(f => {
+                const val = typeof f.value === 'object' ? JSON.stringify(f.value, null, 2) : (f.value ?? '(empty)');
+                out += `\n  ${f.name} (${f.type}): ${val}\n`;
+            });
+        }
+        return ok(out);
+    }
+
+    case 'set_acf_fields': {
+        const body = { post_id: args.post_id, fields: args.fields };
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/acf-fields', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== SET ACF FIELDS (DRY RUN) ===\n` : `=== SET ACF FIELDS ===\n`;
+        out += `Post: [${r.post_id}] ${r.post_title}\nUpdated: ${r.updated} field(s)\n`;
+        if (r.results?.length) {
+            r.results.forEach(f => {
+                const icon = (f.status === 'updated' || f.status === 'would_update') ? '+' : 'x';
+                out += `  [${icon}] ${f.name}: ${JSON.stringify(f.old_value)} -> ${JSON.stringify(f.new_value)} (${f.status})\n`;
+            });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'create_acf_field_group': {
+        const body = { title: args.title, fields: args.fields };
+        if (args.post_types) body.post_types = args.post_types;
+        if (args.active !== undefined) body.active = args.active;
+        const r = await apiCall('/acf-field-groups', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== ACF FIELD GROUP CREATED ===\n`;
+        out += `Key: ${r.key}\nTitle: ${r.title}\nFields: ${r.field_count}\n`;
+        if (r.post_types?.length) out += `Post types: ${r.post_types.join(', ')}\n`;
+        return ok(out);
+    }
+
+    case 'delete_acf_field': {
+        const r = await apiCall(`/acf-field?field_key=${encodeURIComponent(args.field_key)}`, 'DELETE');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        return ok(`Deleted ACF field: "${r.label}" (${r.name}) [${r.field_key}] from group "${r.group_title}"`);
+    }
+
+    case 'audit_orphan_pages': {
+        const r = await apiCall('/audit-orphan-pages');
+        let msg = `=== ORPHAN PAGES ===\nTotal pages: ${r.total_pages} | Linked: ${r.linked_pages} | Orphans: ${r.orphan_count}\n`;
+        if (r.orphans && r.orphans.length) {
+            msg += '\nOrphan pages (no incoming internal links):\n';
+            for (const p of r.orphans) {
+                msg += `  - [${p.post_type}] ${p.title} (ID ${p.post_id})\n    ${p.permalink}\n`;
+            }
+        } else {
+            msg += '\nAll pages have incoming links — no orphans.\n';
+        }
+        return ok(msg);
+    }
+
+    case 'audit_h1': {
+        const r = await apiCall('/audit-h1');
+        let msg = `=== H1 HEADING AUDIT ===\nPages scanned: ${r.pages_scanned} | Missing H1: ${r.missing_h1} | Duplicate H1: ${r.duplicate_h1}\n`;
+        if (r.results && r.results.length) {
+            msg += '\nPages with H1 issues:\n';
+            for (const p of r.results) {
+                const label = p.issue === 'missing' ? 'MISSING' : `DUPLICATE (${p.h1_count})`;
+                msg += `  - ${p.title} (ID ${p.post_id}) — ${label}`;
+                if (p.h1_texts && p.h1_texts.length) {
+                    msg += ': ' + p.h1_texts.join(' | ');
+                }
+                msg += '\n';
+            }
+        } else {
+            msg += '\nAll pages have exactly one H1.\n';
+        }
+        return ok(msg);
+    }
+
+    case 'audit_redirect_chains': {
+        const r = await apiCall('/audit-redirect-chains');
+        let msg = `=== REDIRECT CHAINS ===\nURLs checked: ${r.urls_checked} | Chains found: ${r.chains_found}\n`;
+        if (r.chains && r.chains.length) {
+            msg += '\nRedirect chains (2+ hops):\n';
+            for (const c of r.chains) {
+                msg += `  - ${c.original_url} → ${c.final_url} (${c.hops} hops)\n`;
+                for (const hop of c.chain) {
+                    msg += `    ${hop.status}: ${hop.from} → ${hop.to}\n`;
+                }
+                if (c.locations && c.locations.length) {
+                    msg += `    Used on: ${c.locations.map(l => l.page_title).join(', ')}\n`;
+                }
+            }
+        } else {
+            msg += '\nNo redirect chains found.\n';
+        }
+        return ok(msg);
+    }
+
     case 'copy_section': {
-        const r = await apiCall('/copy-section', 'POST', {
+        const body = {
             source_id: args.source_id,
             section_index: args.section_index,
             target_id: args.target_id,
             position: args.position || 'end',
-        });
+        };
+        if (args.force) body.force = true;
+        const r = await apiCall('/copy-section', 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         let msg = `Section copied!\n`;
         msg += `Source: ID ${r.source_id}, section index ${r.section_index}\n`;
@@ -3669,12 +4647,15 @@ async function handleToolCall(name, args) {
     }
 
     case 'append_section': {
+        // Auto-add boilerplate to all appended sections
+        if (args.section) addBoilerplate(args.section);
         const body = {
             target_id: args.target_id,
             section: args.section,
             position: args.position || 'end',
         };
         if (args.regenerate_ids !== undefined) body.regenerate_ids = args.regenerate_ids;
+        if (args.force) body.force = true;
         const r = await apiCall('/append-section', 'POST', body);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
         let msg = `Section appended!\n`;
@@ -3713,12 +4694,27 @@ async function handleToolCall(name, args) {
         const catalog = getTemplateCatalog();
         if (!catalog) return ok('Template library not configured. Set TEMPLATE_LIBRARY_DIR env var.');
         let sections = catalog.sections;
+
+        // Filter out CoSpace (all legacy section/column structure) unless explicitly requested
+        if (!args.kit_id || !args.kit_id.includes('cospace')) {
+            sections = sections.filter(s => !s.kit_id.includes('cospace'));
+        }
+        // Filter out low-quality sections (score < 50) unless min_score overridden
+        const minScore = args.min_score !== undefined ? args.min_score : 50;
+        if (minScore > 0) {
+            sections = sections.filter(s => (s.quality_score || 0) >= minScore);
+        }
+
         if (args.kit_id) sections = sections.filter(s => s.kit_id === args.kit_id);
         if (args.type) sections = sections.filter(s => s.type === args.type);
         if (args.page_name) {
             const q = args.page_name.toLowerCase();
             sections = sections.filter(s => s.page_name.toLowerCase().includes(q));
         }
+
+        // Sort by quality score descending for best-first results
+        sections.sort((a, b) => (b.quality_score || 0) - (a.quality_score || 0));
+
         const limit = args.limit || 20;
         const total = sections.length;
         sections = sections.slice(0, limit);
@@ -3732,6 +4728,11 @@ async function handleToolCall(name, args) {
             msg += `  Type: ${s.type} (confidence: ${s.confidence})`;
             if (s.secondary_type) msg += ` | also: ${s.secondary_type}`;
             msg += '\n';
+            if (s.quality_score !== undefined) {
+                msg += `  Quality: ${s.quality_score}/100`;
+                if (s.quality_flags && s.quality_flags.length) msg += ` [${s.quality_flags.join(', ')}]`;
+                msg += '\n';
+            }
             const widgetSummary = Object.entries(s.features.widgets).map(([w,c]) => `${w}:${c}`).join(', ');
             msg += `  Widgets: ${widgetSummary || '(none)'}\n`;
             msg += `  Elements: ${s.features.total_elements} | Columns: ${s.features.column_count} | Depth: ${s.features.max_depth}\n`;
@@ -4077,6 +5078,9 @@ async function handleToolCall(name, args) {
                 }
             }
 
+            // Add site-specific boilerplate (jet_parallax, plus_tooltip, full_width)
+            addBoilerplate(final);
+
             // Append to page
             try {
                 const appendResult = await apiCall('/append-section', 'POST', {
@@ -4166,6 +5170,25 @@ async function handleToolCall(name, args) {
         return ok(r.message);
     }
 
+    case 'scan_shortcodes': {
+        const r = await apiCall('/scan-shortcodes');
+        let msg = `Shortcode scan: ${r.posts_scanned} posts scanned, ${r.posts_with_shortcodes} using shortcodes.\n\n`;
+        msg += 'Summary:\n';
+        for (const [sc, count] of Object.entries(r.shortcode_summary || {})) {
+            msg += `  [${sc}]: ${count} page(s)\n`;
+        }
+        if (r.results && r.results.length) {
+            msg += '\nPages with shortcodes:\n';
+            for (const p of r.results) {
+                msg += `  - ${p.title} (${p.post_type}, ID ${p.post_id}): ${p.shortcodes_found.join(', ')} [${p.locations.join(', ')}]\n`;
+                msg += `    Edit: ${p.edit_url}\n`;
+            }
+        } else {
+            msg += '\nNo pages use NVBC shortcodes — safe to disable.\n';
+        }
+        return ok(msg);
+    }
+
     case 'get_site_profile': {
         const r = await apiCall('/site-profile');
         let msg = '=== SITE PROFILE ===\n\n';
@@ -4286,6 +5309,22 @@ async function handleToolCall(name, args) {
         return ok(r.message || 'Audit started. Call get_audit_report in ~60s for results.');
     }
 
+    case 'clean_globals': {
+        const r = await apiCall(`/pages/${args.page_id}/clean-globals`, 'POST', {
+            dry_run: args.dry_run !== undefined ? parseBool(args.dry_run) : true,
+            force: parseBool(args.force),
+        });
+        return ok(`${r.dry_run ? '[DRY RUN] ' : ''}Cleaned ${r.foreign_globals_cleaned} foreign global references on page ${r.page_id}\nValid color IDs: ${r.valid_color_ids.join(', ')}\nValid font IDs: ${r.valid_font_ids.join(', ')}`);
+    }
+
+    case 'set_front_page': {
+        const r = await apiCall('/set-front-page', 'POST', {
+            page_id: args.page_id,
+            blog_page_id: args.blog_page_id,
+        });
+        return ok(`Front page set to "${r.front_page_title}" (ID: ${r.front_page_id})${r.blog_page_id ? `\nBlog page: ${r.blog_page_id}` : ''}`);
+    }
+
     default:
         throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }