@noleemits/vision-builder-control-mcp 4.5.5

package/index.js

@@ -0,0 +1,4361 @@
+#!/usr/bin/env node
+/**
+ * Noleemits Vision Builder Control MCP Server
+ *
+ * Provides 62 tools for building and managing WordPress/Elementor sites.
+ * 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)
+ * - Design rules (generated from tokens)
+ * - Button generator (context-aware, token-driven)
+ * - Page management (list, create)
+ * - Page validation, content extraction, template import
+ * - Section management (list, remove, reorder/move/swap)
+ * - Element-level operations (list tree, remove, update settings by ID)
+ * - Link audit & fix (scan all pages, ensure correct internal/external targets)
+ * - Page export/snapshot, image audit, global find & replace
+ * - Cross-page element copy, broken link checker
+ * - Component presets (get, set style overrides)
+ * - Component library, add component, build page
+ * - Posts CRUD (list, get, create, update, delete any post type)
+ * - RankMath SEO (get, update, audit across all content)
+ * - Taxonomies (list all, assign terms to posts)
+ * - Health check
+ * - Template library (list kits, browse sections, get section JSON, get tokens, rebrand, inject content, assemble page)
+ *
+ * Transport modes:
+ *   stdio (default)  — for Claude Desktop / Claude Code
+ *   --http           — HTTP/SSE server for Claude.ai web connectors
+ *   --port=N         — HTTP port (default: 3100)
+ *
+ * WordPress plugin: Noleemits Vision Builder Control (nvbc/v1 REST endpoints)
+ *
+ * Version: 4.4.0
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+    ErrorCode,
+    McpError,
+} from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+// ================================================================
+// CLI ARGS
+// ================================================================
+
+const cliArgs = process.argv.slice(2);
+const httpMode = cliArgs.includes('--http');
+const portArg = cliArgs.find(a => a.startsWith('--port='));
+const PORT = portArg ? parseInt(portArg.split('=')[1]) : 3100;
+const HEARTBEAT_MS = 25000;
+const FETCH_TIMEOUT_MS = 120000;
+const TOKEN_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+
+// ================================================================
+// GLOBAL ERROR HANDLERS & LIFECYCLE LOGGING
+// ================================================================
+
+process.on('uncaughtException', (err) => {
+    console.error('[FATAL] Uncaught exception (kept alive):', err.message);
+    console.error(err.stack);
+});
+
+process.on('unhandledRejection', (reason) => {
+    console.error('[WARN] Unhandled rejection (kept alive):', reason);
+});
+
+process.on('exit', (code) => {
+    console.error(`[LIFECYCLE] Process exiting with code ${code}`);
+});
+
+process.on('beforeExit', (code) => {
+    console.error(`[LIFECYCLE] beforeExit fired (code ${code}) — event loop empty, keeping alive`);
+    // Prevent exit by scheduling work if event loop is empty
+    if (!global._mcpKeepAlive) {
+        global._mcpKeepAlive = setInterval(() => {}, 30000);
+    }
+});
+
+process.on('SIGTERM', () => {
+    console.error('[LIFECYCLE] SIGTERM received');
+});
+
+process.on('SIGINT', () => {
+    console.error('[LIFECYCLE] SIGINT received');
+});
+
+// ================================================================
+// CONFIG
+// ================================================================
+
+const VERSION = '4.5.5';
+
+// ================================================================
+// PARAMETER HELPERS
+// ================================================================
+
+/**
+ * Parse a boolean parameter that may arrive as a string from MCP protocol.
+ * @param {*} value - The parameter value
+ * @param {boolean} defaultValue - Default if undefined/null
+ * @returns {boolean}
+ */
+function parseBool(value, defaultValue = false) {
+    if (value === undefined || value === null) return defaultValue;
+    if (typeof value === 'boolean') return value;
+    if (typeof value === 'string') return value.toLowerCase() === 'true';
+    return Boolean(value);
+}
+
+/**
+ * Strip CDATA wrappers that MCP XML transport may inject into string values.
+ * Handles: <![CDATA[content]]> → content
+ */
+function stripCDATA(str) {
+    if (typeof str !== 'string') return str;
+    // Full CDATA wrapper
+    str = str.replace(/<!\[CDATA\[/g, '').replace(/\]\]>/g, '');
+    return str;
+}
+
+/**
+ * Recursively strip CDATA from all string values in an object/array.
+ */
+function deepStripCDATA(obj) {
+    if (typeof obj === 'string') return stripCDATA(obj);
+    if (Array.isArray(obj)) return obj.map(deepStripCDATA);
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+            result[k] = deepStripCDATA(v);
+        }
+        return result;
+    }
+    return obj;
+}
+
+const CONFIG = {
+    wordpressUrl: process.env.WP_URL || 'http://localhost',
+    username: process.env.WP_USER || '',
+    applicationPassword: process.env.WP_APP_PASSWORD || '',
+};
+
+// ================================================================
+// TEMPLATE LIBRARY
+// ================================================================
+
+const __filename_tl = fileURLToPath(import.meta.url);
+const __dirname_tl = dirname(__filename_tl);
+
+const TEMPLATE_LIBRARY_DIR = process.env.TEMPLATE_LIBRARY_DIR || '';
+let _templateCatalog = 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'));
+        return _templateCatalog;
+    } catch (e) {
+        console.error(`[TEMPLATE] Failed to load catalog: ${e.message}`);
+        return null;
+    }
+}
+
+function loadTemplateSection(kitId, pageSlug, sectionIndex) {
+    const templatePath = join(TEMPLATE_LIBRARY_DIR, 'templates', kitId, 'templates', `${pageSlug}.json`);
+    if (!existsSync(templatePath)) return null;
+    try {
+        const data = JSON.parse(readFileSync(templatePath, 'utf8'));
+        const content = data.content || [];
+        if (sectionIndex < 0 || sectionIndex >= content.length) return null;
+        return content[sectionIndex];
+    } catch (e) {
+        console.error(`[TEMPLATE] Failed to load section: ${e.message}`);
+        return null;
+    }
+}
+
+// ── Content Analysis & Section Mapping ──
+
+const CONTENT_BLOCK_PATTERNS = {
+    hero: {
+        description: 'Hero section with main headline and intro',
+        detect: (block) => {
+            if (block.index !== 0) return 0;
+            let score = 0.5; // first block bonus
+            if (block.title) score += 0.3; // has a # title within the block
+            if (block.has_cta) score += 0.2;
+            if (block.paragraphs <= 2) score += 0.1;
+            const text = (block.heading + ' ' + (block.title || '')).toLowerCase();
+            if (text.includes('hero') || text.includes('welcome') || text.includes('home')) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'stats-bar': {
+        description: 'Key metrics or numbers',
+        detect: (block) => {
+            let score = 0;
+            if (block.stat_count >= 3) score += 0.6;
+            else if (block.stat_count >= 2) score += 0.4;
+            if (block.paragraphs === 0 && !block.has_numbered_items) score += 0.2;
+            if (block.has_numbered_items) score -= 0.3; // numbered items are steps, not stats
+            if (block.items.length <= 6) score += 0.1;
+            return Math.max(0, Math.min(score, 1));
+        }
+    },
+    'features-grid': {
+        description: 'Feature or benefit cards',
+        detect: (block) => {
+            let score = 0;
+            if (block.item_count >= 3 && block.item_count <= 8) score += 0.5;
+            if (block.items_have_descriptions) score += 0.3;
+            if (block.heading_level >= 3) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'services-grid': {
+        description: 'Service offerings with descriptions',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('service') || text.includes('offer') || text.includes('solution')) score += 0.3;
+            if (block.item_count >= 3 && block.items_have_descriptions) score += 0.4;
+            if (block.has_cta) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'about-content': {
+        description: 'About section with text and image placeholder',
+        detect: (block) => {
+            let score = 0;
+            if (block.paragraphs >= 2) score += 0.3;
+            if (block.heading_level === 2) score += 0.1;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('about') || text.includes('mission') || text.includes('story') || text.includes('who we')) score += 0.3;
+            if (block.has_image_hint) score += 0.2;
+            return Math.min(score, 1);
+        }
+    },
+    testimonials: {
+        description: 'Customer testimonials or reviews',
+        detect: (block) => {
+            let score = 0;
+            if (block.has_quotes) score += 0.6;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('testimonial') || text.includes('review') || text.includes('client') ||
+                text.includes('patient') || text.includes('say') || text.includes('said')) score += 0.3;
+            if (block.item_count >= 2) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'team-grid': {
+        description: 'Team member profiles',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('team') || text.includes('staff') || text.includes('doctor') || text.includes('physician') || text.includes('surgeon')) score += 0.4;
+            if (block.has_people_names && !block.has_quotes) score += 0.4;
+            if (block.item_count >= 2) score += 0.2;
+            // Penalize when content is clearly Q/A (false positive from name pattern)
+            if (block.qa_count >= 2) score -= 0.5;
+            return Math.max(0, Math.min(score, 1));
+        }
+    },
+    'pricing-table': {
+        description: 'Pricing plans or packages',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('$') || text.includes('price') || text.includes('/mo') || text.includes('plan')) score += 0.5;
+            if (block.item_count >= 2 && block.item_count <= 4) score += 0.3;
+            if (block.has_cta) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    faq: {
+        description: 'Frequently asked questions',
+        detect: (block) => {
+            let score = 0;
+            if (block.question_count >= 2) score += 0.6;
+            if (block.qa_count >= 2) score += 0.7; // Q: ... A: ... bullet pattern
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('faq') || text.includes('frequently') || text.includes('question')) score += 0.4;
+            // Detect Q&A pattern: short lines alternating with longer explanations
+            const lines = block.lines.filter(l => l.trim().length > 0);
+            const shortLong = lines.filter((l, i) => i < lines.length - 1 && l.trim().length < 80 && lines[i+1].trim().length > 40);
+            if (shortLong.length >= 2) score += 0.3;
+            return Math.min(score, 1);
+        }
+    },
+    'contact-form': {
+        description: 'Contact form or contact info',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            const heading = (block.heading + ' ' + (block.title || '')).toLowerCase();
+            if (heading.includes('contact') || heading.includes('get in touch') || heading.includes('reach us')) score += 0.5;
+            else if (text.includes('contact') || text.includes('get in touch') || text.includes('reach us')) score += 0.3;
+            if (text.includes('email') || text.includes('phone') || text.includes('address')) score += 0.4;
+            if (block.has_cta) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'process-steps': {
+        description: 'Numbered steps or process flow',
+        detect: (block) => {
+            let score = 0;
+            if (block.has_numbered_items) score += 0.6;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('step') || text.includes('process') || text.includes('how it works') || text.includes('how to')) score += 0.3;
+            if (block.item_count >= 3 && block.item_count <= 6) score += 0.2;
+            return Math.min(score, 1);
+        }
+    },
+    cta: {
+        description: 'Call-to-action section',
+        detect: (block) => {
+            let score = 0;
+            if (block.has_cta) score += 0.3;
+            if (block.paragraphs <= 2 && block.items.length <= 3) score += 0.2;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('get started') || text.includes('sign up') || text.includes('schedule') ||
+                text.includes('book') || text.includes('free') || text.includes('contact us') ||
+                text.includes('call now') || text.includes('start your')) score += 0.4;
+            if (block.index === block.total_blocks - 1) score += 0.2;
+            return Math.min(score, 1);
+        }
+    },
+    'text-content': {
+        description: 'Rich text content block',
+        detect: (block) => {
+            let score = 0;
+            if (block.paragraphs >= 3) score += 0.4;
+            if (block.item_count === 0) score += 0.2;
+            if (!block.has_cta && !block.has_quotes) score += 0.1;
+            return Math.min(score, 1);
+        }
+    },
+    'logo-strip': {
+        description: 'Partner or client logos',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('partner') || text.includes('client') || text.includes('trusted by') ||
+                text.includes('featured in') || text.includes('as seen')) score += 0.6;
+            if (block.paragraphs === 0 && block.item_count === 0) score += 0.2;
+            return Math.min(score, 1);
+        }
+    },
+    gallery: {
+        description: 'Image gallery or portfolio',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('gallery') || text.includes('portfolio') || text.includes('project') || text.includes('work')) score += 0.4;
+            if (block.image_count >= 3) score += 0.4;
+            return Math.min(score, 1);
+        }
+    },
+    'comparison-table': {
+        description: 'Feature comparison or vs table',
+        detect: (block) => {
+            let score = 0;
+            const text = block.raw_text.toLowerCase();
+            if (text.includes('vs') || text.includes('compare') || text.includes('comparison') || text.includes('versus')) score += 0.5;
+            if (block.has_table) score += 0.4;
+            return Math.min(score, 1);
+        }
+    },
+};
+
+function parseContentBlocks(markdown) {
+    const lines = markdown.split('\n');
+    const blocks = [];
+    let currentBlock = null;
+
+    function finalizeBlock() {
+        if (!currentBlock) return;
+        // Analyze the accumulated block
+        const text = currentBlock.lines.join('\n');
+        const raw = text.toLowerCase();
+
+        // Count stats (numbers with labels like "99% something" or "2,732+ procedures")
+        // Matches: 99%, 500+, $50M+, 2,732+, 25+ Years, 0.01% — handles bullet prefix
+        const statPattern = /(?:^|\n)\s*(?:[-*•]\s+)?(?:\$?[\d,]+[%+]|[\d,.]+[kKmM]\+?|\$[\d,.]+[kKmM]?\+?)\s+\w/gm;
+        const stats = text.match(statPattern) || [];
+
+        // Count questions
+        const questions = currentBlock.lines.filter(l => l.trim().endsWith('?'));
+
+        // Count Q/A patterns in bullets (e.g. "- Q: ... A: ...")
+        const qaItems = currentBlock.lines.filter(l => /^\s*[-*•]\s+Q:\s*.+\s*A:\s*.+/i.test(l));
+
+        // Count list items
+        const listItems = currentBlock.lines.filter(l => /^\s*[-*•]\s/.test(l) || /^\s*\d+[.)]\s/.test(l));
+        const numberedItems = currentBlock.lines.filter(l => /^\s*\d+[.)]\s/.test(l));
+
+        // Count sub-headings (items with titles)
+        const subHeadings = currentBlock.lines.filter(l => /^#{3,6}\s/.test(l));
+
+        // Detect items with descriptions (sub-heading followed by text, OR colon-separated bullet items)
+        const colonItems = currentBlock.lines.filter(l => /^\s*[-*•]\s+[^:]+:\s+.{10,}/.test(l));
+        const itemsWithDesc = (subHeadings.length > 0 && currentBlock.lines.some(l => !l.startsWith('#') && l.trim().length > 30))
+            || colonItems.length >= 2;
+
+        // Count paragraphs (non-empty, non-heading, non-list lines)
+        const paragraphs = currentBlock.lines.filter(l =>
+            l.trim().length > 0 && !l.startsWith('#') && !/^\s*[-*•]\s/.test(l) && !/^\s*\d+[.)]\s/.test(l)
+        );
+
+        // Detect image hints
+        const imageHints = text.match(/!\[.*?\]|image:|photo:|picture:|illustration:|icon:/gi) || [];
+
+        // Detect quotes
+        const quotes = currentBlock.lines.filter(l => l.trim().startsWith('>') || l.trim().startsWith('"'));
+
+        // Detect CTA-like phrases
+        const ctaPhrases = raw.match(/get started|sign up|schedule|book now|learn more|contact us|call now|free.*review|start your|download|subscribe/g) || [];
+
+        // Detect people names (capitalized two-word patterns)
+        const namePattern = /(?:Dr\.|Mr\.|Mrs\.|Ms\.)?\s?[A-Z][a-z]+ [A-Z][a-z]+/g;
+        const names = text.match(namePattern) || [];
+
+        // Detect table
+        const hasTable = currentBlock.lines.some(l => l.includes('|') && l.trim().startsWith('|'));
+
+        // Count images
+        const images = text.match(/!\[.*?\]\(.*?\)/g) || [];
+
+        blocks.push({
+            index: blocks.length,
+            total_blocks: 0, // filled later
+            heading: currentBlock.heading,
+            title: currentBlock.title || currentBlock.heading,
+            heading_level: currentBlock.heading_level,
+            lines: currentBlock.lines,
+            raw_text: text,
+            items: listItems,
+            item_count: Math.max(listItems.length, subHeadings.length),
+            items_have_descriptions: itemsWithDesc,
+            stat_count: stats.length,
+            question_count: questions.length,
+            qa_count: qaItems.length,
+            paragraphs: paragraphs.length,
+            has_cta: ctaPhrases.length > 0,
+            has_quotes: quotes.length > 0,
+            has_image_hint: imageHints.length > 0,
+            has_people_names: names.length >= 2,
+            has_numbered_items: numberedItems.length >= 2,
+            has_table: hasTable,
+            image_count: images.length,
+        });
+
+        currentBlock = null;
+    }
+
+    for (const line of lines) {
+        const sectionMatch = line.match(/^##\s+(.+)/);
+        if (sectionMatch) {
+            // ## creates a new content block (section divider)
+            finalizeBlock();
+            currentBlock = {
+                heading: sectionMatch[1].trim(),
+                heading_level: 2,
+                lines: []
+            };
+        } else {
+            if (!currentBlock) {
+                currentBlock = { heading: '', heading_level: 0, lines: [] };
+            }
+            // # within a block becomes the block's title (not a new block)
+            const titleMatch = line.match(/^#\s+(.+)/);
+            if (titleMatch && currentBlock.lines.length === 0 && !currentBlock.title) {
+                currentBlock.title = titleMatch[1].trim();
+            }
+            currentBlock.lines.push(line);
+        }
+    }
+    finalizeBlock();
+
+    // Fill total_blocks
+    blocks.forEach(b => b.total_blocks = blocks.length);
+
+    return blocks;
+}
+
+function mapContentToSections(blocks, catalog, kitId) {
+    const results = [];
+
+    for (const block of blocks) {
+        // Score against all content block patterns
+        const scores = {};
+        for (const [type, pattern] of Object.entries(CONTENT_BLOCK_PATTERNS)) {
+            const score = pattern.detect(block);
+            if (score > 0.2) scores[type] = score;
+        }
+
+        const sorted = Object.entries(scores).sort((a, b) => b[1] - a[1]);
+        const bestType = sorted[0]?.[0] || 'text-content';
+        const bestScore = sorted[0]?.[1] || 0;
+
+        // Debug: log block scores
+        console.error(`[MAPPER] Block ${block.index} "${block.heading}" → items:${block.item_count} stats:${block.stat_count} qa:${block.qa_count || 0} q:${block.question_count} names:${block.has_people_names} desc:${block.items_have_descriptions}`);
+        console.error(`[MAPPER]   Scores: ${sorted.map(([t,s]) => `${t}:${s.toFixed(2)}`).join(', ')}`);
+
+        // Find matching sections from catalog
+        let candidates = catalog.sections.filter(s => s.type === bestType);
+        if (kitId) candidates = candidates.filter(s => s.kit_id === kitId);
+
+        // If no candidates for this type in kit, try all kits
+        if (candidates.length === 0 && kitId) {
+            candidates = catalog.sections.filter(s => s.type === bestType);
+        }
+
+        // Rank candidates by confidence and element count appropriateness
+        candidates.sort((a, b) => {
+            // Prefer high confidence
+            let diff = b.confidence - a.confidence;
+            // Break ties by column count match
+            if (Math.abs(diff) < 0.1 && block.item_count > 0) {
+                const aColDiff = Math.abs(a.features.column_count - block.item_count);
+                const bColDiff = Math.abs(b.features.column_count - block.item_count);
+                diff = aColDiff - bColDiff; // prefer closer column match
+            }
+            return diff;
+        });
+
+        results.push({
+            block_index: block.index,
+            heading: block.heading,
+            detected_type: bestType,
+            confidence: Math.round(bestScore * 100) / 100,
+            alternatives: sorted.slice(1, 3).map(([t, s]) => ({ type: t, score: Math.round(s * 100) / 100 })),
+            recommended_sections: candidates.slice(0, 3).map(s => ({
+                id: s.id,
+                kit: s.kit_title,
+                page: s.page_name,
+                section_index: s.section_index,
+                confidence: s.confidence,
+                columns: s.features.column_count,
+                elements: s.features.total_elements,
+                preview: s.features.text_preview[0] || ''
+            })),
+            content_summary: {
+                items: block.item_count,
+                paragraphs: block.paragraphs,
+                stats: block.stat_count,
+                questions: block.question_count,
+                has_cta: block.has_cta,
+            }
+        });
+    }
+
+    return results;
+}
+
+function loadDesignTokens(kitId) {
+    const globalPath = join(TEMPLATE_LIBRARY_DIR, 'templates', kitId, 'templates', 'global.json');
+    if (!existsSync(globalPath)) return null;
+    try {
+        const data = JSON.parse(readFileSync(globalPath, 'utf8'));
+        return data.page_settings || null;
+    } catch (e) {
+        return null;
+    }
+}
+
+// ── Token Swapper (Rebranding) ──
+
+/**
+ * Build a globals resolver from kit tokens.
+ * Returns { colorMap: { id → hex }, typoMap: { id → { family, weight, size } } }
+ */
+function buildGlobalsResolver(sourceTokens) {
+    const colorMap = {};
+    const typoMap = {};
+    if (!sourceTokens) return { colorMap, typoMap };
+
+    for (const c of sourceTokens.system_colors || []) {
+        if (c._id && c.color) colorMap[c._id] = normalizeHex(c.color) || c.color;
+    }
+    for (const c of sourceTokens.custom_colors || []) {
+        if (c._id && c.color) colorMap[c._id] = normalizeHex(c.color) || c.color;
+    }
+    for (const t of sourceTokens.system_typography || []) {
+        if (t._id && t.typography_typography === 'custom') {
+            typoMap[t._id] = {
+                family: t.typography_font_family || '',
+                weight: t.typography_font_weight || '',
+                size: t.typography_font_size || null,
+            };
+        }
+    }
+    for (const t of sourceTokens.custom_typography || []) {
+        if (t._id && t.typography_typography === 'custom') {
+            typoMap[t._id] = {
+                family: t.typography_font_family || '',
+                weight: t.typography_font_weight || '',
+                size: t.typography_font_size || null,
+            };
+        }
+    }
+    return { colorMap, typoMap };
+}
+
+/**
+ * Normalize a hex color to uppercase 6-digit form for consistent matching.
+ * Handles #RGB, #RRGGBB, #RRGGBBAA formats. Returns null for non-hex.
+ */
+function normalizeHex(color) {
+    if (!color || typeof color !== 'string') return null;
+    const m = color.match(/^#([0-9A-Fa-f]{3,8})$/);
+    if (!m) return null;
+    const hex = m[1].toUpperCase();
+    if (hex.length === 3) return '#' + hex[0]+hex[0] + hex[1]+hex[1] + hex[2]+hex[2];
+    if (hex.length === 4) return '#' + hex[0]+hex[0] + hex[1]+hex[1] + hex[2]+hex[2] + hex[3]+hex[3];
+    if (hex.length === 6 || hex.length === 8) return '#' + hex;
+    return null;
+}
+
+/**
+ * Build color replacement map from source kit tokens → target brand tokens.
+ * colorOverrides: { source_hex: target_hex } or { system_color_id: target_hex }
+ * sourceTokens: the source kit's page_settings (from loadDesignTokens)
+ */
+function buildColorMap(sourceTokens, colorOverrides) {
+    const map = {}; // normalized source hex → target hex
+
+    if (!colorOverrides || !sourceTokens) return map;
+
+    // Map system color IDs to their hex values
+    const systemColorMap = {};
+    for (const c of sourceTokens.system_colors || []) {
+        systemColorMap[c._id] = normalizeHex(c.color);
+    }
+    // Also map custom colors
+    for (const c of sourceTokens.custom_colors || []) {
+        systemColorMap[c._id] = normalizeHex(c.color);
+    }
+
+    for (const [src, tgt] of Object.entries(colorOverrides)) {
+        const targetNorm = normalizeHex(tgt);
+        if (!targetNorm) continue;
+
+        // If src is a system color ID, resolve to hex
+        if (systemColorMap[src]) {
+            map[systemColorMap[src]] = targetNorm;
+        } else {
+            const srcNorm = normalizeHex(src);
+            if (srcNorm) map[srcNorm] = targetNorm;
+        }
+    }
+    return map;
+}
+
+/**
+ * Replace hex colors in a string value using the color map.
+ * Handles both #RRGGBB and #RRGGBBAA (preserving alpha).
+ */
+function replaceColorsInString(str, colorMap) {
+    if (!str || typeof str !== 'string') return str;
+    return str.replace(/#[0-9A-Fa-f]{3,8}\b/g, (match) => {
+        const norm = normalizeHex(match);
+        if (!norm) return match;
+        // For 8-digit hex (with alpha), check if the base 6-digit color matches
+        const base6 = norm.substring(0, 7);
+        const alpha = norm.length > 7 ? norm.substring(7) : '';
+        if (colorMap[base6]) {
+            return colorMap[base6] + alpha;
+        }
+        if (colorMap[norm]) {
+            return colorMap[norm];
+        }
+        return match;
+    });
+}
+
+/**
+ * Recursively rebrand an Elementor element tree.
+ * - Replaces hardcoded hex colors in string settings
+ * - Replaces hex colors inside object settings (e.g., box_shadow.color)
+ * - Updates __globals__ color references if globalsMap is provided
+ * - Replaces font families
+ */
+// Unsplash placeholder images by context keyword
+const UNSPLASH_PLACEHOLDERS = [
+    'https://images.unsplash.com/photo-1497366216548-37526070297c?w=1200&h=800&fit=crop', // office
+    'https://images.unsplash.com/photo-1497215842964-222b430dc094?w=1200&h=800&fit=crop', // workspace
+    'https://images.unsplash.com/photo-1521737604893-d14cc237f11d?w=1200&h=800&fit=crop', // team
+    'https://images.unsplash.com/photo-1560472354-b33ff0c44a43?w=1200&h=800&fit=crop', // business
+    'https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?w=600&h=600&fit=crop',  // portrait
+    'https://images.unsplash.com/photo-1573497019940-1c28c88b4f3e?w=600&h=600&fit=crop',  // professional
+];
+let _unsplashIdx = 0;
+
+/**
+ * Replace external kit image URLs with Unsplash placeholders.
+ * Only replaces URLs from known kit domains (newkit.creativemox.com, etc.)
+ */
+function replaceExternalImages(settings) {
+    if (!settings || typeof settings !== 'object') return;
+
+    for (const [key, value] of Object.entries(settings)) {
+        // Image object: { url: "http://...", id: 123, ... }
+        if (value && typeof value === 'object' && !Array.isArray(value) && 'url' in value && typeof value.url === 'string') {
+            if (value.url && (value.url.includes('newkit.creativemox.com') || value.url.includes('creativemox.com'))) {
+                value.url = UNSPLASH_PLACEHOLDERS[_unsplashIdx % UNSPLASH_PLACEHOLDERS.length];
+                value.id = '';
+                _unsplashIdx++;
+            }
+        }
+        // Slideshow gallery array
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item && typeof item === 'object') {
+                    if ('url' in item && typeof item.url === 'string' &&
+                        (item.url.includes('newkit.creativemox.com') || item.url.includes('creativemox.com'))) {
+                        item.url = UNSPLASH_PLACEHOLDERS[_unsplashIdx % UNSPLASH_PLACEHOLDERS.length];
+                        item.id = '';
+                        _unsplashIdx++;
+                    }
+                    replaceExternalImages(item);
+                }
+            }
+        }
+        // Recurse into sub-objects (but skip arrays already handled)
+        if (value && typeof value === 'object' && !Array.isArray(value) && !('url' in value)) {
+            replaceExternalImages(value);
+        }
+    }
+}
+
+// Replace all fa-circle placeholder icons with contextual FA icons
+const REPLACEMENT_ICONS = [
+    'fas fa-check-circle', 'fas fa-star', 'fas fa-shield-alt', 'fas fa-award',
+    'fas fa-bolt', 'fas fa-heart', 'fas fa-cog', 'fas fa-gem',
+    'fas fa-rocket', 'fas fa-thumbs-up', 'fas fa-lightbulb', 'fas fa-bullseye',
+    'fas fa-chart-line', 'fas fa-users', 'fas fa-clock', 'fas fa-medal',
+];
+let _iconReplacementCounter = 0;
+
+function replaceCircleIcons(settings) {
+    if (!settings || typeof settings !== 'object') return;
+    for (const key of Object.keys(settings)) {
+        const val = settings[key];
+        if (val && typeof val === 'object' && !Array.isArray(val)) {
+            if (val.value === 'fas fa-circle' && val.library === 'fa-solid') {
+                val.value = REPLACEMENT_ICONS[_iconReplacementCounter % REPLACEMENT_ICONS.length];
+                _iconReplacementCounter++;
+            }
+        }
+        // Also check icon arrays (e.g. icon-list items)
+        if (Array.isArray(val)) {
+            for (const item of val) {
+                if (item && typeof item === 'object') {
+                    replaceCircleIcons(item);
+                }
+            }
+        }
+    }
+}
+
+function rebrandElement(element, colorMap, fontMap, globalsMap, globalsResolver) {
+    if (!element || typeof element !== 'object') return element;
+
+    // Deep clone to avoid mutating original
+    const el = JSON.parse(JSON.stringify(element));
+
+    if (el.settings && typeof el.settings === 'object') {
+        rebrandSettings(el.settings, colorMap, fontMap, globalsMap, globalsResolver);
+        // Replace external kit images with Unsplash placeholders
+        replaceExternalImages(el.settings);
+        // Replace fa-circle placeholder icons with contextual alternatives
+        replaceCircleIcons(el.settings);
+    }
+
+    if (Array.isArray(el.elements)) {
+        el.elements = el.elements.map(child => rebrandElement(child, colorMap, fontMap, globalsMap, globalsResolver));
+    }
+
+    return el;
+}
+
+function rebrandSettings(settings, colorMap, fontMap, globalsMap, globalsResolver) {
+    // Handle __globals__ references — resolve to hardcoded values
+    if (settings.__globals__) {
+        const resolver = globalsResolver || {};
+        const resolvedColors = resolver.colorMap || {};
+        const resolvedTypo = resolver.typoMap || {};
+        const keysToDelete = [];
+
+        for (const [key, ref] of Object.entries(settings.__globals__)) {
+            if (typeof ref !== 'string') continue;
+
+            // Try explicit globalsMap first (user-provided ref-to-ref mapping)
+            if (globalsMap && globalsMap[ref]) {
+                settings.__globals__[key] = globalsMap[ref];
+                continue;
+            }
+
+            // Resolve color globals → hardcoded hex
+            const colorMatch = ref.match(/^globals\/colors\?id=(.+)$/);
+            if (colorMatch) {
+                const colorId = colorMatch[1];
+                const sourceHex = resolvedColors[colorId];
+                if (sourceHex) {
+                    // Apply color mapping if available, otherwise use source hex
+                    const targetHex = colorMap[sourceHex] || sourceHex;
+                    // Set the hardcoded value directly in settings
+                    // Map __globals__ key to the corresponding settings key
+                    // e.g., __globals__.title_color → settings.title_color
+                    settings[key] = targetHex;
+                    keysToDelete.push(key);
+                }
+                continue;
+            }
+
+            // Resolve typography globals → hardcoded font properties
+            const typoMatch = ref.match(/^globals\/typography\?id=(.+)$/);
+            if (typoMatch) {
+                const typoId = typoMatch[1];
+                const sourceTypo = resolvedTypo[typoId];
+                if (sourceTypo) {
+                    // For typography globals, the key pattern is like "typography_typography"
+                    // We need to set the individual typography sub-properties
+                    // The key in __globals__ is usually "<prefix>_typography" (e.g., "typography_typography", "title_typography_typography")
+                    const prefix = key.replace(/_typography$/, '');
+                    settings[key] = 'custom';
+                    if (sourceTypo.family) {
+                        const targetFont = (fontMap && fontMap[sourceTypo.family]) || sourceTypo.family;
+                        settings[prefix + '_font_family'] = targetFont;
+                    }
+                    if (sourceTypo.weight) {
+                        settings[prefix + '_font_weight'] = sourceTypo.weight;
+                    }
+                    if (sourceTypo.size) {
+                        settings[prefix + '_font_size'] = sourceTypo.size;
+                    }
+                    keysToDelete.push(key);
+                }
+                continue;
+            }
+        }
+
+        // Remove resolved __globals__ entries
+        for (const k of keysToDelete) {
+            delete settings.__globals__[k];
+        }
+        // If __globals__ is now empty, remove it entirely
+        if (Object.keys(settings.__globals__).length === 0) {
+            delete settings.__globals__;
+        }
+    }
+
+    for (const [key, value] of Object.entries(settings)) {
+        if (key === '__globals__') continue;
+
+        // String values: replace colors and fonts
+        if (typeof value === 'string') {
+            // Color replacement
+            settings[key] = replaceColorsInString(value, colorMap);
+            // Font replacement
+            if (fontMap && key.includes('font_family') && fontMap[value]) {
+                settings[key] = fontMap[value];
+            }
+            continue;
+        }
+
+        // Object values: recurse into sub-objects (box_shadow, border, etc.)
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            for (const [subKey, subVal] of Object.entries(value)) {
+                if (typeof subVal === 'string') {
+                    value[subKey] = replaceColorsInString(subVal, colorMap);
+                    if (fontMap && subKey.includes('font_family') && fontMap[subVal]) {
+                        value[subKey] = fontMap[subVal];
+                    }
+                }
+            }
+            continue;
+        }
+
+        // Array values: recurse into each item (e.g., repeater fields)
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item && typeof item === 'object') {
+                    rebrandSettings(item, colorMap, fontMap, globalsMap, globalsResolver);
+                }
+            }
+        }
+    }
+}
+
+/**
+ * Rebrand a full section JSON with color, font, and globals replacements.
+ * Returns the rebranded section (deep cloned).
+ */
+function rebrandSection(section, colorMap, fontMap, globalsMap, globalsResolver) {
+    return rebrandElement(section, colorMap, fontMap, globalsMap || {}, globalsResolver || null);
+}
+
+// ── Content Injection ──
+
+/**
+ * Extract an ordered list of content-bearing widgets from a section tree.
+ * Each entry: { widget, path, type, role }
+ */
+function extractContentSlots(element, path = []) {
+    const slots = [];
+    if (!element) return slots;
+
+    if (element.widgetType) {
+        const wt = element.widgetType;
+        const s = element.settings || {};
+
+        if (wt === 'heading') {
+            slots.push({ widget: element, path: [...path], type: 'heading', text: s.title || '' });
+        } else if (wt === 'text-editor') {
+            slots.push({ widget: element, path: [...path], type: 'text', text: s.editor || '' });
+        } else if (wt === 'button') {
+            slots.push({ widget: element, path: [...path], type: 'button', text: s.text || '', url: s.link?.url || '' });
+        } else if (wt === 'icon-box') {
+            slots.push({ widget: element, path: [...path], type: 'icon-box', title: s.title_text || '', description: s.description_text || '' });
+        } else if (wt === 'counter') {
+            slots.push({ widget: element, path: [...path], type: 'counter', value: s.ending_number || '', suffix: s.suffix || '', prefix: s.prefix || '' });
+        } else if (wt === 'testimonial') {
+            slots.push({ widget: element, path: [...path], type: 'testimonial', text: s.testimonial_content || '', name: s.testimonial_name || '', job: s.testimonial_job || '' });
+        } else if (wt === 'toggle' || wt === 'nested-accordion') {
+            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') {
+            slots.push({ widget: element, path: [...path], type: 'icon', icon: s.selected_icon || {} });
+        }
+    }
+
+    if (Array.isArray(element.elements)) {
+        element.elements.forEach((child, i) => {
+            slots.push(...extractContentSlots(child, [...path, i]));
+        });
+    }
+
+    return slots;
+}
+
+/**
+ * Convert a markdown content block to structured content for injection.
+ * content: { heading, subheading, paragraphs[], items[], stats[], buttons[], quotes[], faq[] }
+ */
+function structureContentBlock(block) {
+    const result = {
+        heading: block.title || block.heading || '',
+        subheading: block.title ? block.heading : '',
+        paragraphs: [],
+        items: [],
+        stats: [],
+        buttons: [],
+        quotes: [],
+        faq: [],
+    };
+
+    const lines = block.lines || [];
+
+    // Extract subheadings (### level) as items
+    let currentItem = null;
+    for (const line of lines) {
+        // Skip # title line (already captured as heading)
+        if (/^#\s+/.test(line)) continue;
+
+        const h3 = line.match(/^###\s+(.+)/);
+        if (h3) {
+            if (currentItem) result.items.push(currentItem);
+            currentItem = { title: h3[1].trim(), description: '' };
+            continue;
+        }
+        if (currentItem) {
+            if (line.trim()) {
+                currentItem.description += (currentItem.description ? ' ' : '') + line.trim();
+            }
+            continue;
+        }
+
+        // Numbered items (process steps, FAQ)
+        const numbered = line.match(/^\s*\d+[.)]\s+(.+)/);
+        if (numbered) {
+            result.items.push({ title: numbered[1].trim(), description: '' });
+            continue;
+        }
+
+        // Bullet items
+        const bullet = line.match(/^\s*[-*•]\s+(.+)/);
+        if (bullet) {
+            const content = bullet[1].trim();
+            // Check for markdown link: [text](url)
+            const linkMatch = content.match(/^\[([^\]]+)\]\(([^)]+)\)$/);
+            if (linkMatch) {
+                result.buttons.push({ text: linkMatch[1], url: linkMatch[2] });
+                continue;
+            }
+            // Check for FAQ pattern "Q: question A: answer" (MUST be before colon check)
+            const qaMatch = content.match(/^Q:\s*(.+?)\s*A:\s*(.+)$/i);
+            if (qaMatch) {
+                result.faq.push({ question: qaMatch[1].trim(), answer: qaMatch[2].trim() });
+                continue;
+            }
+            // Check for "Title: Description" pattern
+            const colonMatch = content.match(/^([^:]+):\s+(.+)/);
+            if (colonMatch) {
+                result.items.push({ title: colonMatch[1].trim(), description: colonMatch[2].trim() });
+                continue;
+            }
+            // Check for stat pattern "2500+ Cases Won"
+            const statMatch = content.match(/^(\$?[\d,]+[%+kKmM]*\+?)\s+(.+)/);
+            if (statMatch) {
+                result.stats.push({ value: statMatch[1], label: statMatch[2].trim() });
+                continue;
+            }
+            result.items.push({ title: content, description: '' });
+            continue;
+        }
+
+        // Quotes
+        if (line.trim().startsWith('>') || line.trim().startsWith('"')) {
+            const quoteText = line.trim().replace(/^>\s*/, '').replace(/^"/, '').replace(/"$/, '');
+            const authorMatch = quoteText.match(/[–—-]\s*(.+)$/);
+            if (authorMatch) {
+                result.quotes.push({ text: quoteText.replace(/\s*[–—-]\s*.+$/, ''), author: authorMatch[1].trim() });
+            } else {
+                result.quotes.push({ text: quoteText, author: '' });
+            }
+            continue;
+        }
+
+        // Stats (numbers with labels)
+        const stat = line.match(/^\s*(?:\$?[\d,]+[%+]|[\d,.]+[kKmM]\+?|\$[\d,.]+[kKmM]?\+?)\s+(.+)/);
+        if (stat) {
+            const valMatch = line.match(/^\s*((?:\$?[\d,]+[%+]|[\d,.]+[kKmM]\+?|\$[\d,.]+[kKmM]?\+?))/);
+            result.stats.push({ value: valMatch ? valMatch[1] : '', label: stat[1].trim() });
+            continue;
+        }
+
+        // FAQ pattern: short line followed by longer line
+        if (line.trim().endsWith('?')) {
+            result.faq.push({ question: line.trim(), answer: '' });
+            continue;
+        }
+        // If previous was a question, this is the answer
+        if (result.faq.length > 0 && !result.faq[result.faq.length - 1].answer && line.trim()) {
+            result.faq[result.faq.length - 1].answer = line.trim();
+            continue;
+        }
+
+        // Regular paragraphs
+        if (line.trim()) {
+            result.paragraphs.push(line.trim());
+        }
+    }
+    if (currentItem) result.items.push(currentItem);
+
+    // Extract CTA phrases as buttons (only if no explicit link buttons and no FAQ content)
+    if (result.buttons.length === 0 && result.faq.length === 0) {
+        const ctaPatterns = [
+            /(?:get started|sign up|schedule|book now|learn more|contact us|call now|free.*review|start your|discover more)[^.\n]*/gi
+        ];
+        for (const p of ctaPatterns) {
+            const matches = lines.join('\n').match(p) || [];
+            for (const m of matches) {
+                result.buttons.push({ text: m.trim(), url: '#' });
+            }
+        }
+        // If no explicit CTA found but block has_cta flag, use heading as button
+        if (result.buttons.length === 0 && block.has_cta && result.heading) {
+            result.buttons.push({ text: 'Get Started', url: '#' });
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Inject structured content into a section's widgets.
+ * Deep clones the section first to avoid mutation.
+ */
+function injectContent(section, content) {
+    const injected = JSON.parse(JSON.stringify(section));
+    const slots = extractContentSlots(injected);
+
+    // Categorize slots
+    const headings = slots.filter(s => s.type === 'heading');
+    const texts = slots.filter(s => s.type === 'text');
+    const buttons = slots.filter(s => s.type === 'button');
+    const iconBoxes = slots.filter(s => s.type === 'icon-box');
+    const counters = slots.filter(s => s.type === 'counter');
+    const testimonials = slots.filter(s => s.type === 'testimonial');
+    const accordions = slots.filter(s => s.type === 'accordion');
+    const imageBoxes = slots.filter(s => s.type === 'image-box');
+
+    let changes = 0;
+    const paragraphs = content.paragraphs || [];
+    const quotes = content.quotes || [];
+    const faq = content.faq || [];
+
+    // Inject headings: first heading = main heading, rest = subheading or paragraphs
+    if (headings.length > 0 && content.heading) {
+        // Find the "main" heading (usually largest or first H1/H2)
+        const mainIdx = headings.findIndex(h => {
+            const size = h.widget.settings?.header_size;
+            return size === 'h1' || size === 'h2' || !size;
+        });
+        const mi = mainIdx >= 0 ? mainIdx : 0;
+        headings[mi].widget.settings.title = content.heading;
+        changes++;
+
+        // If there's a subheading slot before the main heading (common: label above title)
+        if (mi > 0 && content.subheading) {
+            headings[0].widget.settings.title = content.subheading;
+            changes++;
+        }
+
+        // Remaining headings after main: fill with paragraphs or leave
+        let paraIdx = 0;
+        for (let i = 0; i < headings.length; i++) {
+            if (i === mi) continue;
+            if (i < mi) continue; // already handled
+            if (paragraphs.length && paraIdx < paragraphs.length) {
+                headings[i].widget.settings.title = paragraphs[paraIdx++];
+                changes++;
+            }
+        }
+    }
+
+    // Inject text-editor widgets with paragraphs
+    let pIdx = 0;
+    for (const slot of texts) {
+        if (pIdx < paragraphs.length) {
+            slot.widget.settings.editor = `<p>${paragraphs.slice(pIdx).join('</p><p>')}</p>`;
+            pIdx = paragraphs.length;
+            changes++;
+        }
+    }
+
+    // Inject icon-boxes with items + assign contextual FA icons
+    const SERVICE_ICONS = [
+        'fas fa-check-circle', 'fas fa-star', 'fas fa-shield-alt', 'fas fa-award',
+        'fas fa-bolt', 'fas fa-heart', 'fas fa-cog', 'fas fa-gem',
+        'fas fa-rocket', 'fas fa-thumbs-up', 'fas fa-lightbulb', 'fas fa-bullseye',
+    ];
+    const items = (content.items || []);
+    for (let i = 0; i < iconBoxes.length && i < items.length; i++) {
+        iconBoxes[i].widget.settings.title_text = items[i].title;
+        if (items[i].description) {
+            iconBoxes[i].widget.settings.description_text = items[i].description;
+        }
+        // Replace placeholder circle icons with contextual icons
+        const currentIcon = iconBoxes[i].widget.settings.selected_icon;
+        if (currentIcon && (currentIcon.value === 'fas fa-circle' || !currentIcon.value)) {
+            iconBoxes[i].widget.settings.selected_icon = {
+                value: SERVICE_ICONS[i % SERVICE_ICONS.length],
+                library: 'fa-solid',
+            };
+        }
+        changes++;
+    }
+
+    // Also fill image-boxes
+    for (let i = 0; i < imageBoxes.length; i++) {
+        const itemIdx = iconBoxes.length + 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++;
+        }
+    }
+
+    // Inject buttons
+    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;
+        }
+        changes++;
+    }
+
+    // Inject counters with stats
+    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) {
+            counters[i].widget.settings.title = contentStats[i].label;
+        }
+        changes++;
+    }
+
+    // Replace placeholder circle icons (standalone icon widgets)
+    const STAT_ICONS = [
+        'fas fa-chart-line', 'fas fa-users', 'fas fa-clock', 'fas fa-medal',
+        'fas fa-trophy', 'fas fa-clipboard-check', 'fas fa-hand-holding-heart', 'fas fa-stethoscope',
+    ];
+    const icons = slots.filter(s => s.type === 'icon');
+    for (let i = 0; i < icons.length; i++) {
+        const currentIcon = icons[i].widget.settings.selected_icon;
+        if (currentIcon && (currentIcon.value === 'fas fa-circle' || !currentIcon.value)) {
+            icons[i].widget.settings.selected_icon = {
+                value: STAT_ICONS[i % STAT_ICONS.length],
+                library: 'fa-solid',
+            };
+            changes++;
+        }
+    }
+
+    // Inject testimonials
+    for (let i = 0; i < testimonials.length && i < quotes.length; i++) {
+        testimonials[i].widget.settings.testimonial_content = quotes[i].text;
+        if (quotes[i].author) {
+            testimonials[i].widget.settings.testimonial_name = quotes[i].author;
+        }
+        changes++;
+    }
+
+    // Inject FAQ into accordion/toggle widgets
+    if (accordions.length > 0 && faq.length > 0) {
+        for (const acc of accordions) {
+            const wt = acc.widget.widgetType;
+
+            if (wt === 'nested-accordion') {
+                // nested-accordion: items[].item_title for questions, child elements for answers
+                const existingItems = acc.widget.settings.items || [];
+                if (existingItems.length === 0) continue;
+
+                const templateItem = JSON.parse(JSON.stringify(existingItems[0]));
+                const templateChild = acc.widget.elements?.[0] ? JSON.parse(JSON.stringify(acc.widget.elements[0])) : null;
+                const newItems = [];
+                const newChildren = [];
+
+                for (const qa of faq) {
+                    const item = JSON.parse(JSON.stringify(templateItem));
+                    item.item_title = qa.question;
+                    item._id = Math.random().toString(36).substr(2, 7);
+                    newItems.push(item);
+
+                    if (templateChild) {
+                        const child = JSON.parse(JSON.stringify(templateChild));
+                        // Update the text-editor widget inside the child container
+                        const textWidget = (child.elements || []).find(e => e.widgetType === 'text-editor');
+                        if (textWidget) {
+                            textWidget.settings.editor = `<p>${qa.answer}</p>`;
+                        }
+                        // Regenerate IDs for the child
+                        child.id = Math.random().toString(36).substr(2, 7);
+                        (child.elements || []).forEach(e => { e.id = Math.random().toString(36).substr(2, 7); });
+                        newChildren.push(child);
+                    }
+                }
+                acc.widget.settings.items = newItems;
+                if (newChildren.length > 0) acc.widget.elements = newChildren;
+                changes++;
+            } else {
+                // Toggle/accordion: tabs[].tab_title + tab_content
+                const tabsKey = acc.widget.settings.tabs ? 'tabs' : 'items';
+                const existingTabs = acc.widget.settings[tabsKey] || [];
+                if (existingTabs.length === 0) continue;
+
+                const template = JSON.parse(JSON.stringify(existingTabs[0]));
+                const newTabs = [];
+                for (const qa of faq) {
+                    const tab = JSON.parse(JSON.stringify(template));
+                    if ('tab_title' in tab) {
+                        tab.tab_title = qa.question;
+                        tab.tab_content = qa.answer;
+                    } else if ('item_title' in tab) {
+                        tab.item_title = qa.question;
+                    } else if ('title' in tab) {
+                        tab.title = qa.question;
+                        tab.content = qa.answer;
+                    }
+                    newTabs.push(tab);
+                }
+                acc.widget.settings[tabsKey] = newTabs;
+                changes++;
+            }
+        }
+    }
+
+    return { section: injected, changes };
+}
+
+// ================================================================
+// API CALL
+// ================================================================
+
+async function apiCall(endpoint, method = 'GET', body = null) {
+    const url = `${CONFIG.wordpressUrl}/wp-json/nvbc/v1${endpoint}`;
+    const auth = Buffer.from(`${CONFIG.username}:${CONFIG.applicationPassword}`).toString('base64');
+
+    console.error(`[API] ${method} ${url}`);
+
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+
+    try {
+        const options = {
+            method,
+            headers: {
+                'Authorization': `Basic ${auth}`,
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+                'User-Agent': `Vision-Builder-Control/${VERSION}`,
+            },
+            signal: controller.signal,
+        };
+        if (body) options.body = JSON.stringify(body);
+
+        const response = await fetch(url, options);
+        const data = await response.json();
+        if (!response.ok) throw new Error(data.message || `HTTP ${response.status}`);
+        return data;
+    } catch (err) {
+        if (err.name === 'AbortError') {
+            throw new Error(`Request timed out after ${FETCH_TIMEOUT_MS / 1000}s: ${method} ${endpoint}`);
+        }
+        throw err;
+    } finally {
+        clearTimeout(timer);
+    }
+}
+
+// ================================================================
+// TOKEN CACHE — fetches from REST API, caches 5 min, falls back to defaults
+// ================================================================
+
+const tokenCache = {
+    data: null,
+    timestamp: 0,
+    stale: null, // previous good data kept as fallback
+};
+
+const DEFAULT_TOKENS = {
+    colors: {
+        primary: '#0961AD', primary_dark: '#154168', primary_hover: '#043F72',
+        primary_gradient_end: '#074A8A', secondary: '#FFC32A', secondary_hover: '#ECB21D',
+        dark_bg: '#084D8F', light_bg: '#E8F4FA', text: '#191919', white: '#FFFFFF',
+        muted_text: '#5C6B7F', light_gray_bg: '#F8F9FA',
+    },
+    typography: {
+        heading_font: 'Poppins', body_font: 'Poppins',
+        button_weight: '600', button_transform: 'uppercase',
+    },
+    spacing: {
+        section_class: 'space-block-lg', button_padding: '15px 30px', border_radius: '100px',
+    },
+    urls: {
+        site_base: '', free_mri_review: '/free-mri-review', patient_experience: '/patient-experience',
+    },
+    buttons: {
+        primary_class: 'primary-btn', secondary_class: 'secondary-btn',
+    },
+    boilerplate: {
+        jet_parallax: true, plus_tooltip: true, tooltip_text: 'Luctus nec ullamcorper mattis',
+    },
+    globals_map: {
+        text: 'globals/colors?id=text', primary: 'globals/colors?id=primary', secondary: 'globals/colors?id=secondary',
+    },
+};
+
+async function getDesignTokens(forceRefresh = false) {
+    const now = Date.now();
+
+    // Return cache if fresh
+    if (!forceRefresh && tokenCache.data && (now - tokenCache.timestamp) < TOKEN_CACHE_TTL_MS) {
+        return tokenCache.data;
+    }
+
+    try {
+        const r = await apiCall('/design-tokens');
+        if (r.success && r.tokens) {
+            tokenCache.data = r.tokens;
+            tokenCache.stale = r.tokens;
+            tokenCache.timestamp = now;
+            console.error('[TOKENS] Refreshed from WordPress');
+            return r.tokens;
+        }
+    } catch (err) {
+        console.error(`[TOKENS] Fetch failed: ${err.message}`);
+    }
+
+    // Fallback chain: stale cache → hardcoded defaults
+    if (tokenCache.stale) {
+        console.error('[TOKENS] Using stale cache');
+        return tokenCache.stale;
+    }
+
+    console.error('[TOKENS] Using hardcoded defaults');
+    return DEFAULT_TOKENS;
+}
+
+/**
+ * Build Elementor button settings from tokens
+ */
+function buildButtonSettings(tokens, type) {
+    const c = tokens.colors;
+    const t = tokens.typography;
+    const b = tokens.buttons;
+    const bp = tokens.boilerplate;
+
+    if (type === 'primary') {
+        return {
+            text: '', link: { url: '', is_external: false, nofollow: false },
+            align: 'left', size: 'lg', icon_align: 'row-reverse',
+            button_text_color: c.white,
+            background_background: 'gradient',
+            background_color: c.primary,
+            background_color_b: c.primary_dark,
+            background_color_b_stop: { unit: '%', size: 98, sizes: [] },
+            background_gradient_angle: { unit: 'deg', size: 90, sizes: [] },
+            button_background_hover_background: 'gradient',
+            button_background_hover_color: c.primary,
+            button_background_hover_color_b: c.primary_hover,
+            border_radius: { unit: 'px', top: '100', right: '100', bottom: '100', left: '100', isLinked: true },
+            button_padding: { unit: 'px', top: 15, right: 30, bottom: 15, left: 30, isLinked: false },
+            typography_typography: 'custom', typography_font_family: t.heading_font,
+            typography_font_weight: t.button_weight, typography_text_transform: t.button_transform,
+            _css_classes: b.primary_class,
+            plus_tooltip_content_desc: bp.tooltip_text,
+            __globals__: { background_color: '', button_background_hover_color: tokens.globals_map?.primary || '', button_background_hover_color_b: '', hover_color: '' },
+        };
+    } else {
+        return {
+            text: '', link: { url: '', is_external: false, nofollow: false },
+            align: 'left', size: 'lg', icon_align: 'row-reverse',
+            button_text_color: c.text,
+            background_color: c.secondary,
+            button_background_hover_color: c.secondary_hover,
+            hover_color: '#000000',
+            border_radius: { unit: 'px', top: '100', right: '100', bottom: '100', left: '100', isLinked: true },
+            button_padding: { unit: 'px', top: 15, right: 30, bottom: 15, left: 30, isLinked: false },
+            typography_typography: 'custom', typography_font_family: t.heading_font,
+            typography_font_weight: t.button_weight, typography_text_transform: t.button_transform,
+            _css_classes: b.secondary_class,
+            plus_tooltip_content_desc: bp.tooltip_text,
+            __globals__: { background_color: tokens.globals_map?.secondary || '', button_text_color: '', hover_color: tokens.globals_map?.text || '', button_background_hover_color: '' },
+        };
+    }
+}
+
+// ================================================================
+// TOOL DEFINITIONS
+// ================================================================
+
+function getToolDefinitions() {
+    return [
+        {
+            name: 'health_check',
+            description: 'Check connection to Vision Builder Control WordPress plugin',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'get_design_tokens',
+            description: 'Get all design tokens (colors, typography, spacing, URLs, buttons, boilerplate). Tokens are cached for 5 minutes.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'set_design_tokens',
+            description: 'Save design tokens to WordPress. Requires manage_options capability.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    tokens: { type: 'object', description: 'Full or partial token object to save' }
+                },
+                required: ['tokens']
+            }
+        },
+        {
+            name: 'refresh_tokens',
+            description: 'Force re-fetch design tokens from WordPress, bypassing the cache.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'get_design_rules',
+            description: 'Get ALL design conventions: buttons, colors, container/widget boilerplate, URLs, section types. Generated from current design tokens. ALWAYS call this before generating or editing pages.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'get_button',
+            description: 'Get the correct Elementor button JSON for a given context. Returns ready-to-use widget JSON built from design tokens.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'Button label' },
+                    url: { type: 'string', description: 'Button URL' },
+                    context: { type: 'string', enum: ['hero', 'light_bg', 'dark_bg'], description: 'Where the button appears' }
+                },
+                required: ['text', 'url', 'context']
+            }
+        },
+        {
+            name: 'list_pages',
+            description: 'List all WordPress pages with their Elementor status, section count, and edit URLs.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'create_page',
+            description: 'Create a new WordPress page, optionally set up for Elementor editing.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Page title' },
+                    slug: { type: 'string', description: 'URL slug (optional, auto-generated from title)' },
+                    status: { type: 'string', enum: ['draft', 'publish', 'private'], description: 'Page status (default: draft)' },
+                    elementor: { type: 'boolean', description: 'Set up for Elementor editing (default: true)' }
+                },
+                required: ['title']
+            }
+        },
+        {
+            name: 'validate_page',
+            description: 'Run design validation on an Elementor page (CSS duals, boilerplate, duplicate IDs, etc.)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'extract_content',
+            description: 'Extract all text, headings, images, links, buttons, and placeholders from a page. Detects placeholder text, dynamic tags, and icon-box content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'import_template',
+            description: 'Import a full Elementor JSON template onto a page. Mode: replace (default) or append.',
+            inputSchema: {
+                type: 'object',
+                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)' }
+                },
+                required: ['page_id', 'template']
+            }
+        },
+        {
+            name: 'get_component_presets',
+            description: 'Get all component style presets (saved overrides + resolved values with fallbacks). Shows which components have customizable styles.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'set_component_presets',
+            description: 'Save style presets for a specific component. Empty values reset to defaults. Requires manage_options capability.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    component_id: { type: 'string', description: 'Component ID: "category/name" (e.g., "stats/stats-bar-4col-dark")' },
+                    presets: { type: 'object', description: 'Style overrides (e.g., {"stat_number_color": "#FFD700", "divider_width": "2"})' }
+                },
+                required: ['component_id', 'presets']
+            }
+        },
+        {
+            name: 'list_components',
+            description: 'List all available design components (heroes, stats bars, CTAs, etc.). Each component has metadata showing what variables can be customized.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'add_component',
+            description: 'Add a single component to a page. Components are pre-built, proven sections (hero, stats bar, conditions grid, CTA, etc.). Variables populate content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    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' }
+                },
+                required: ['page_id', 'category', 'name']
+            }
+        },
+        {
+            name: 'build_page',
+            description: 'Build entire page from component list. Pass array of components with variables. Uses proven designs with token-driven styling.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    sections: {
+                        type: 'array',
+                        description: 'Array of components: [{category, name, variables}, ...]',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                category: { type: 'string' },
+                                name: { type: 'string' },
+                                variables: { type: 'object' }
+                            }
+                        }
+                    },
+                    mode: { type: 'string', enum: ['replace', 'append'], description: 'Build mode (default: replace)' }
+                },
+                required: ['page_id', 'sections']
+            }
+        },
+        {
+            name: 'list_sections',
+            description: 'List all top-level sections on a page with index, ID, CSS classes, and heading text. Use before remove/reorder operations.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'remove_section',
+            description: 'Remove a single section from a page by its index (0-based) or Elementor section ID.',
+            inputSchema: {
+                type: 'object',
+                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)' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'reorder_sections',
+            description: 'Reorder, move, or swap sections on a page. Three modes: "move" (move one section to a new position), "swap" (swap two sections), "order" (provide full reordering array).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    move: {
+                        type: 'object',
+                        description: 'Move a section: {from: index, to: index}',
+                        properties: { from: { type: 'number' }, to: { type: 'number' } }
+                    },
+                    swap: {
+                        type: 'array',
+                        description: 'Swap two sections: [indexA, indexB]',
+                        items: { type: 'number' }
+                    },
+                    order: {
+                        type: 'array',
+                        description: 'Full reorder: array of current indices in desired order, e.g. [2,0,1,3]',
+                        items: { type: 'number' }
+                    }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'list_elements',
+            description: 'List the element tree inside a page or specific section. Shows IDs, types, widget names, and text previews for every container and widget. Use to find element IDs before remove_element.',
+            inputSchema: {
+                type: 'object',
+                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)' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'remove_element',
+            description: 'Remove any element (widget, inner container, or section) by its Elementor ID. Works at any depth in the page tree. Use list_elements first to find the ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    element_id: { type: 'string', description: 'Elementor element ID to remove' }
+                },
+                required: ['page_id', 'element_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.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    element_id: { type: 'string', description: 'Elementor element ID to update' },
+                    settings: {
+                        type: 'object',
+                        description: 'Key-value pairs of settings to set. May not work reliably via MCP — use settings_json instead.',
+                        additionalProperties: true
+                    },
+                    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":""}}\''
+                    }
+                },
+                required: ['page_id', 'element_id']
+            }
+        },
+        {
+            name: 'audit_links',
+            description: 'Scan all Elementor pages and audit link targets. Reports internal links that open in new tab and external links that open in same tab. Use include_templates to also scan library templates (menus, headers, footers).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: scan only this page. Omit to scan ALL Elementor pages.' },
+                    include_templates: { type: 'boolean', description: 'If true, also scan Elementor library templates (menus, headers, footers). Default: false.' }
+                }
+            }
+        },
+        {
+            name: 'fix_links',
+            description: 'Auto-fix link targets across all Elementor pages. Internal links → same tab, external → new tab. Supports dry_run mode. Use include_templates to also fix library templates.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: fix only this page. Omit to fix ALL Elementor pages.' },
+                    dry_run: { type: 'boolean', description: 'If true, report what would be fixed without making changes. Default: false.' },
+                    include_templates: { type: 'boolean', description: 'If true, also fix Elementor library templates (menus, headers, footers). Default: false.' }
+                }
+            }
+        },
+        {
+            name: 'export_page',
+            description: 'Export raw Elementor JSON data for a page. Returns full template JSON plus page metadata (title, slug, status, template). Use for backups before destructive operations or to copy templates between pages.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' }
+                },
+                required: ['page_id']
+            }
+        },
+        {
+            name: 'audit_images',
+            description: 'Scan Elementor pages for image issues: missing alt text, empty image URLs. With deep=true, also checks image format (non-WebP), file size (>200KB), oversized dimensions (>2000px), and provides a format breakdown summary. Optional fix mode adds placeholder alt text based on nearby headings.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: scan only this page' },
+                    deep: { type: 'boolean', description: 'If true, also check format (non-WebP), file size, dimensions. Slower but comprehensive. Default: false.' },
+                    fix: { type: 'boolean', description: 'If true, auto-add placeholder alt text to images missing it. Default: false (audit only).' },
+                    dry_run: { type: 'boolean', description: 'If fix=true and dry_run=true, preview fixes without saving. Default: false.' }
+                }
+            }
+        },
+        {
+            name: 'find_replace',
+            description: 'Global find & replace across all Elementor pages. Searches heading titles, text-editor HTML, button text, image-box titles/descriptions, icon-list items, toggle titles/content, and image alt text. Supports literal text or regex. Always preview with dry_run=true first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    search: { type: 'string', description: 'Text to find (literal string or regex pattern)' },
+                    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.' }
+                },
+                required: ['search', 'replace']
+            }
+        },
+        {
+            name: 'copy_element',
+            description: 'Copy an element (section, container, or widget) from one page to another. Deep-clones with all descendants and regenerates all Elementor IDs. Use list_elements to find the source element ID first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    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' }
+                },
+                required: ['source_page_id', 'element_id', 'target_page_id']
+            }
+        },
+        {
+            name: 'check_links',
+            description: 'Check all URLs on Elementor pages for broken links (404, 500, timeout). Performs HTTP HEAD requests to each unique URL. May take 30-60 seconds for sites with many links.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: check only this page. Recommended for speed.' }
+                }
+            }
+        },
+        // ── Posts CRUD ──
+        {
+            name: 'list_posts',
+            description: 'List WordPress posts, pages, or custom post types with filtering. Supports search, status filter, pagination. Returns metadata, editor type, and featured image.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_type: { type: 'string', description: '"post", "page", "any" (default), or CPT slug' },
+                    status: { type: 'string', description: 'Comma-separated: publish,draft,private (default: all three)' },
+                    search: { type: 'string', description: 'Search by keyword' },
+                    per_page: { type: 'number', description: 'Results per page, max 100 (default: 50)' },
+                    page: { type: 'number', description: 'Page number (default: 1)' }
+                }
+            }
+        },
+        {
+            name: 'get_post',
+            description: 'Get a single WordPress post/page with ALL details: content, excerpt, Elementor status, RankMath SEO data (title, description, keywords, score), taxonomies (categories, tags), and featured image.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'create_post',
+            description: 'Create a WordPress post, page, or CPT. Supports content, excerpt, taxonomies, featured image, Elementor setup, and initial RankMath SEO data.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Post title' },
+                    post_type: { type: 'string', description: '"post" (default), "page", or CPT slug' },
+                    content: { type: 'string', description: 'Post content (block HTML or plain text)' },
+                    excerpt: { type: 'string', description: 'Post excerpt' },
+                    status: { type: 'string', enum: ['draft', 'publish', 'private', 'pending'], description: 'Post status (default: draft)' },
+                    slug: { type: 'string', description: 'URL slug (auto-generated if omitted)' },
+                    taxonomies: { type: 'object', description: 'Object: {"category": [1,2], "post_tag": ["seo","health"]}' },
+                    featured_image_id: { type: 'number', description: 'Media library attachment ID' },
+                    elementor: { type: 'boolean', description: 'Set up for Elementor editing' },
+                    seo: { type: 'object', description: 'RankMath SEO: {title, description, focus_keyword, robots, ...}' }
+                },
+                required: ['title']
+            }
+        },
+        {
+            name: 'update_post',
+            description: 'Update any field on a WordPress post/page. Only provided fields are changed. Supports title, content, status, slug, excerpt, taxonomies, featured image, and RankMath SEO.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' },
+                    title: { type: 'string' },
+                    content: { type: 'string' },
+                    excerpt: { type: 'string' },
+                    status: { type: 'string', enum: ['draft', 'publish', 'private', 'pending', 'trash'] },
+                    slug: { type: 'string' },
+                    parent: { type: 'number', description: 'Parent post/page ID (for hierarchical types like pages). Changes URL structure.' },
+                    taxonomies: { type: 'object', description: '{"category": [1,2]}' },
+                    featured_image_id: { type: 'number', description: 'Attachment ID (omit to keep, pass null to remove)' },
+                    seo: { type: 'object', description: 'RankMath SEO fields to update' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'delete_post',
+            description: 'Trash or permanently delete a WordPress post/page. Default: moves to trash (recoverable). Use force=true for permanent deletion.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' },
+                    force: { type: 'boolean', description: 'If true, permanently delete (not recoverable). Default: false (trash).' }
+                },
+                required: ['post_id']
+            }
+        },
+        // ── RankMath SEO ──
+        {
+            name: 'get_seo',
+            description: 'Get all RankMath SEO data for a post: title, description, focus keyword, score, robots, canonical URL, Open Graph, Twitter card, primary category.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'update_seo',
+            description: 'Update RankMath SEO fields on a post. Accepts any subset: title, description, focus_keyword, robots (array), canonical_url, facebook_title/description/image, twitter_title/description/image, primary_category.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' },
+                    title: { type: 'string', description: 'SEO meta title' },
+                    description: { type: 'string', description: 'SEO meta description' },
+                    focus_keyword: { type: 'string', description: 'Primary focus keyword' },
+                    robots: { type: 'array', items: { type: 'string' }, description: '["index","follow"] or ["noindex","nofollow"]' },
+                    canonical_url: { type: 'string' },
+                    facebook_title: { type: 'string' },
+                    facebook_description: { type: 'string' },
+                    facebook_image: { type: 'string' },
+                    twitter_title: { type: 'string' },
+                    twitter_description: { type: 'string' },
+                    twitter_image: { type: 'string' },
+                    primary_category: { type: 'number' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'audit_seo',
+            description: 'Scan all published posts/pages for SEO issues: missing title, missing description, missing focus keyword, low score (<50), noindex flags.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_type: { type: 'string', description: 'Optional: filter by post type (e.g., "page" or "post")' }
+                }
+            }
+        },
+        // ── Taxonomies ──
+        {
+            name: 'list_taxonomies',
+            description: 'List all public WordPress taxonomies (categories, tags, custom) with their terms. Optionally filter by post type.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_type: { type: 'string', description: 'Optional: only show taxonomies for this post type' }
+                }
+            }
+        },
+        {
+            name: 'set_post_terms',
+            description: 'Set taxonomy terms on a post. For categories: pass term IDs. For tags: pass strings (auto-created if new). Use append=true to add without replacing.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID' },
+                    taxonomy: { type: 'string', description: 'Taxonomy slug: "category", "post_tag", or custom' },
+                    terms: { type: 'array', description: 'Array of term IDs (numbers) or names (strings)' },
+                    append: { type: 'boolean', description: 'If true, add without removing existing. Default: false (replace).' }
+                },
+                required: ['post_id', 'taxonomy', 'terms']
+            }
+        },
+
+        // ── Revisions ──
+        {
+            name: 'list_revisions',
+            description: 'List all revisions for a post or template with dates, authors, and Elementor widget/section counts. Use this to find a revision to restore from.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page/template ID' }
+                },
+                required: ['post_id']
+            }
+        },
+        {
+            name: 'restore_revision',
+            description: 'Restore _elementor_data from a specific revision to the parent post/template. Safe for both pages and library templates (menus, headers, footers). Shows before/after widget counts.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page/template ID to restore' },
+                    revision_id: { type: 'number', description: 'Revision ID to restore from (get from list_revisions)' }
+                },
+                required: ['post_id', 'revision_id']
+            }
+        },
+
+        // ── Elementor Library Templates ──
+        {
+            name: 'list_templates',
+            description: 'List all Elementor library templates (mega menus, headers, footers, popups, sections). Shows template type, widget count, and display conditions. Optionally filter by type.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string', description: 'Optional filter: "header", "footer", "popup", "section", "page", etc.' }
+                }
+            }
+        },
+        {
+            name: 'get_template',
+            description: 'Get a library template\'s full element tree and Elementor data. Use this to read mega menus, headers, footers, and popups. Returns both raw elementor_data and a simplified tree summary.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    template_id: { type: 'number', description: 'Elementor library template ID' }
+                },
+                required: ['template_id']
+            }
+        },
+        {
+            name: 'update_template',
+            description: 'Safely update a library template\'s _elementor_data. MUST use this instead of import_template for menus, headers, footers, and popups — import_template corrupts library templates. Accepts modified elementor_data array.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    template_id: { type: 'number', description: 'Elementor library template ID' },
+                    elementor_data: { type: 'array', description: 'The full Elementor data array to write' }
+                },
+                required: ['template_id', 'elementor_data']
+            }
+        },
+        {
+            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.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    include_templates: { type: 'boolean', description: 'Also scan library templates (default: false)' }
+                }
+            }
+        },
+        {
+            name: 'audit_ctas',
+            description: 'Audit all published pages for CTA button coverage. Reports button count per page, flags pages below minimum threshold, detects buttons with empty/# URLs, and identifies over-repeated URLs.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    min_buttons: { type: 'number', description: 'Minimum buttons expected per page (default: 2)' },
+                    include_templates: { type: 'boolean', description: 'Also scan library templates (default: false)' }
+                }
+            }
+        },
+
+        {
+            name: 'audit_clickable',
+            description: 'Scan all published Elementor pages for plain-text phone numbers, email addresses, and URLs that are NOT wrapped in <a> tags. These should be clickable links but are just text. Returns issues with element IDs, matched values, and suggested fix HTML.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    target_id: { type: 'number', description: 'Scan a single page by ID. Omit to scan all published pages.' },
+                    include_templates: { type: 'boolean', description: 'Also scan library templates (default: false)' }
+                }
+            }
+        },
+
+        // ── Element Operations (v3.6.0) ──
+        {
+            name: 'add_element',
+            description: 'Add a widget or container into a parent container on a page. Pass the full Elementor element JSON (elType, widgetType, settings, etc.). If no ID is provided, one will be auto-generated. Use position to insert at a specific index.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    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.' }
+                },
+                required: ['page_id', 'parent_id', 'element']
+            }
+        },
+        {
+            name: 'get_element',
+            description: 'Get a single element\'s full settings and metadata by its Elementor ID. Returns elType, widgetType, all settings, and a summary of children (for containers). Use this to inspect an element before updating it.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'WordPress page ID' },
+                    element_id: { type: 'string', description: 'Elementor element ID to retrieve' }
+                },
+                required: ['page_id', 'element_id']
+            }
+        },
+        {
+            name: 'batch_update_elements',
+            description: 'Batch update element settings across multiple pages in one call. Groups updates by page to minimize DB reads/writes. IMPORTANT: Prefer updates_json (JSON string) over updates (array) for reliable MCP transport.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    updates: {
+                        type: 'array',
+                        description: 'Array of updates: [{page_id, element_id, settings}, ...]. May not work reliably via MCP — use updates_json instead.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                page_id: { type: 'number' },
+                                element_id: { type: 'string' },
+                                settings: { type: 'object', additionalProperties: true }
+                            },
+                            required: ['page_id', 'element_id', 'settings']
+                        }
+                    },
+                    updates_json: {
+                        type: 'string',
+                        description: 'Updates as a JSON string (preferred). Example: \'[{"page_id":123,"element_id":"abc","settings":{"title":"New"}}]\''
+                    }
+                }
+            }
+        },
+        {
+            name: 'manage_redirects',
+            description: 'Manage RankMath 301 redirects. Actions: "create" (add redirects), "list" (show all), "delete" (remove by ID). Source paths should NOT include the site subdirectory prefix (e.g. /treatment-options/old-slug/), but destination paths SHOULD include it (e.g. /deuk/treatment-options/new-slug/).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['create', 'list', 'delete'], description: 'Action: create, list, or delete' },
+                    redirects: {
+                        type: 'array',
+                        description: 'For "create": array of {source, destination, code}. code defaults to 301.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                source: { type: 'string', description: 'Source URL path (without site prefix)' },
+                                destination: { type: 'string', description: 'Destination URL path (with site prefix)' },
+                                code: { type: 'number', description: 'HTTP redirect code (default: 301)' }
+                            },
+                            required: ['source', 'destination']
+                        }
+                    },
+                    ids: { type: 'array', items: { type: 'number' }, description: 'For "delete": array of redirect IDs to remove' }
+                },
+                required: ['action']
+            }
+        },
+
+        // ── Performance Audit (v3.7.0) ──
+        {
+            name: 'audit_page_weight',
+            description: 'Audit Elementor page complexity and weight. Reports total elements, containers, widgets, images, videos, max nesting depth, estimated DOM nodes, JSON size, and widget type breakdown. Flags heavy pages exceeding threshold. Use to identify pages that need optimization.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id: { type: 'number', description: 'Optional: audit only this page' },
+                    max_elements: { type: 'number', description: 'Element count threshold for flagging heavy pages (default: 300)' }
+                }
+            }
+        },
+        {
+            name: 'audit_page_speed',
+            description: 'Run Google PageSpeed Insights on a URL and return Core Web Vitals (LCP, FCP, CLS, TBT, SI, TTI), performance score, and top optimization opportunities with estimated savings. Works without API key (rate-limited) or with optional key stored in WP options.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: { type: 'string', description: 'Full URL to test (e.g. https://example.com/page)' },
+                    page_id: { type: 'number', description: 'Alternative: WordPress page ID (will use its permalink)' },
+                    strategy: { type: 'string', enum: ['mobile', 'desktop'], description: 'Test strategy (default: mobile)' }
+                }
+            }
+        },
+        // ── Section Operations ──
+        {
+            name: 'copy_section',
+            description: 'Copy a section from one page/template to another. Deep-clones with regenerated IDs. Works with both pages and library templates. Use list_sections to find the section index first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    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' }
+                },
+                required: ['source_id', 'section_index', 'target_id']
+            }
+        },
+        {
+            name: 'append_section',
+            description: 'Append a section to an existing page or template without downloading the full template. Pass the section JSON directly — no need to export, merge, and re-upload. Useful for adding CTA sections, footers, or any reusable block.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    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)' }
+                },
+                required: ['target_id', 'section']
+            }
+        },
+
+        // ── Template Library Tools ──
+
+        {
+            name: 'template_list_kits',
+            description: 'List all available template kits in the template library. Shows kit name, industry, page count, section count, and design token summary (colors, fonts). Use this to discover what templates are available before selecting one.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            }
+        },
+        {
+            name: 'template_browse_sections',
+            description: 'Browse sections from the template library catalog. Filter by kit, section type, or page name. Returns section metadata with widget composition, layout info, and text preview — useful for finding the right section to use.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    kit_id: { type: 'string', description: 'Filter by kit ID (folder name). Omit to search all kits.' },
+                    type: { type: 'string', description: 'Filter by section type: hero, cta, features-grid, stats-bar, testimonials, team-grid, pricing-table, faq, contact-form, about-content, services-grid, gallery, blog-grid, logo-strip, text-content, comparison-table, process-steps, tabs-content, map-section' },
+                    page_name: { type: 'string', description: 'Filter by page name (partial match, case-insensitive)' },
+                    limit: { type: 'number', description: 'Max results to return (default: 20)' }
+                },
+            }
+        },
+        {
+            name: 'template_get_section',
+            description: 'Get the full Elementor JSON for a specific section from the template library. Returns the complete section object ready to be used with append_section or for content injection. Use template_browse_sections first to find the section ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    section_id: { type: 'string', description: 'Section ID from the catalog (format: kit-id/page-slug/section-index)' }
+                },
+                required: ['section_id']
+            }
+        },
+        {
+            name: 'template_map_content',
+            description: 'Analyze page content (markdown) and recommend the best template sections from the library for each content block. Parses headings, detects content types (hero, features, FAQ, pricing, testimonials, CTA, etc.), and returns ranked section recommendations from the selected kit. Use this to plan a page layout before assembling sections.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'Page content in markdown format. Use ## headings to separate content blocks.' },
+                    kit_id: { type: 'string', description: 'Preferred kit ID to pull sections from. Omit to search all kits.' },
+                    page_type: { type: 'string', description: 'Optional page type hint: home, about, services, contact, faq, pricing, team, blog' }
+                },
+                required: ['content']
+            }
+        },
+        {
+            name: 'template_get_tokens',
+            description: 'Get the design tokens (colors, typography, button styles) from a template kit. Use this to understand a kit\'s visual identity before rebranding or to compare with your project\'s tokens.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    kit_id: { type: 'string', description: 'Kit ID (folder name) to get tokens from' }
+                },
+                required: ['kit_id']
+            }
+        },
+        {
+            name: 'template_rebrand',
+            description: 'Rebrand a template section by replacing colors, fonts, and global token references. Takes a section (from template_get_section) and applies your brand\'s colors and fonts. Handles hardcoded hex colors, __globals__ references, font families, and nested objects (shadows, borders). Returns the rebranded section JSON ready for append_section.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    section_id: { type: 'string', description: 'Section ID from the catalog (format: kit-id/page-slug/section-index). The section JSON will be loaded automatically.' },
+                    section_json: { type: 'object', description: 'Alternatively, pass section JSON directly instead of section_id.' },
+                    colors: {
+                        type: 'object',
+                        description: 'Color replacement map. Keys can be hex colors (#RRGGBB) or system color IDs (primary, secondary, text, accent, or custom IDs). Values are target hex colors. Example: {"#F79996": "#084D8F", "secondary": "#1A1A1A"}',
+                        additionalProperties: { type: 'string' }
+                    },
+                    fonts: {
+                        type: 'object',
+                        description: 'Font replacement map. Keys are source font families, values are target font families. Example: {"Bricolage Grotesque": "Montserrat", "Inter Tight": "Open Sans"}',
+                        additionalProperties: { type: 'string' }
+                    },
+                    globals: {
+                        type: 'object',
+                        description: 'Global reference replacement map. Keys are source __globals__ references (e.g., "globals/colors?id=secondary"), values are target references. Example: {"globals/colors?id=secondary": "globals/colors?id=primary"}',
+                        additionalProperties: { type: 'string' }
+                    },
+                    auto_map_from_kit: { type: 'string', description: 'Source kit ID. If provided, automatically loads the kit\'s tokens to resolve system color IDs in the colors map.' }
+                },
+            }
+        },
+        {
+            name: 'template_inject_content',
+            description: 'Inject structured content into a template section\'s widgets. Replaces heading titles, text-editor paragraphs, icon-box items, button labels/URLs, counter stats, testimonial quotes, and FAQ accordion items. Use after template_rebrand to fill a section with your actual content before deploying.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    section_id: { type: 'string', description: 'Section ID from catalog (format: kit-id/page-slug/section-index). Loads the section automatically.' },
+                    section_json: { type: 'object', description: 'Alternatively, pass section JSON directly (e.g., output from template_rebrand).' },
+                    content: {
+                        type: 'object',
+                        description: 'Structured content to inject into the section.',
+                        properties: {
+                            heading: { type: 'string', description: 'Main heading text' },
+                            subheading: { type: 'string', description: 'Optional subtitle/label above main heading' },
+                            paragraphs: { type: 'array', items: { type: 'string' }, description: 'Paragraph texts' },
+                            items: {
+                                type: 'array',
+                                items: { type: 'object', properties: { title: { type: 'string' }, description: { type: 'string' } } },
+                                description: 'Feature/service items with title + description (for icon-boxes)'
+                            },
+                            stats: {
+                                type: 'array',
+                                items: { type: 'object', properties: { value: { type: 'string' }, label: { type: 'string' } } },
+                                description: 'Stat values for counter widgets (e.g., {value: "500+", label: "Cases Won"})'
+                            },
+                            buttons: {
+                                type: 'array',
+                                items: { type: 'object', properties: { text: { type: 'string' }, url: { type: 'string' } } },
+                                description: 'CTA button labels and URLs'
+                            },
+                            quotes: {
+                                type: 'array',
+                                items: { type: 'object', properties: { text: { type: 'string' }, author: { type: 'string' } } },
+                                description: 'Testimonial quotes with author names'
+                            },
+                            faq: {
+                                type: 'array',
+                                items: { type: 'object', properties: { question: { type: 'string' }, answer: { type: 'string' } } },
+                                description: 'FAQ question/answer pairs (for accordion/toggle widgets)'
+                            }
+                        },
+                        required: ['heading']
+                    }
+                },
+                required: ['content']
+            }
+        },
+        {
+            name: 'template_assemble_page',
+            description: 'End-to-end page assembly: parse markdown content → map to template sections → rebrand with your colors/fonts → inject content → create WordPress page → append all sections. This is the complete text-to-design pipeline in one tool call.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Page title for WordPress' },
+                    slug: { type: 'string', description: 'URL slug (optional, auto-generated from title if omitted)' },
+                    content: { type: 'string', description: 'Page content in markdown format. Use ## headings to separate content blocks.' },
+                    kit_id: { type: 'string', description: 'Template kit ID to use for section selection' },
+                    colors: { type: 'object', description: 'Brand color map: source hex/ID → target hex. Passed to template_rebrand.', additionalProperties: { type: 'string' } },
+                    fonts: { type: 'object', description: 'Brand font map: source family → target family.', additionalProperties: { type: 'string' } },
+                    globals: { type: 'object', description: 'Global reference replacement map.', additionalProperties: { type: 'string' } },
+                    status: { type: 'string', enum: ['draft', 'publish', 'private'], description: 'Page status (default: draft)' },
+                    page_type: { type: 'string', description: 'Page type hint for section mapper: home, about, services, contact, faq, pricing, team, blog' }
+                },
+                required: ['title', 'content', 'kit_id']
+            }
+        },
+        {
+            name: 'get_shortcode_status',
+            description: 'Check if NVBC shortcodes are enabled and list available shortcodes. Use this before attempting to use shortcodes in templates.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'toggle_shortcodes',
+            description: 'Enable or disable NVBC shortcodes. When enabled, shortcodes like [nvbc_categories] become available for solving Elementor rendering limitations.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    enabled: { type: 'boolean', description: 'true to enable, false to disable' }
+                },
+                required: ['enabled']
+            }
+        },
+        {
+            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.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'update_site_profile',
+            description: 'Update site profile values. Only known keys are accepted (site_name, staging_url, production_url, primary_color, secondary_color, font_heading, font_body, cta_phone, cta_text, team_timezone, etc). Unknown keys are rejected. Merge semantics — only provided keys are updated.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    profile: {
+                        type: 'object',
+                        description: 'Key-value pairs to update. Example: {"site_name": "Deuk Spine", "primary_color": "#084D8F"}'
+                    }
+                },
+                required: ['profile']
+            }
+        },
+        {
+            name: 'list_changes',
+            description: 'List recent changes made to the site. Shows who made each change (user + IP), when, what was changed, and whether it was via MCP or manual. Use to audit recent activity.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'Filter by page/post ID' },
+                    source:  { type: 'string', enum: ['mcp', 'manual', 'api'], description: 'Filter by source' },
+                    limit:   { type: 'number', description: 'Max entries (default 20)' }
+                }
+            }
+        },
+        {
+            name: 'rollback_change',
+            description: 'Revert a specific change by its changelog ID. Use list_changes first to find the ID. Currently supports rollback for update_element actions.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    changelog_id: { type: 'number', description: 'Changelog entry ID to rollback' },
+                    preview: { type: 'boolean', description: 'If true, show what would be rolled back without applying (default: false)' }
+                },
+                required: ['changelog_id']
+            }
+        },
+        {
+            name: 'validate_all_pages',
+            description: 'Validate all Elementor pages against design patterns (CSS class duality, boilerplate, root layout, duplicate IDs). Returns per-page scores and aggregate summary.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    verbose: { type: 'boolean', description: 'Include detailed issues per page (default: false)' }
+                }
+            }
+        },
+        {
+            name: 'get_audit_report',
+            description: 'Get the latest weekly audit report. Shows summary of link, image, and SEO issues across all pages from the most recent scheduled audit run.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'run_audit_now',
+            description: 'Manually trigger a full site audit immediately — bypasses the scheduled cron and the audit_enabled flag. Runs link, image, and SEO checks across all pages in batches. After triggering, wait ~30–60s then call get_audit_report for results.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        }
+    ];
+}
+
+// ================================================================
+// TOOL HANDLER
+// ================================================================
+
+async function handleToolCall(name, args) {
+    console.error(`[MCP] ${name}`);
+
+    switch (name) {
+
+    case 'health_check': {
+        try {
+            const r = await apiCall('/health');
+            return ok(
+                `Vision Builder Control: ACTIVE\n` +
+                `Plugin: v${r.version}\n` +
+                `Elementor: ${r.elementor ? 'Active' : 'NOT ACTIVE'}\n` +
+                `Components: ${r.components}\n` +
+                `Shortcodes: ${r.shortcodes ? 'Enabled' : 'Disabled'}\n` +
+                `MCP Server: v${VERSION} (${httpMode ? 'HTTP/SSE' : 'stdio'})`
+            );
+        } catch (e) {
+            return ok(`Vision Builder Control: NOT RESPONDING\nError: ${e.message}\n\nMake sure:\n1. Noleemits Vision Builder Control plugin is activated\n2. Elementor is installed and activated\n3. WP_URL, WP_USER, WP_APP_PASSWORD are correct`);
+        }
+    }
+
+    case 'get_design_tokens': {
+        const tokens = await getDesignTokens();
+        return ok(`=== DESIGN TOKENS ===\n\n${JSON.stringify(tokens, null, 2)}`);
+    }
+
+    case 'set_design_tokens': {
+        const r = await apiCall('/design-tokens', 'POST', { tokens: args.tokens });
+        if (r.success) {
+            tokenCache.data = null; // Invalidate cache
+            return ok(`Tokens saved successfully.\n\nUpdated tokens:\n${JSON.stringify(r.tokens, null, 2)}`);
+        }
+        return ok(`Failed to save tokens: ${r.message || 'Unknown error'}`);
+    }
+
+    case 'refresh_tokens': {
+        const tokens = await getDesignTokens(true);
+        return ok(`Tokens refreshed from WordPress.\n\n${JSON.stringify(tokens, null, 2)}`);
+    }
+
+    case 'get_design_rules': {
+        const tokens = await getDesignTokens();
+        const c = tokens.colors || {};
+        const t = tokens.typography || {};
+        const s = tokens.spacing || {};
+        const u = tokens.urls || {};
+        const bp = tokens.boilerplate || {};
+        const gm = tokens.globals_map || {};
+
+        return ok(
+            `=== DESIGN RULES ===\n\n` +
+            `--- BUTTONS ---\n` +
+            `Primary: gradient ${c.primary} -> ${c.primary_dark}, text ${c.white}, class "${tokens.buttons?.primary_class}"\n` +
+            `Secondary: solid ${c.secondary}, text ${c.text}, class "${tokens.buttons?.secondary_class}"\n` +
+            `Rules:\n  - Hero: ALWAYS secondary\n  - Light bg: primary\n  - Dark bg (1 btn): secondary\n  - Dark bg (2 btn): BOTH secondary\n\n` +
+            `--- COLORS (hex) ---\n${Object.entries(c).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\n` +
+            `--- COLORS (__globals__) ---\n${Object.entries(gm).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\n` +
+            `--- CONTAINER RULES ---\n` +
+            `  Root: layout = "full_width"\n` +
+            `  ALL containers: jet_parallax_layout_list = []\n` +
+            `  css_classes MUST match _css_classes\n` +
+            `  Section spacing: "${s.section_class}"\n\n` +
+            `--- WIDGET RULES ---\n` +
+            `  ALL widgets: elements = []\n` +
+            `  ALL widgets: plus_tooltip_content_desc = "${bp.tooltip_text}"\n\n` +
+            `--- TYPOGRAPHY ---\n  Heading: ${t.heading_font}\n  Body: ${t.body_font}\n  Button: ${t.button_weight} ${t.button_transform}\n\n` +
+            `--- URLS ---\n${Object.entries(u).map(([k, v]) => `  ${k}: ${v}`).join('\n')}`
+        );
+    }
+
+    case 'get_button': {
+        const tokens = await getDesignTokens();
+        const isSecondary = args.context === 'hero' || args.context === 'dark_bg';
+        const type = isSecondary ? 'secondary' : 'primary';
+        const settings = buildButtonSettings(tokens, type);
+        settings.text = args.text;
+        settings.link = { url: args.url, is_external: false, nofollow: false };
+
+        const widget = {
+            id: rndId(),
+            elType: 'widget',
+            widgetType: 'button',
+            settings,
+            elements: [],
+            isInner: false,
+        };
+        return ok(`${type.toUpperCase()} button for ${args.context}:\n\n${JSON.stringify(widget, null, 2)}`);
+    }
+
+    case 'list_pages': {
+        const r = await apiCall('/pages');
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `${r.count} Pages\n\n`;
+        r.pages.forEach(p => {
+            out += `  [${p.id}] ${p.title} (${p.status}, ${p.editor}, ${p.sections} sections)\n`;
+            out += `    URL: ${p.url}\n    Edit: ${p.edit_url}\n`;
+        });
+        return ok(out);
+    }
+
+    case 'create_page': {
+        const r = await apiCall('/pages', 'POST', {
+            title: args.title,
+            slug: args.slug,
+            status: args.status || 'draft',
+            elementor: parseBool(args.elementor, true),
+        });
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(
+            `Page Created!\n` +
+            `ID: ${r.page_id}\n` +
+            `Title: ${r.title}\n` +
+            `Slug: ${r.slug}\n` +
+            `Status: ${r.status}\n` +
+            `Editor: ${r.editor}\n` +
+            `URL: ${r.url}\n` +
+            `Edit: ${r.edit_url}`
+        );
+    }
+
+    case 'validate_page': {
+        const r = await apiCall(`/pages/${args.page_id}/validate`);
+        if (r.valid) {
+            const sectionOrder = (r.section_order || []).map((s, i) => `  ${i + 1}. ${s}`).join('\n');
+            return ok(`ALL CHECKS PASSED!\nSections: ${r.stats?.sections || 0} | Containers: ${r.stats?.containers || 0} | Widgets: ${r.stats?.widgets || 0} | IDs: ${r.unique_ids || 0}\n\nOrder:\n${sectionOrder}`);
+        }
+        const issueCount = r.issues?.length || 0;
+        const issueList = (r.issues || []).map(i => `  - ${i}`).join('\n');
+        return ok(`ISSUES FOUND (${issueCount}):\n${issueList}\n\nStats: ${r.stats?.sections || 0}s / ${r.stats?.containers || 0}c / ${r.stats?.widgets || 0}w`);
+    }
+
+    case 'extract_content': {
+        const r = await apiCall(`/pages/${args.page_id}/extract`);
+        let out = `=== "${r.title}" ===\nID: ${r.page_id} | Editor: ${r.editor} | Words: ${r.word_count} | Buttons: ${r.buttons?.length || 0}\n`;
+        if (r.placeholders?.length) { out += `⚠ PLACEHOLDERS (${r.placeholders.length}):\n${r.placeholders.map(p => `  [${p.id}] ${p.widget}: "${p.text}"`).join('\n')}\n\n`; }
+        else { out += '\n'; }
+        if (r.headings?.length) { out += `--- HEADINGS ---\n${r.headings.map(h => `  ${h.level}: ${h.text}`).join('\n')}\n\n`; }
+        if (r.buttons?.length) {
+            out += `--- BUTTONS (${r.buttons.length}) ---\n`;
+            r.buttons.forEach(b => { out += `  [${b.id}] "${b.text}" -> ${b.url || '(no url)'}${b.css_class ? ` .${b.css_class}` : ''}\n`; });
+            out += '\n';
+        }
+        if (r.sections?.length) {
+            out += `--- SECTIONS (${r.sections.length}) ---\n`;
+            r.sections.forEach((s, i) => {
+                out += `\n[${i + 1}] ${s.title || s.id}${s.css_class ? ` .${s.css_class}` : ''}\n`;
+                (s.text_blocks || []).forEach(t => { const tr = t.trim(); if (tr) out += `  ${tr.slice(0, 200)}${tr.length > 200 ? '...' : ''}\n`; });
+            });
+            out += '\n';
+        }
+        if (r.images?.length) { out += `--- IMAGES ---\n${r.images.map(i => `  ${i.url} (alt: ${i.alt || '-'})`).join('\n')}\n\n`; }
+        if (r.links?.length) { out += `--- LINKS ---\n${r.links.map(l => `  "${l.text}" -> ${l.url}${l.type ? ` [${l.type}]` : ''}`).join('\n')}\n\n`; }
+        out += `--- FULL TEXT ---\n${r.all_text}`;
+        return ok(out);
+    }
+
+    case 'import_template': {
+        const r = await apiCall(`/pages/${args.page_id}/import`, 'POST', { template: args.template, mode: args.mode || 'replace' });
+        return ok(r.success ? `Imported!\n${r.sections} sections, ${r.total_elements} elements (${r.mode})\n\n${r.preview_url}` : `Error: ${r.message}`);
+    }
+
+    case 'get_component_presets': {
+        const r = await apiCall('/component-presets');
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        if (!r.presets?.length) return ok('No components with style schemas found.');
+        let out = `=== COMPONENT STYLE PRESETS (${r.count}) ===\n\n`;
+        r.presets.forEach(p => {
+            out += `--- ${p.name} (${p.component_id}) ---\n`;
+            Object.entries(p.style_schema).forEach(([key, def]) => {
+                const saved = p.saved[key] || '';
+                const resolved = p.resolved[key] || '';
+                const source = saved ? 'custom' : (def.default_token ? `token:${def.default_token}` : 'default');
+                out += `  ${key}: ${resolved} [${source}]\n`;
+            });
+            out += '\n';
+        });
+        return ok(out);
+    }
+
+    case 'set_component_presets': {
+        const r = await apiCall('/component-presets', 'POST', {
+            component_id: args.component_id,
+            presets: args.presets
+        });
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(r.message);
+    }
+
+    case 'list_components': {
+        const r = await apiCall('/components');
+        if (!r.success || !r.components) {
+            return ok(`Failed to list components: ${r.message || 'Unknown error'}`);
+        }
+        let out = `${r.count} Design Components Available\n\n`;
+        const grouped = {};
+        r.components.forEach(c => {
+            if (!grouped[c.category]) grouped[c.category] = [];
+            grouped[c.category].push(c);
+        });
+        Object.entries(grouped).forEach(([category, items]) => {
+            out += `--- ${category.toUpperCase()} (${items.length}) ---\n`;
+            items.forEach(item => {
+                out += `  - ${item.name}\n    ${item.meta.description}\n`;
+                if (item.meta.variables?.length) {
+                    out += `    Variables: ${item.meta.variables.map(v => v.name).join(', ')}\n`;
+                }
+                if (item.meta.style_schema) {
+                    out += `    Customizable styles: ${Object.keys(item.meta.style_schema).join(', ')}\n`;
+                }
+                if (item.meta.post_placement_instructions) {
+                    out += `    NOTE: ${item.meta.post_placement_instructions}\n`;
+                }
+            });
+            out += '\n';
+        });
+        return ok(out);
+    }
+
+    case 'add_component': {
+        const r = await apiCall(`/pages/${args.page_id}/add-component`, 'POST', {
+            category: args.category,
+            name: args.name,
+            variables: args.variables || {},
+            position: args.position || 'append'
+        });
+        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}`;
+        if (r.post_placement_instructions) msg += `\n\nACTION REQUIRED: ${r.post_placement_instructions}`;
+        return ok(msg);
+    }
+
+    case 'build_page': {
+        const r = await apiCall(`/pages/${args.page_id}/build`, 'POST', {
+            sections: args.sections,
+            mode: args.mode || 'replace'
+        });
+        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) {
+            buildMsg += '\n\nACTION REQUIRED:\n' + r.post_placement_instructions.map(i => `- ${i}`).join('\n');
+        }
+        return ok(buildMsg);
+    }
+
+    case 'list_sections': {
+        const r = await apiCall(`/pages/${args.page_id}/extract`);
+        if (r.error) return ok(`Failed: ${r.message || r.error}`);
+        const sections = r.sections || [];
+        if (!sections.length) return ok('Page has no sections.');
+        let msg = `Page ${args.page_id}: ${sections.length} sections\n${'─'.repeat(40)}\n`;
+        sections.forEach((s, i) => {
+            const cls = s.css_class || s.css_classes || '';
+            const heading = s.first_heading || s.heading || '';
+            const widgets = s.widget_count || s.widgets || '?';
+            msg += `[${i}] ${cls || s.id || '(no class)'} — ${heading || '(no heading)'} (${widgets} widgets)\n`;
+        });
+        return ok(msg);
+    }
+
+    case 'remove_section': {
+        const body = {};
+        if (args.index !== undefined) body.index = args.index;
+        if (args.section_id) body.section_id = args.section_id;
+        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}`);
+    }
+
+    case 'reorder_sections': {
+        const body = {};
+        if (args.move) body.move = args.move;
+        else if (args.swap) body.swap = args.swap;
+        else if (args.order) body.order = args.order;
+        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`;
+        if (r.section_order) {
+            r.section_order.forEach((s, i) => {
+                msg += `[${i}] ${s.css_class || s.id || '(no class)'}\n`;
+            });
+        }
+        return ok(msg);
+    }
+
+    case 'list_elements': {
+        const params = new URLSearchParams();
+        if (args.section_index !== undefined) params.set('section_index', args.section_index);
+        if (args.depth !== undefined) params.set('depth', args.depth);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/pages/${args.page_id}/elements${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        function formatTree(el, indent) {
+            let line = '  '.repeat(indent);
+            if (el.type === 'widget') {
+                line += `[${el.widget}] id:${el.id}`;
+                if (el.text) line += ` — "${el.text}"`;
+                if (el.image) line += ` — img:${el.image}`;
+                if (el.items) line += ` — ${el.items} items`;
+            } else {
+                line += `<${el.type}> id:${el.id}`;
+            }
+            if (el.css_class) line += ` .${el.css_class}`;
+            if (el.label) line += ` "${el.label}"`;
+            let result = line + '\n';
+            if (el.children) {
+                el.children.forEach(c => { result += formatTree(c, indent + 1); });
+            } else if (el.children_count) {
+                result += '  '.repeat(indent + 1) + `(${el.children_count} children, increase depth to see)\n`;
+            }
+            return result;
+        }
+
+        let msg = `Page ${args.page_id}: ${r.total_sections} sections\n${'─'.repeat(50)}\n`;
+        r.elements.forEach((el, i) => {
+            if (args.section_index === undefined) msg += `\n── Section [${i}] ──\n`;
+            msg += formatTree(el, 0);
+        });
+        return ok(msg);
+    }
+
+    case 'remove_element': {
+        const r = await apiCall(`/pages/${args.page_id}/remove-element`, 'POST', {
+            element_id: args.element_id
+        });
+        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 'update_element': {
+        // Resolve settings: prefer settings_json (string) for reliable MCP transport, fall back to settings (object)
+        let settings = null;
+        if (args.settings_json) {
+            try { settings = JSON.parse(stripCDATA(args.settings_json)); } catch (e) {
+                return ok(`Failed: settings_json is not valid JSON: ${e.message}`);
+            }
+        } else if (args.settings && typeof args.settings === 'object' && Object.keys(args.settings).length > 0) {
+            settings = args.settings;
+        } else if (args.settings && typeof args.settings === 'string') {
+            try { settings = JSON.parse(stripCDATA(args.settings)); } catch (e) {
+                return ok(`Failed: settings string is not valid JSON: ${e.message}`);
+            }
+        }
+        if (!settings || Object.keys(settings).length === 0) {
+            return ok(`Failed: No settings provided. Use settings_json (preferred) or settings parameter.\nReceived args keys: ${Object.keys(args).join(', ')}`);
+        }
+        const cleanSettings = deepStripCDATA(settings);
+        try {
+            const r = await apiCall(`/pages/${args.page_id}/update-element`, 'POST', {
+                element_id: args.element_id,
+                settings: cleanSettings
+            });
+            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) {
+            return ok(`Failed: ${err.message}`);
+        }
+    }
+
+    case 'audit_links': {
+        const params = new URLSearchParams();
+        if (args.page_id) params.set('page_id', args.page_id);
+        if (args.include_templates) params.set('include_templates', '1');
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/audit-links${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        let msg = `=== LINK AUDIT ===\nPages scanned: ${r.pages_scanned}\nPages with issues: ${r.pages_with_issues}\nTotal issues: ${r.total_issues}\n`;
+
+        if (r.total_issues === 0) {
+            msg += '\nAll links have correct targets!';
+        } else {
+            r.results.forEach(page => {
+                msg += `\n--- ${page.title} (ID: ${page.page_id}, ${page.status}) — ${page.issue_count} issues ---\n`;
+                page.issues.forEach(issue => {
+                    msg += `  [${issue.widget}] ${issue.field}: ${issue.url}\n    ${issue.problem}\n`;
+                });
+            });
+        }
+        return ok(msg);
+    }
+
+    case 'fix_links': {
+        const body = {};
+        if (args.page_id) body.page_id = args.page_id;
+        if (parseBool(args.dry_run)) body.dry_run = true;
+        if (parseBool(args.include_templates)) body.include_templates = true;
+        const r = await apiCall('/fix-links', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        const mode = r.dry_run ? 'DRY RUN' : 'APPLIED';
+        let msg = `=== LINK FIX (${mode}) ===\nPages scanned: ${r.pages_scanned}\nPages fixed: ${r.pages_fixed}\nTotal fixes: ${r.total_fixes}\n`;
+
+        if (r.total_fixes === 0) {
+            msg += '\nNo fixes needed — all links are correct!';
+        } else {
+            r.results.forEach(page => {
+                msg += `\n--- ${page.title} (ID: ${page.page_id}) — ${page.fix_count} fixes ---\n`;
+                page.fixes.forEach(fix => {
+                    msg += `  [${fix.widget}] ${fix.field}: ${fix.url}\n    ${fix.action}\n`;
+                });
+            });
+            if (r.dry_run) msg += '\n(Dry run — no changes were made. Run again with dry_run=false to apply.)';
+        }
+        return ok(msg);
+    }
+
+    case 'export_page': {
+        const r = await apiCall(`/pages/${args.page_id}/export`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        let msg = `=== PAGE EXPORT ===\n`;
+        msg += `ID: ${r.page_id} | Title: ${r.title} | Slug: ${r.slug}\n`;
+        msg += `Status: ${r.status} | Template: ${r.template}\n`;
+        msg += `Sections: ${r.section_count} | Elements: ${r.element_count}\n\n`;
+        const jsonStr = JSON.stringify(r.elementor_data, null, 2);
+        if (jsonStr.length > 200000) {
+            msg += `--- ELEMENTOR DATA (truncated, ${Math.round(jsonStr.length / 1024)}KB total) ---\n`;
+            msg += jsonStr.substring(0, 200000) + '\n\n... (truncated — use REST API directly for full data)';
+        } else {
+            msg += `--- ELEMENTOR DATA (JSON) ---\n` + jsonStr;
+        }
+        return ok(msg);
+    }
+
+    case 'audit_images': {
+        if (args.fix) {
+            // POST mode: fix missing alt text
+            const body = { dry_run: parseBool(args.dry_run, false) };
+            if (args.page_id) body.page_id = args.page_id;
+            const r = await apiCall('/audit-images', 'POST', body);
+            if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+            const mode = r.dry_run ? 'DRY RUN' : 'APPLIED';
+            let msg = `=== IMAGE FIX (${mode}) ===\nPages scanned: ${r.pages_scanned}\nPages fixed: ${r.pages_fixed}\nTotal fixes: ${r.total_fixes}\n`;
+
+            if (r.total_fixes === 0) {
+                msg += '\nNo fixes needed — all images have alt text!';
+            } else {
+                r.results.forEach(page => {
+                    msg += `\n--- ${page.title} (ID: ${page.page_id}) — ${page.fix_count} fixes ---\n`;
+                    page.fixes.forEach(fix => {
+                        msg += `  [${fix.widget}] ${fix.url}\n    ${fix.action}\n`;
+                    });
+                });
+                if (r.dry_run) msg += '\n(Dry run — no changes saved. Set dry_run=false to apply.)';
+            }
+            return ok(msg);
+        } else {
+            // GET mode: audit only
+            const params = new URLSearchParams();
+            if (args.page_id) params.set('page_id', args.page_id);
+            if (args.deep) params.set('deep', '1');
+            const qs = params.toString() ? `?${params.toString()}` : '';
+            const r = await apiCall(`/audit-images${qs}`);
+            if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+            let msg = `=== IMAGE AUDIT${args.deep ? ' (DEEP)' : ''} ===\nPages scanned: ${r.pages_scanned}\nPages with issues: ${r.pages_with_issues}\nTotal issues: ${r.total_issues}\n`;
+
+            if (r.image_summary) {
+                const s = r.image_summary;
+                msg += `\n--- Image Summary ---\nTotal images: ${s.total_images}\nTotal size: ${s.total_size_kb} KB\nNon-WebP: ${s.non_webp_count}\nFormats: ${Object.entries(s.formats).map(([k,v]) => `${k}=${v}`).join(', ')}\n`;
+            }
+
+            if (r.total_issues === 0) {
+                msg += '\nAll images pass checks!';
+            } else {
+                r.results.forEach(page => {
+                    msg += `\n--- ${page.title} (ID: ${page.page_id}) — ${page.issue_count} issues ---\n`;
+                    page.issues.forEach(issue => {
+                        if (issue.issue === 'non_webp_format') {
+                            msg += `  [${issue.widget}] non-WebP (${issue.format}): ${issue.url}\n`;
+                        } else if (issue.issue === 'large_file') {
+                            msg += `  [${issue.widget}] large file (${issue.size_kb} KB): ${issue.url}\n`;
+                        } else if (issue.issue === 'oversized_dimensions') {
+                            msg += `  [${issue.widget}] oversized (${issue.width}x${issue.height}): ${issue.url}\n`;
+                        } else {
+                            msg += `  [${issue.widget}] ${issue.issue}: ${issue.url || '(empty URL)'}\n`;
+                            if (issue.suggested_alt) msg += `    Suggested alt: "${issue.suggested_alt}"\n`;
+                        }
+                    });
+                });
+            }
+            return ok(msg);
+        }
+    }
+
+    case 'find_replace': {
+        const body = {
+            search: stripCDATA(args.search),
+            replace: stripCDATA(args.replace),
+            regex: parseBool(args.regex, false),
+            dry_run: parseBool(args.dry_run, true), // default TRUE (safe)
+        };
+        if (args.page_id) body.page_id = args.page_id;
+        const r = await apiCall('/find-replace', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        const mode = r.dry_run ? 'DRY RUN' : 'APPLIED';
+        let msg = `=== FIND & REPLACE (${mode}) ===\n`;
+        msg += `Search: "${r.search}" → Replace: "${r.replace}"${r.regex ? ' (regex)' : ''}\n`;
+        msg += `Pages scanned: ${r.pages_scanned} | Pages changed: ${r.pages_changed} | Total replacements: ${r.total_changes}\n`;
+
+        if (r.total_changes === 0) {
+            msg += '\nNo matches found.';
+        } else {
+            r.results.forEach(page => {
+                msg += `\n--- ${page.title} (ID: ${page.page_id}) — ${page.change_count} changes ---\n`;
+                page.changes.forEach(c => {
+                    msg += `  [${c.widget}] ${c.field}: "${c.old}" → "${c.new}"\n`;
+                });
+            });
+            if (r.dry_run) msg += '\n(Dry run — no changes saved. Set dry_run=false to apply.)';
+        }
+        return ok(msg);
+    }
+
+    case 'copy_element': {
+        const r = await apiCall('/copy-element', 'POST', {
+            source_page_id: args.source_page_id,
+            element_id: args.element_id,
+            target_page_id: args.target_page_id,
+            position: args.position || 'append',
+        });
+        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}`;
+        if (r.widget_type) msg += ` / ${r.widget_type}`;
+        msg += `)\n`;
+        msg += `Target: page ${r.target_page_id}, new ID: ${r.new_id}\n`;
+        msg += `Position: ${r.position}\n`;
+        msg += `Target now has ${r.target_sections} sections`;
+        return ok(msg);
+    }
+
+    case 'check_links': {
+        const params = new URLSearchParams();
+        if (args.page_id) params.set('page_id', args.page_id);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/check-links${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        let msg = `=== BROKEN LINK CHECK ===\n`;
+        msg += `URLs checked: ${r.urls_checked} | Broken: ${r.broken_count} | Pages scanned: ${r.pages_scanned}\n`;
+
+        if (r.broken_count === 0) {
+            msg += '\nAll links are working!';
+        } else {
+            r.broken_links.forEach(link => {
+                msg += `\n${link.status_code || 'ERR'} ${link.url}\n`;
+                msg += `  Status: ${link.message}\n`;
+                msg += `  Found on:\n`;
+                link.found_on.forEach(loc => {
+                    msg += `    - "${loc.page_title}" (ID: ${loc.page_id}), [${loc.widget}] ${loc.field}\n`;
+                });
+            });
+        }
+        return ok(msg);
+    }
+
+    // ── Posts CRUD ──
+
+    case 'list_posts': {
+        const params = new URLSearchParams();
+        if (args.post_type) params.set('post_type', args.post_type);
+        if (args.status) params.set('status', args.status);
+        if (args.search) params.set('search', args.search);
+        if (args.per_page) params.set('per_page', args.per_page);
+        if (args.page) params.set('page', args.page);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/posts${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `${r.total} posts found (page ${r.page}/${r.pages})\n${'─'.repeat(50)}\n`;
+        r.posts.forEach(p => {
+            out += `[${p.id}] ${p.title}\n`;
+            out += `    Type: ${p.type} | Status: ${p.status} | Editor: ${p.editor}\n`;
+            out += `    Modified: ${p.modified} | Author: ${p.author}\n`;
+            if (p.featured_image) out += `    Image: ${p.featured_image}\n`;
+            out += `    URL: ${p.url}\n\n`;
+        });
+        return ok(out);
+    }
+
+    case 'get_post': {
+        const r = await apiCall(`/posts/${args.post_id}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Not found'}`);
+        let out = `=== ${r.title} ===\n`;
+        out += `ID: ${r.id} | Type: ${r.type} | Status: ${r.status} | Editor: ${r.editor}\n`;
+        out += `Slug: ${r.slug}\nURL: ${r.url}\n`;
+        out += `Author: ${r.author} | Created: ${r.date} | Modified: ${r.modified}\n`;
+        if (r.elementor_sections) out += `Elementor sections: ${r.elementor_sections}\n`;
+        if (r.featured_image) out += `Featured image: ${r.featured_image.url} (alt: "${r.featured_image.alt || ''}")\n`;
+        if (r.excerpt) out += `\nExcerpt: ${r.excerpt}\n`;
+        if (r.taxonomies && Object.keys(r.taxonomies).length) {
+            out += '\n--- TAXONOMIES ---\n';
+            for (const [tax, terms] of Object.entries(r.taxonomies)) {
+                out += `  ${tax}: ${terms.map(t => `${t.name} (${t.id})`).join(', ')}\n`;
+            }
+        }
+        if (r.seo) {
+            out += '\n--- SEO (RankMath) ---\n';
+            for (const [k, v] of Object.entries(r.seo)) {
+                out += `  ${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}\n`;
+            }
+        }
+        if (r.content) {
+            const preview = r.content.length > 500 ? r.content.slice(0, 500) + '...' : r.content;
+            out += `\n--- CONTENT (${r.content_length} chars) ---\n${preview}\n`;
+        }
+        return ok(out);
+    }
+
+    case 'create_post': {
+        const body = { title: args.title };
+        if (args.post_type) body.post_type = args.post_type;
+        if (args.content) body.content = args.content;
+        if (args.excerpt) body.excerpt = args.excerpt;
+        if (args.status) body.status = args.status;
+        if (args.slug) body.slug = args.slug;
+        if (args.taxonomies) body.taxonomies = args.taxonomies;
+        if (args.featured_image_id) body.featured_image_id = args.featured_image_id;
+        if (args.elementor) body.elementor = args.elementor;
+        if (args.seo) body.seo = args.seo;
+        const r = await apiCall('/posts', 'POST', body);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(`Post created!\nID: ${r.id} | Type: ${r.type} | Status: ${r.status}\nTitle: ${r.title}\nSlug: ${r.slug}\nURL: ${r.url}\nEdit: ${r.edit_url}`);
+    }
+
+    case 'update_post': {
+        const { post_id, ...fields } = args;
+        const r = await apiCall(`/posts/${post_id}`, 'PUT', fields);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(`Post updated!\nID: ${r.id} | Status: ${r.status}\nTitle: ${r.title}\nUpdated: ${r.updated_fields.join(', ')}\nURL: ${r.url}`);
+    }
+
+    case 'delete_post': {
+        const qs = args.force ? '?force=true' : '';
+        const r = await apiCall(`/posts/${args.post_id}${qs}`, 'DELETE');
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(`${r.action === 'permanently_deleted' ? 'PERMANENTLY DELETED' : 'Trashed'}: [${r.id}] ${r.title}`);
+    }
+
+    // ── RankMath SEO ──
+
+    case 'get_seo': {
+        const r = await apiCall(`/posts/${args.post_id}/seo`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Not found'}`);
+        let out = `=== SEO: ${r.title} ===\nID: ${r.id} | URL: ${r.url}\n\n`;
+        if (!r.seo) {
+            out += 'No RankMath SEO data found for this post.';
+        } else {
+            for (const [k, v] of Object.entries(r.seo)) {
+                out += `  ${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}\n`;
+            }
+        }
+        return ok(out);
+    }
+
+    case 'update_seo': {
+        const { post_id, ...seoFields } = args;
+        const r = await apiCall(`/posts/${post_id}/seo`, 'POST', seoFields);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `SEO updated for post ${r.id}!\nFields changed: ${r.updated_fields.join(', ')}\n\n--- Current SEO ---\n`;
+        if (r.seo) {
+            for (const [k, v] of Object.entries(r.seo)) {
+                out += `  ${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}\n`;
+            }
+        }
+        return ok(out);
+    }
+
+    case 'audit_seo': {
+        const params = new URLSearchParams();
+        if (args.post_type) params.set('post_type', args.post_type);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/audit-seo${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `=== SEO AUDIT ===\n`;
+        out += `Total published: ${r.summary.total_posts}\n`;
+        out += `Missing SEO title: ${r.summary.missing_seo_title}\n`;
+        out += `Missing description: ${r.summary.missing_description}\n`;
+        out += `Missing focus keyword: ${r.summary.missing_focus_kw}\n`;
+        out += `Low score (<50): ${r.summary.low_score}\n`;
+        out += `Noindex pages: ${r.summary.noindex_pages}\n`;
+        if (r.issues.length) {
+            out += `\n--- ISSUES (${r.issues.length} posts) ---\n`;
+            r.issues.forEach(p => {
+                out += `  [${p.id}] ${p.title} (${p.type})`;
+                if (p.score) out += ` — score: ${p.score}`;
+                out += `\n    Issues: ${p.issues.join(', ')}\n`;
+            });
+        } else {
+            out += '\nNo issues found — all content has complete SEO data!';
+        }
+        return ok(out);
+    }
+
+    // ── Taxonomies ──
+
+    case 'list_taxonomies': {
+        const params = new URLSearchParams();
+        if (args.post_type) params.set('post_type', args.post_type);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/taxonomies${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `${r.count} Taxonomies\n${'─'.repeat(40)}\n`;
+        r.taxonomies.forEach(tax => {
+            out += `\n${tax.name} (${tax.slug}) — ${tax.term_count} terms`;
+            out += tax.hierarchical ? ' [hierarchical]' : ' [flat]';
+            out += `\n  Post types: ${tax.post_types.join(', ')}\n`;
+            if (tax.terms.length) {
+                tax.terms.forEach(t => {
+                    out += `    [${t.id}] ${t.name} (${t.count} posts)${t.parent ? ` ← parent:${t.parent}` : ''}\n`;
+                });
+            }
+        });
+        return ok(out);
+    }
+
+    case 'set_post_terms': {
+        const r = await apiCall(`/posts/${args.post_id}/terms`, 'POST', {
+            taxonomy: args.taxonomy,
+            terms: args.terms,
+            append: args.append || false,
+        });
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        const termNames = r.terms.map(t => `${t.name} (${t.id})`).join(', ');
+        return ok(`Terms set on post ${r.id}!\nTaxonomy: ${r.taxonomy}\nMode: ${r.append ? 'append' : 'replace'}\nCurrent terms: ${termNames}`);
+    }
+
+    // ── Revisions ──
+
+    case 'list_revisions': {
+        const r = await apiCall(`/posts/${args.post_id}/revisions`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `Revisions for "${r.post_title}" (${r.post_type} #${r.post_id})\n`;
+        out += `Total: ${r.total} revisions\n\n`;
+        if (r.revisions.length === 0) {
+            out += 'No revisions found.';
+        } else {
+            out += 'ID      | Date                | Author          | Elementor | Sections | Widgets\n';
+            out += '--------|---------------------|-----------------|-----------|----------|--------\n';
+            for (const rev of r.revisions) {
+                const date = rev.date.replace('T', ' ').substring(0, 19);
+                out += `${String(rev.id).padEnd(8)}| ${date} | ${rev.author.padEnd(16)}| ${rev.has_elementor ? 'Yes' : 'No '.padEnd(10)}| ${String(rev.sections).padEnd(9)}| ${rev.widgets}\n`;
+            }
+        }
+        return ok(out);
+    }
+
+    case 'restore_revision': {
+        const r = await apiCall(`/posts/${args.post_id}/revisions/${args.revision_id}/restore`, 'POST');
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(
+            `Revision restored!\n\n` +
+            `Post: #${r.post_id}\n` +
+            `Revision: #${r.revision_id} (${r.revision_date})\n` +
+            `Widgets: ${r.widgets_before} → ${r.widgets_after}\n` +
+            `Sections: ${r.sections_after}`
+        );
+    }
+
+    // ── Elementor Library Templates ──
+
+    case 'list_templates': {
+        const qs = args.type ? `?type=${encodeURIComponent(args.type)}` : '';
+        const r = await apiCall(`/templates${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `Elementor Library Templates (${r.total} total)\n\n`;
+        if (r.templates.length === 0) {
+            out += 'No templates found.';
+        } else {
+            out += 'ID    | Type      | Widgets | Title\n';
+            out += '------|-----------|---------|------\n';
+            for (const t of r.templates) {
+                out += `${String(t.id).padEnd(6)}| ${(t.template_type || '').padEnd(10)}| ${String(t.widgets).padEnd(8)}| ${t.title}\n`;
+            }
+        }
+        return ok(out);
+    }
+
+    case 'get_template': {
+        const r = await apiCall(`/templates/${args.template_id}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `Template: "${r.title}" (#${r.id})\n`;
+        out += `Type: ${r.template_type}\n`;
+        out += `Sections: ${r.sections} | Widgets: ${r.widgets}\n`;
+        if (r.conditions && r.conditions.length) {
+            out += `Conditions: ${JSON.stringify(r.conditions)}\n`;
+        }
+        out += `\n--- Element Tree ---\n`;
+        for (const node of r.tree) {
+            const indent = '  '.repeat(node.depth);
+            let label = `${indent}${node.type}:${node.id}`;
+            if (node.title) label += ` title="${node.title}"`;
+            if (node.text) label += ` text="${node.text}"`;
+            if (node.editor) label += ` editor="${node.editor}"`;
+            if (node.link) label += ` link=${node.link}`;
+            if (node.items) label += ` items=${node.items}`;
+            if (node.menu_items) label += ` menu_items=${node.menu_items}`;
+            if (node.css_classes) label += ` class="${node.css_classes}"`;
+            out += label + '\n';
+        }
+        return ok(out);
+    }
+
+    case 'update_template': {
+        const r = await apiCall(`/templates/${args.template_id}`, 'POST', {
+            elementor_data: args.elementor_data,
+        });
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        return ok(
+            `Template updated!\n\n` +
+            `Template: "${r.title}" (#${r.id})\n` +
+            `Widgets: ${r.widgets_before} → ${r.widgets_after}\n` +
+            `Sections: ${r.sections}`
+        );
+    }
+
+    case 'audit_placeholders': {
+        const qs = args.include_templates ? '?include_templates=1' : '';
+        const r = await apiCall(`/audit-placeholders${qs}`);
+        const s = r.summary;
+        let out = `=== PLACEHOLDER AUDIT ===\nScanned: ${s.pages_scanned} | Issues: ${s.pages_with_issues} | Placeholders: ${s.total_placeholders} | Empty sections: ${s.total_empty_sections}\n\n`;
+        if (!r.pages?.length) { out += 'No issues found!'; return ok(out); }
+        for (const p of r.pages) {
+            out += `--- [${p.id}] "${p.title}" (${p.type}) ---\n`;
+            if (p.placeholders?.length) {
+                out += `  Placeholders:\n`;
+                p.placeholders.forEach(ph => { out += `    [${ph.id}] ${ph.widget}: "${ph.text}"\n`; });
+            }
+            if (p.empty_sections?.length) {
+                out += `  Empty sections:\n`;
+                p.empty_sections.forEach(es => { out += `    [${es.id}] ${es.title || '(untitled)'}\n`; });
+            }
+            if (p.broken_anchors?.length) {
+                out += `  Broken anchors:\n`;
+                p.broken_anchors.forEach(ba => { out += `    "${ba.text}" -> ${ba.url || '(empty)'}\n`; });
+            }
+            out += '\n';
+        }
+        return ok(out);
+    }
+
+    case 'audit_ctas': {
+        const params = new URLSearchParams();
+        if (args.min_buttons) params.set('min_buttons', args.min_buttons);
+        if (args.include_templates) params.set('include_templates', '1');
+        const qs = params.toString() ? `?${params}` : '';
+        const r = await apiCall(`/audit-ctas${qs}`);
+        const s = r.summary;
+        let out = `=== CTA AUDIT ===\nScanned: ${s.pages_scanned} | Total buttons: ${s.total_buttons} | Below minimum (${s.min_threshold}): ${s.pages_below_min}\n\n`;
+        for (const p of r.pages) {
+            const flag = p.issues?.length ? '⚠' : '✓';
+            out += `${flag} [${p.id}] "${p.title}" — ${p.button_count} buttons, ${p.sections} sections\n`;
+            if (p.issues?.length) {
+                p.issues.forEach(issue => { out += `    ⚠ ${issue}\n`; });
+            }
+            if (p.buttons?.length) {
+                p.buttons.forEach(b => { out += `    "${b.text}" -> ${b.url || '(no url)'}${b.css_class ? ` .${b.css_class}` : ''}\n`; });
+            }
+            out += '\n';
+        }
+        return ok(out);
+    }
+
+    case 'audit_clickable': {
+        const params = new URLSearchParams();
+        if (args.target_id) params.set('page_id', args.target_id);
+        if (parseBool(args.include_templates)) params.set('include_templates', '1');
+        const qs = params.toString() ? `?${params}` : '';
+        const r = await apiCall(`/audit-clickable${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        let out = `=== CLICKABLE CONTENT AUDIT ===\nPages scanned: ${r.pages_scanned} | Pages with issues: ${r.pages_with_issues} | Total issues: ${r.total_issues}\n\n`;
+        if (r.results) {
+            for (const p of r.results) {
+                out += `── [${p.id}] "${p.title}" — ${p.issues.length} issue(s) ──\n`;
+                out += `   ${p.url}\n`;
+                for (const issue of p.issues) {
+                    out += `  ${issue.type.toUpperCase()}: "${issue.value}" in ${issue.widget} [${issue.element_id}]\n`;
+                    if (issue.fix) out += `    Fix: ${issue.fix}\n`;
+                }
+                out += '\n';
+            }
+        }
+        if (r.total_issues === 0) out += 'No unlinked phone numbers, emails, or URLs found.\n';
+        return ok(out);
+    }
+
+    // ── Element Operations (v3.6.0) ──
+
+    case 'add_element': {
+        const r = await apiCall(`/pages/${args.page_id}/add-element`, 'POST', {
+            parent_id: args.parent_id,
+            element: args.element,
+            position: args.position
+        });
+        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)'}`);
+    }
+
+    case 'get_element': {
+        const r = await apiCall(`/pages/${args.page_id}/get-element`, 'POST', {
+            element_id: args.element_id
+        });
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        let out = `=== Element: ${r.id} ===\nType: ${r.elType}`;
+        if (r.widgetType) out += ` (${r.widgetType})`;
+        out += '\n';
+        if (r.children_count !== undefined) {
+            out += `Children: ${r.children_count}\n`;
+            if (r.children?.length) {
+                r.children.forEach(c => {
+                    out += `  - ${c.id}: ${c.elType}${c.widgetType ? '/' + c.widgetType : ''}${c.title ? ' "' + c.title + '"' : ''}\n`;
+                });
+            }
+        }
+        out += `\nSettings:\n${JSON.stringify(r.settings, null, 2)}`;
+        return ok(out);
+    }
+
+    case 'batch_update_elements': {
+        // Resolve updates: prefer updates_json (string) for reliable MCP transport
+        let updates = [];
+        if (args.updates_json) {
+            try { updates = JSON.parse(stripCDATA(args.updates_json)); } catch (e) {
+                return ok(`Failed: updates_json is not valid JSON: ${e.message}`);
+            }
+        } else if (args.updates && Array.isArray(args.updates) && args.updates.length > 0) {
+            updates = args.updates;
+        } else if (args.updates && typeof args.updates === 'string') {
+            try { updates = JSON.parse(stripCDATA(args.updates)); } catch (e) {
+                return ok(`Failed: updates string is not valid JSON: ${e.message}`);
+            }
+        }
+        if (!Array.isArray(updates) || updates.length === 0) {
+            return ok(`Failed: No updates provided. Use updates_json (preferred) or updates parameter.\nReceived args keys: ${Object.keys(args).join(', ')}`);
+        }
+        // Strip CDATA from all settings values and ensure proper structure
+        const cleanUpdates = updates.map(u => {
+            let settings = u.settings || {};
+            if (typeof settings === 'string') {
+                try { settings = JSON.parse(settings); } catch (e) { settings = {}; }
+            }
+            return {
+                page_id: u.page_id,
+                element_id: u.element_id,
+                settings: deepStripCDATA(settings)
+            };
+        });
+        const r = await apiCall('/batch-update-elements', 'POST', {
+            updates: cleanUpdates
+        });
+        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) {
+            out += '\nFailed:\n';
+            r.results.filter(x => !x.success).forEach(x => {
+                out += `  [${x.index}] ${x.error}\n`;
+            });
+        }
+        return ok(out);
+    }
+
+    case 'manage_redirects': {
+        const r = await apiCall('/add-redirects', 'POST', {
+            action: args.action,
+            redirects: args.redirects,
+            ids: args.ids
+        });
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        if (args.action === 'create') {
+            let out = `=== Redirects Created ===\n`;
+            if (r.results) {
+                r.results.forEach(rr => {
+                    out += rr.success
+                        ? `  [OK] ${rr.source} -> ${rr.destination} (${rr.code})\n`
+                        : `  [ERR] ${rr.source}: ${rr.error}\n`;
+                });
+            }
+            out += `\nCreated: ${r.created || 0}`;
+            return ok(out);
+        } else if (args.action === 'list') {
+            let out = `=== RankMath Redirects (${r.total || 0}) ===\n`;
+            if (r.redirects?.length) {
+                r.redirects.forEach(rr => {
+                    out += `  [${rr.id}] ${rr.source} -> ${rr.destination} (${rr.code}) ${rr.status}\n`;
+                });
+            }
+            return ok(out);
+        } else if (args.action === 'delete') {
+            return ok(`Deleted ${r.deleted || 0} redirect(s).`);
+        }
+        return ok(JSON.stringify(r, null, 2));
+    }
+
+    // ── Performance Audit (v3.7.0) ──
+
+    case 'audit_page_weight': {
+        const params = new URLSearchParams();
+        if (args.page_id) params.set('page_id', args.page_id);
+        if (args.max_elements) params.set('max_elements', args.max_elements);
+        const qs = params.toString() ? `?${params}` : '';
+        const r = await apiCall(`/audit-page-weight${qs}`);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        const s = r.summary;
+        let out = `=== PAGE WEIGHT AUDIT ===\nPages scanned: ${s.pages_scanned}\nHeavy pages (>${s.threshold} elements): ${s.heavy_pages}\nTotal elements: ${s.total_elements}\nTotal images: ${s.total_images}\nAvg elements/page: ${s.avg_elements}\n`;
+
+        for (const p of r.pages) {
+            const flag = p.issues?.length ? '!!' : 'OK';
+            out += `\n[${flag}] "${p.title}" (ID: ${p.page_id})\n`;
+            out += `  Elements: ${p.total_elements} (${p.containers} containers, ${p.widgets} widgets)\n`;
+            out += `  Images: ${p.images} | Videos: ${p.videos} | Max depth: ${p.max_depth}\n`;
+            out += `  Est. DOM: ${p.estimated_dom} | JSON: ${p.json_size_kb} KB\n`;
+            if (Object.keys(p.widget_types).length) {
+                const top5 = Object.entries(p.widget_types).slice(0, 5).map(([k,v]) => `${k}(${v})`).join(', ');
+                out += `  Top widgets: ${top5}\n`;
+            }
+            if (p.issues?.length) {
+                p.issues.forEach(i => { out += `  ⚠ ${i}\n`; });
+            }
+        }
+        return ok(out);
+    }
+
+    case 'audit_page_speed': {
+        // Resolve URL: if page_id given, get permalink from WP
+        let testUrl = args.url;
+        if (!testUrl && args.page_id) {
+            const post = await apiCall(`/posts/${args.page_id}`);
+            testUrl = post?.url;
+        }
+        if (!testUrl) return ok('Failed: Provide url or page_id parameter');
+
+        const strategy = args.strategy || 'mobile';
+
+        // Call PageSpeed API directly from Node.js (avoids WP hosting timeout)
+        const psiUrl = `https://www.googleapis.com/pagespeedonline/v5/runPagespeed?` +
+            `url=${encodeURIComponent(testUrl)}&strategy=${strategy}&category=performance`;
+
+        console.error(`[PSI] Fetching ${strategy} score for ${testUrl}`);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 90000);
+
+        try {
+            const resp = await fetch(psiUrl, { signal: controller.signal });
+            clearTimeout(timeout);
+            if (!resp.ok) {
+                const err = await resp.json().catch(() => ({}));
+                return ok(`PageSpeed API error ${resp.status}: ${err?.error?.message || 'Unknown'}`);
+            }
+            const body = await resp.json();
+
+            const lighthouse = body.lighthouseResult || {};
+            const audits = lighthouse.audits || {};
+            const categories = lighthouse.categories || {};
+            const score = categories.performance?.score != null ? Math.round(categories.performance.score * 100) : null;
+
+            let out = `=== PAGESPEED INSIGHTS ===\nURL: ${testUrl}\nStrategy: ${strategy}\nScore: ${score}/100\n`;
+
+            // Core Web Vitals
+            const metricKeys = {
+                'first-contentful-paint': 'FCP',
+                'largest-contentful-paint': 'LCP',
+                'total-blocking-time': 'TBT',
+                'cumulative-layout-shift': 'CLS',
+                'speed-index': 'SI',
+                'interactive': 'TTI',
+            };
+            out += '\n--- Core Web Vitals ---\n';
+            for (const [key, label] of Object.entries(metricKeys)) {
+                if (audits[key]) {
+                    const a = audits[key];
+                    const s = a.score != null ? Math.round(a.score * 100) : null;
+                    const icon = s >= 90 ? 'GOOD' : s >= 50 ? 'NEEDS WORK' : 'POOR';
+                    out += `  ${label}: ${a.displayValue || 'N/A'} (${icon})\n`;
+                }
+            }
+
+            // Opportunities
+            const oppKeys = [
+                'render-blocking-resources', 'unused-css-rules', 'unused-javascript',
+                'modern-image-formats', 'uses-optimized-images', 'uses-responsive-images',
+                'offscreen-images', 'unminified-css', 'unminified-javascript',
+                'uses-text-compression', 'uses-long-cache-ttl', 'dom-size',
+                'redirects', 'server-response-time',
+            ];
+            const opps = [];
+            for (const key of oppKeys) {
+                if (audits[key] && (audits[key].score ?? 1) < 1) {
+                    const a = audits[key];
+                    const opp = { title: a.title || key, value: a.displayValue || '' };
+                    if (a.details?.overallSavingsMs) opp.savings_ms = Math.round(a.details.overallSavingsMs);
+                    if (a.details?.overallSavingsBytes) opp.savings_kb = Math.round(a.details.overallSavingsBytes / 1024);
+                    opps.push(opp);
+                }
+            }
+            opps.sort((a, b) => (b.savings_ms || 0) - (a.savings_ms || 0));
+
+            if (opps.length) {
+                out += '\n--- Opportunities ---\n';
+                opps.forEach(o => {
+                    out += `  ${o.title}`;
+                    if (o.savings_ms) out += ` — save ~${o.savings_ms}ms`;
+                    if (o.savings_kb) out += ` — save ~${o.savings_kb} KB`;
+                    out += '\n';
+                });
+            }
+
+            out += `\nFetched: ${new Date().toISOString()}`;
+            return ok(out);
+        } catch (e) {
+            clearTimeout(timeout);
+            return ok(`PageSpeed API failed: ${e.message}`);
+        }
+    }
+
+    case 'copy_section': {
+        const r = await apiCall('/copy-section', 'POST', {
+            source_id: args.source_id,
+            section_index: args.section_index,
+            target_id: args.target_id,
+            position: args.position || 'end',
+        });
+        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`;
+        msg += `Target: ID ${r.target_id}, new section ID: ${r.new_section_id}\n`;
+        msg += `Elements copied: ${r.elements_copied}\n`;
+        msg += `Target now has ${r.target_sections} sections\n`;
+        if (r.section_css_class) msg += `CSS class: ${r.section_css_class}\n`;
+        if (r.section_title) msg += `Title: ${r.section_title}`;
+        return ok(msg);
+    }
+
+    case 'append_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;
+        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`;
+        msg += `Target: ID ${r.target_id}\n`;
+        msg += `New section ID: ${r.new_section_id}\n`;
+        msg += `Elements added: ${r.elements_added}\n`;
+        msg += `Target now has ${r.target_sections} sections\n`;
+        if (r.section_css_class) msg += `CSS class: ${r.section_css_class}\n`;
+        if (r.section_title) msg += `Title: ${r.section_title}`;
+        return ok(msg);
+    }
+
+    // ── Template Library Tools ──
+
+    case 'template_list_kits': {
+        const catalog = getTemplateCatalog();
+        if (!catalog) return ok('Template library not configured.\nSet TEMPLATE_LIBRARY_DIR env var to the path containing section-catalog.json and the templates/ folder.');
+        let msg = `Template Library: ${catalog.stats.total_kits} kits, ${catalog.stats.total_pages} pages, ${catalog.stats.total_sections} sections\n\n`;
+        for (const [kitId, kit] of Object.entries(catalog.kits)) {
+            msg += `── ${kit.title} ──\n`;
+            msg += `  ID: ${kitId}\n`;
+            msg += `  Pages: ${kit.pages.length} | Sections: ${kit.section_count}\n`;
+            if (kit.design_tokens) {
+                const colors = (kit.design_tokens.colors || []).map(c => `${c.title || c._id}: ${c.color}`).join(', ');
+                const fonts = (kit.design_tokens.typography || []).map(t => t.typography_font_family).filter(Boolean).join(', ');
+                if (colors) msg += `  Colors: ${colors}\n`;
+                if (fonts) msg += `  Fonts: ${[...new Set(fonts.split(', '))].join(', ')}\n`;
+            }
+            msg += `  Pages: ${kit.pages.map(p => p.name).join(', ')}\n\n`;
+        }
+        msg += `Section types: ${Object.entries(catalog.stats.sections_by_type).sort((a,b) => b[1]-a[1]).map(([t,c]) => `${t}(${c})`).join(', ')}`;
+        return ok(msg);
+    }
+
+    case 'template_browse_sections': {
+        const catalog = getTemplateCatalog();
+        if (!catalog) return ok('Template library not configured. Set TEMPLATE_LIBRARY_DIR env var.');
+        let sections = catalog.sections;
+        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));
+        }
+        const limit = args.limit || 20;
+        const total = sections.length;
+        sections = sections.slice(0, limit);
+        let msg = `Found ${total} sections`;
+        if (total > limit) msg += ` (showing first ${limit})`;
+        msg += '\n\n';
+        for (const s of sections) {
+            msg += `── ${s.id} ──\n`;
+            msg += `  Kit: ${s.kit_title}\n`;
+            msg += `  Page: ${s.page_name} [section #${s.section_index}]\n`;
+            msg += `  Type: ${s.type} (confidence: ${s.confidence})`;
+            if (s.secondary_type) msg += ` | also: ${s.secondary_type}`;
+            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`;
+            if (s.features.background_color) msg += `  Background: ${s.features.background_color}\n`;
+            if (s.features.text_preview.length > 0) {
+                msg += `  Preview: ${s.features.text_preview[0]}\n`;
+            }
+            msg += '\n';
+        }
+        return ok(msg);
+    }
+
+    case 'template_get_section': {
+        const catalog = getTemplateCatalog();
+        if (!catalog) return ok('Template library not configured. Set TEMPLATE_LIBRARY_DIR env var.');
+        const parts = args.section_id.split('/');
+        if (parts.length !== 3) return ok('Invalid section_id format. Expected: kit-id/page-slug/section-index');
+        const [kitId, pageSlug, indexStr] = parts;
+        const sectionIndex = parseInt(indexStr);
+        // Find catalog entry for metadata
+        const catalogEntry = catalog.sections.find(s => s.id === args.section_id);
+        if (!catalogEntry) return ok(`Section not found in catalog: ${args.section_id}`);
+        // Load the actual section JSON
+        const section = loadTemplateSection(kitId, pageSlug, sectionIndex);
+        if (!section) return ok(`Could not load section JSON for: ${args.section_id}`);
+        let msg = `Section: ${args.section_id}\n`;
+        msg += `Type: ${catalogEntry.type} | Page: ${catalogEntry.page_name}\n`;
+        msg += `Elements: ${catalogEntry.features.total_elements}\n\n`;
+        msg += `--- SECTION JSON ---\n`;
+        msg += JSON.stringify(section, null, 2);
+        return ok(msg);
+    }
+
+    case 'template_map_content': {
+        const catalog = getTemplateCatalog();
+        if (!catalog) return ok('Template library not configured. Set TEMPLATE_LIBRARY_DIR env var.');
+        const blocks = parseContentBlocks(args.content);
+        if (blocks.length === 0) return ok('No content blocks found. Use ## headings to separate content blocks.');
+        const mapping = mapContentToSections(blocks, catalog, args.kit_id || null);
+        let msg = `Content Analysis: ${blocks.length} blocks detected\n`;
+        if (args.kit_id) msg += `Preferred kit: ${args.kit_id}\n`;
+        msg += '\n';
+        for (const m of mapping) {
+            msg += `═══ Block ${m.block_index}: "${m.heading || '(intro)'}"\n`;
+            msg += `  Detected type: ${m.detected_type} (confidence: ${m.confidence})\n`;
+            if (m.alternatives.length > 0) {
+                msg += `  Also possible: ${m.alternatives.map(a => `${a.type}(${a.score})`).join(', ')}\n`;
+            }
+            msg += `  Content: ${m.content_summary.items} items, ${m.content_summary.paragraphs} paragraphs`;
+            if (m.content_summary.stats > 0) msg += `, ${m.content_summary.stats} stats`;
+            if (m.content_summary.questions > 0) msg += `, ${m.content_summary.questions} questions`;
+            if (m.content_summary.has_cta) msg += `, has CTA`;
+            msg += '\n';
+            if (m.recommended_sections.length > 0) {
+                msg += `  Recommended sections:\n`;
+                for (let i = 0; i < m.recommended_sections.length; i++) {
+                    const r = m.recommended_sections[i];
+                    msg += `    ${i + 1}. ${r.id}\n`;
+                    msg += `       Kit: ${r.kit} | Page: ${r.page} | ${r.elements} elements, ${r.columns} cols\n`;
+                    if (r.preview) msg += `       Preview: ${r.preview.substring(0, 70)}\n`;
+                }
+            } else {
+                msg += `  No matching sections found in catalog.\n`;
+            }
+            msg += '\n';
+        }
+        // Summary table
+        msg += `═══ MAPPING SUMMARY ═══\n`;
+        msg += `Block | Type | Section ID\n`;
+        msg += `──────┼──────┼──────────\n`;
+        for (const m of mapping) {
+            const secId = m.recommended_sections[0]?.id || '(none)';
+            msg += `${String(m.block_index).padEnd(6)}| ${m.detected_type.padEnd(18)} | ${secId}\n`;
+        }
+        return ok(msg);
+    }
+
+    case 'template_get_tokens': {
+        const tokens = loadDesignTokens(args.kit_id);
+        if (!tokens) return ok(`Could not load design tokens for kit: ${args.kit_id}`);
+        let msg = `Design Tokens: ${args.kit_id}\n\n`;
+        msg += `── System Colors ──\n`;
+        for (const c of tokens.system_colors || []) {
+            msg += `  ${c._id} (${c.title || ''}): ${c.color}\n`;
+        }
+        msg += `\n── System Typography ──\n`;
+        for (const t of tokens.system_typography || []) {
+            msg += `  ${t._id} (${t.title || ''}): ${t.typography_font_family || ''} ${t.typography_font_weight || ''} ${t.typography_font_size?.size || ''}${t.typography_font_size?.unit || ''}\n`;
+        }
+        msg += `\n── Button Styles ──\n`;
+        for (const [k, v] of Object.entries(tokens)) {
+            if (k.startsWith('button_')) {
+                const val = typeof v === 'object' ? JSON.stringify(v) : v;
+                msg += `  ${k}: ${val}\n`;
+            }
+        }
+        // Also show custom colors/typography if present
+        if (tokens.custom_colors?.length) {
+            msg += `\n── Custom Colors (${tokens.custom_colors.length}) ──\n`;
+            for (const c of tokens.custom_colors) {
+                msg += `  ${c._id} (${c.title || ''}): ${c.color}\n`;
+            }
+        }
+        return ok(msg);
+    }
+
+    case 'template_rebrand': {
+        // Load the section JSON
+        let section = args.section_json || null;
+        if (!section && args.section_id) {
+            const parts = args.section_id.split('/');
+            if (parts.length !== 3) return ok('Invalid section_id format. Expected: kit-id/page-slug/section-index');
+            const [kitId, pageSlug, indexStr] = parts;
+            section = loadTemplateSection(kitId, pageSlug, parseInt(indexStr, 10));
+            if (!section) return ok(`Could not load section: ${args.section_id}`);
+        }
+        if (!section) return ok('Provide either section_id or section_json.');
+
+        // Load source kit tokens if auto_map_from_kit is provided
+        const sourceKitId = args.auto_map_from_kit || (args.section_id ? args.section_id.split('/')[0] : null);
+        const sourceTokens = sourceKitId ? loadDesignTokens(sourceKitId) : null;
+
+        // Build color map
+        const colorMap = buildColorMap(sourceTokens || { system_colors: [], custom_colors: [] }, args.colors || {});
+
+        // Build font map (direct key→value, no normalization needed)
+        const fontMap = args.fonts || {};
+
+        // Build globals map (direct key→value)
+        const globalsMap = args.globals || {};
+
+        // Build globals resolver from source kit tokens
+        const globalsResolver = buildGlobalsResolver(sourceTokens);
+
+        // Apply rebrand
+        const rebranded = rebrandSection(section, colorMap, fontMap, globalsMap, globalsResolver);
+
+        // Count replacements for summary
+        const origStr = JSON.stringify(section);
+        const rebStr = JSON.stringify(rebranded);
+        let colorChanges = 0;
+        for (const src of Object.keys(colorMap)) {
+            const regex = new RegExp(src.replace('#', '#'), 'gi');
+            const origMatches = origStr.match(regex) || [];
+            const rebMatches = rebStr.match(regex) || [];
+            colorChanges += origMatches.length - rebMatches.length;
+        }
+        let fontChanges = 0;
+        for (const src of Object.keys(fontMap)) {
+            const regex = new RegExp(src.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
+            const origMatches = origStr.match(regex) || [];
+            const rebMatches = rebStr.match(regex) || [];
+            fontChanges += origMatches.length - rebMatches.length;
+        }
+
+        // Count globals resolved (compare __globals__ refs before and after)
+        const origGlobals = (origStr.match(/"__globals__"/g) || []).length;
+        const rebGlobals = (rebStr.match(/globals\/colors\?id=|globals\/typography\?id=/g) || []).length;
+        const origGlobalRefs = (origStr.match(/globals\/colors\?id=|globals\/typography\?id=/g) || []).length;
+        const globalsResolved = origGlobalRefs - rebGlobals;
+
+        let msg = `Rebranded section successfully.\n\n`;
+        msg += `── Replacements ──\n`;
+        msg += `  Color mappings applied: ${Object.keys(colorMap).length}\n`;
+        msg += `  Font mappings applied: ${Object.keys(fontMap).length}\n`;
+        msg += `  Globals resolved to hardcoded: ${globalsResolved}\n`;
+        msg += `  Globals remaining (unresolved): ${rebGlobals}\n`;
+        msg += `  Estimated color replacements: ~${Math.abs(colorChanges)}\n`;
+        msg += `  Estimated font replacements: ~${Math.abs(fontChanges)}\n`;
+        msg += `  Output size: ${rebStr.length} chars\n\n`;
+        msg += `── Color Map ──\n`;
+        for (const [src, tgt] of Object.entries(colorMap)) {
+            msg += `  ${src} → ${tgt}\n`;
+        }
+        if (Object.keys(fontMap).length) {
+            msg += `\n── Font Map ──\n`;
+            for (const [src, tgt] of Object.entries(fontMap)) {
+                msg += `  ${src} → ${tgt}\n`;
+            }
+        }
+
+        return {
+            content: [
+                { type: 'text', text: msg },
+                { type: 'text', text: JSON.stringify(rebranded) }
+            ]
+        };
+    }
+
+    case 'template_inject_content': {
+        // Load section
+        let section = args.section_json || null;
+        if (!section && args.section_id) {
+            const parts = args.section_id.split('/');
+            if (parts.length !== 3) return ok('Invalid section_id format. Expected: kit-id/page-slug/section-index');
+            const [kitId, pageSlug, indexStr] = parts;
+            section = loadTemplateSection(kitId, pageSlug, parseInt(indexStr, 10));
+            if (!section) return ok(`Could not load section: ${args.section_id}`);
+        }
+        if (!section) return ok('Provide either section_id or section_json.');
+
+        const content = args.content || {};
+        const { section: injected, changes } = injectContent(section, content);
+
+        // Summarize what was injected
+        const slots = extractContentSlots(section);
+        let msg = `Content injected: ${changes} changes applied.\n\n`;
+        msg += `── Section Slots ──\n`;
+        const slotCounts = {};
+        for (const s of slots) { slotCounts[s.type] = (slotCounts[s.type] || 0) + 1; }
+        for (const [t, c] of Object.entries(slotCounts)) { msg += `  ${t}: ${c}\n`; }
+        msg += `\n── Content Provided ──\n`;
+        if (content.heading) msg += `  Heading: "${content.heading}"\n`;
+        if (content.subheading) msg += `  Subheading: "${content.subheading}"\n`;
+        if (content.paragraphs?.length) msg += `  Paragraphs: ${content.paragraphs.length}\n`;
+        if (content.items?.length) msg += `  Items: ${content.items.length}\n`;
+        if (content.stats?.length) msg += `  Stats: ${content.stats.length}\n`;
+        if (content.buttons?.length) msg += `  Buttons: ${content.buttons.length}\n`;
+        if (content.quotes?.length) msg += `  Quotes: ${content.quotes.length}\n`;
+        if (content.faq?.length) msg += `  FAQ: ${content.faq.length}\n`;
+
+        return {
+            content: [
+                { type: 'text', text: msg },
+                { type: 'text', text: JSON.stringify(injected) }
+            ]
+        };
+    }
+
+    case 'template_assemble_page': {
+        const catalog = getTemplateCatalog();
+        if (!catalog) return ok('Template library not configured. Set TEMPLATE_LIBRARY_DIR env var.');
+
+        const kitId = args.kit_id;
+        const sourceTokens = loadDesignTokens(kitId);
+
+        // Step 1: Parse content into blocks
+        const blocks = parseContentBlocks(args.content);
+        if (blocks.length === 0) return ok('No content blocks found. Use ## headings to separate sections.');
+
+        // Step 2: Map content to template sections
+        const mapping = mapContentToSections(blocks, catalog, kitId);
+
+        // Step 3: Build color/font maps
+        const colorMap = buildColorMap(sourceTokens || { system_colors: [], custom_colors: [] }, args.colors || {});
+        const fontMap = args.fonts || {};
+        const globalsMap = args.globals || {};
+        const globalsResolver = buildGlobalsResolver(sourceTokens);
+
+        // Step 4: Create the page
+        let pageId;
+        try {
+            const createBody = {
+                title: args.title,
+                status: args.status || 'draft',
+            };
+            if (args.slug) createBody.slug = args.slug;
+            const pageResult = await apiCall('/pages', 'POST', createBody);
+            pageId = pageResult.page_id || pageResult.id;
+            if (!pageId) return ok(`Failed to create page: ${JSON.stringify(pageResult)}`);
+        } catch (err) {
+            return ok(`Failed to create page: ${err.message}`);
+        }
+
+        // Reset icon replacement counter for each new page
+        _iconReplacementCounter = 0;
+
+        // Step 5: For each mapped block, load → rebrand → inject → append
+        const results = [];
+        let totalElements = 0;
+
+        for (const m of mapping) {
+            const bestSection = m.recommended_sections[0];
+            if (!bestSection) {
+                results.push({ block: m.block_index, heading: m.heading, status: 'skipped', reason: 'No matching template section' });
+                continue;
+            }
+
+            // Load section JSON
+            const parts = bestSection.id.split('/');
+            const sectionJson = loadTemplateSection(parts[0], parts[1], parseInt(parts[2], 10));
+            if (!sectionJson) {
+                results.push({ block: m.block_index, heading: m.heading, status: 'skipped', reason: `Could not load section: ${bestSection.id}` });
+                continue;
+            }
+
+            // Build per-section globals resolver from the section's actual source kit
+            const sectionKitId = parts[0];
+            const sectionTokens = sectionKitId === kitId ? sourceTokens : loadDesignTokens(sectionKitId);
+            const sectionGlobalsResolver = buildGlobalsResolver(sectionTokens);
+
+            // Build color map: start with user overrides, then auto-map source kit system colors
+            const sectionColorMap = buildColorMap(sectionTokens || { system_colors: [], custom_colors: [] }, args.colors || {});
+            // Auto-map cross-kit system colors → user's brand targets
+            if (sectionKitId !== kitId && sectionTokens) {
+                const userTargets = Object.values(args.colors || {}).map(normalizeHex).filter(Boolean);
+                const srcSystemColors = (sectionTokens.system_colors || [])
+                    .filter(c => c._id && c.color && c._id !== 'text')
+                    .map(c => normalizeHex(c.color)).filter(Boolean);
+                for (let ci = 0; ci < srcSystemColors.length && ci < userTargets.length; ci++) {
+                    if (!sectionColorMap[srcSystemColors[ci]]) {
+                        sectionColorMap[srcSystemColors[ci]] = userTargets[ci];
+                    }
+                }
+                // Also map custom colors (kit accent/highlight colors)
+                const srcCustomColors = (sectionTokens.custom_colors || [])
+                    .map(c => normalizeHex(c.color)).filter(Boolean);
+                for (let ci = 0; ci < srcCustomColors.length; ci++) {
+                    const targetIdx = Math.min(ci, userTargets.length - 1);
+                    if (targetIdx >= 0 && !sectionColorMap[srcCustomColors[ci]]) {
+                        sectionColorMap[srcCustomColors[ci]] = userTargets[targetIdx];
+                    }
+                }
+            }
+
+            // Rebrand
+            const rebranded = rebrandSection(sectionJson, sectionColorMap, fontMap, globalsMap, sectionGlobalsResolver);
+
+            // Structure content for injection
+            const block = blocks[m.block_index];
+            const structured = structureContentBlock(block);
+
+            // Debug: log structured content for FAQ blocks
+            if (m.detected_type === 'faq') {
+                console.error(`[FAQ-DEBUG] Block ${m.block_index} structured: faq=${structured.faq.length}, items=${structured.items.length}, buttons=${structured.buttons.length}`);
+                if (structured.faq.length > 0) console.error(`[FAQ-DEBUG] First Q: "${structured.faq[0].question}"`);
+                if (structured.items.length > 0) console.error(`[FAQ-DEBUG] First item: "${structured.items[0].title}"`);
+            }
+
+            // Inject content
+            const { section: final, changes } = injectContent(rebranded, structured);
+            if (m.detected_type === 'faq') {
+                console.error(`[FAQ-DEBUG] Injection changes: ${changes}`);
+                // Check if accordion items were modified
+                const accWidgets = [];
+                function findAccordions(el) {
+                    if (el.widgetType === 'nested-accordion') accWidgets.push(el);
+                    if (el.elements) el.elements.forEach(findAccordions);
+                }
+                findAccordions(final);
+                for (const aw of accWidgets) {
+                    console.error(`[FAQ-DEBUG] Accordion items: ${(aw.settings.items||[]).map(i=>i.item_title).join(' | ')}`);
+                }
+            }
+
+            // Append to page
+            try {
+                const appendResult = await apiCall('/append-section', 'POST', {
+                    target_id: pageId,
+                    section: final,
+                    position: 'end',
+                    regenerate_ids: true,
+                });
+                totalElements += appendResult.elements_added || 0;
+                results.push({
+                    block: m.block_index,
+                    heading: m.heading || '(intro)',
+                    type: m.detected_type,
+                    section_id: bestSection.id,
+                    status: 'appended',
+                    elements: appendResult.elements_added || 0,
+                });
+            } catch (err) {
+                results.push({
+                    block: m.block_index,
+                    heading: m.heading || '(intro)',
+                    status: 'failed',
+                    reason: err.message,
+                });
+            }
+        }
+
+        // Build summary
+        let msg = `Page assembled: "${args.title}"\n`;
+        msg += `Page ID: ${pageId}\n`;
+        msg += `Sections: ${results.filter(r => r.status === 'appended').length} / ${mapping.length}\n`;
+        msg += `Total elements: ${totalElements}\n`;
+        msg += `Status: ${args.status || 'draft'}\n\n`;
+
+        msg += `── Section Results ──\n`;
+        for (const r of results) {
+            if (r.status === 'appended') {
+                msg += `  ✓ Block ${r.block} "${r.heading}" → ${r.type} → ${r.section_id} (${r.elements} elements)\n`;
+            } else if (r.status === 'skipped') {
+                msg += `  ○ Block ${r.block} "${r.heading}" → SKIPPED: ${r.reason}\n`;
+            } else {
+                msg += `  ✗ Block ${r.block} "${r.heading}" → FAILED: ${r.reason}\n`;
+            }
+        }
+
+        if (Object.keys(colorMap).length) {
+            msg += `\n── Rebrand Applied ──\n`;
+            msg += `  Colors: ${Object.keys(colorMap).length} mappings\n`;
+            msg += `  Fonts: ${Object.keys(fontMap).length} mappings\n`;
+        }
+
+        // Get page URLs
+        try {
+            const pageInfo = await apiCall(`/pages`);
+            const page = (pageInfo.pages || pageInfo || []).find(p => p.id === pageId);
+            if (page) {
+                msg += `\nPreview: ${page.url || ''}\n`;
+                msg += `Edit: ${page.edit_url || ''}\n`;
+            }
+        } catch (e) {
+            msg += `\nPage ID: ${pageId} (check WordPress admin)\n`;
+        }
+
+        return ok(msg);
+    }
+
+    case 'get_shortcode_status': {
+        const r = await apiCall('/settings/shortcodes');
+        let msg = `Shortcodes: ${r.enabled ? 'ENABLED' : 'DISABLED'}\n\n`;
+        if (r.enabled) {
+            msg += 'Available shortcodes:\n';
+            for (const [code, desc] of Object.entries(r.shortcodes)) {
+                msg += `  [${code}] — ${desc}\n`;
+            }
+        } else {
+            msg += 'Shortcodes are disabled. To enable them, use toggle_shortcodes or go to Settings > Vision Builder Control > Features.\n\n';
+            msg += 'When enabled, these shortcodes solve Elementor rendering limitations:\n';
+            for (const [code, desc] of Object.entries(r.shortcodes)) {
+                msg += `  [${code}] — ${desc}\n`;
+            }
+        }
+        return ok(msg);
+    }
+
+    case 'toggle_shortcodes': {
+        const r = await apiCall('/settings/shortcodes', 'POST', { enabled: args.enabled });
+        return ok(r.message);
+    }
+
+    case 'get_site_profile': {
+        const r = await apiCall('/site-profile');
+        let msg = '=== SITE PROFILE ===\n\n';
+        for (const [key, value] of Object.entries(r)) {
+            if (value !== '' && value !== null) {
+                msg += `${key}: ${value}\n`;
+            }
+        }
+        const empty = Object.entries(r).filter(([k, v]) => v === '' || v === null).map(([k]) => k);
+        if (empty.length > 0) {
+            msg += `\nUnset keys (${empty.length}): ${empty.join(', ')}`;
+        }
+        return ok(msg);
+    }
+
+    case 'update_site_profile': {
+        const r = await apiCall('/site-profile', 'POST', args.profile);
+        let msg = '';
+        if (r.updated.length > 0) {
+            msg += `Updated: ${r.updated.join(', ')}\n`;
+        }
+        if (r.rejected.length > 0) {
+            msg += `Rejected (unknown keys): ${r.rejected.join(', ')}\n`;
+        }
+        return ok(msg || 'No changes made.');
+    }
+
+    case 'list_changes': {
+        const params = new URLSearchParams();
+        if (args.post_id) params.set('post_id', args.post_id);
+        if (args.source) params.set('source', args.source);
+        params.set('limit', args.limit || 20);
+
+        const r = await apiCall(`/changelog?${params}`);
+        let msg = `=== CHANGELOG (${r.total} total) ===\n\n`;
+
+        if (r.entries.length === 0) {
+            msg += 'No changes recorded yet.';
+        } else {
+            for (const e of r.entries) {
+                msg += `#${e.id} | ${e.created_at} | ${e.source.toUpperCase()}\n`;
+                msg += `  Page: ${e.post_title || 'N/A'} (${e.post_id})\n`;
+                msg += `  Action: ${e.action}\n`;
+                msg += `  Summary: ${e.summary}\n`;
+                msg += `  User: ${e.user_login} | IP: ${e.ip_address}\n\n`;
+            }
+        }
+        return ok(msg);
+    }
+
+    case 'rollback_change': {
+        const id = args.changelog_id;
+        const preview = args.preview || false;
+
+        if (preview) {
+            const r = await apiCall(`/changelog/${id}/rollback`);
+            let msg = `=== ROLLBACK PREVIEW #${r.id} ===\n\n`;
+            msg += `Action: ${r.action}\n`;
+            msg += `Summary: ${r.summary}\n\n`;
+            msg += `Before (would restore to):\n${JSON.stringify(r.before, null, 2)}\n\n`;
+            msg += `After (current state):\n${JSON.stringify(r.after, null, 2)}\n\n`;
+            msg += r.message;
+            return ok(msg);
+        }
+
+        const r = await apiCall(`/changelog/${id}/rollback`, 'POST');
+        return ok(r.message);
+    }
+
+    case 'validate_all_pages': {
+        const verbose = args.verbose ? '&verbose=1' : '';
+        const r = await apiCall(`/validate-all?${verbose}`);
+        let msg = `=== BULK VALIDATION ===\n\n`;
+        msg += `Pages scanned: ${r.pages_scanned}\n`;
+        msg += `Pages valid: ${r.pages_valid}\n`;
+        msg += `Pages with issues: ${r.pages_with_issues}\n`;
+        msg += `Total issues: ${r.total_issues}\n\n`;
+
+        if (r.results && r.results.length > 0) {
+            for (const p of r.results) {
+                const status = p.valid ? '✓' : '✗';
+                msg += `${status} ${p.title} (#${p.page_id}) — ${p.issue_count} issues`;
+                if (p.stats) msg += ` | ${p.stats.sections}s/${p.stats.containers}c/${p.stats.widgets}w`;
+                msg += '\n';
+                if (p.issues && p.issues.length > 0) {
+                    for (const issue of p.issues) {
+                        msg += `    - ${issue}\n`;
+                    }
+                }
+            }
+        }
+        return ok(msg);
+    }
+
+    case 'get_audit_report': {
+        const r = await apiCall('/audit-report');
+        if (r.status === 'no_data') {
+            return ok(r.message);
+        }
+        let msg = `=== WEEKLY AUDIT REPORT ===\n\n`;
+        msg += `Last run: ${r.completed_at || 'Unknown'}\n`;
+        msg += `Duration: ${r.duration_seconds || 0}s\n`;
+        msg += `Audit enabled: ${r.audit_enabled ? 'Yes' : 'No'}\n`;
+        msg += `Scheduled hour: ${r.audit_start_hour || 3}:00\n\n`;
+
+        if (r.summary) {
+            msg += `--- Summary ---\n`;
+            msg += `Pages scanned: ${r.summary.pages_scanned || 0}\n`;
+            msg += `Link issues: ${r.summary.link_issues || 0}\n`;
+            msg += `Image issues: ${r.summary.image_issues || 0}\n`;
+            msg += `SEO issues: ${r.summary.seo_issues || 0}\n`;
+        }
+        return ok(msg);
+    }
+
+    case 'run_audit_now': {
+        const r = await apiCall('/audit/run', 'POST', {});
+        return ok(r.message || 'Audit started. Call get_audit_report in ~60s for results.');
+    }
+
+    default:
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+}
+
+// ================================================================
+// MCP SERVER FACTORY
+// ================================================================
+
+function createMcpServer() {
+    const server = new Server(
+        { name: 'vision-builder-control', version: VERSION },
+        { capabilities: { tools: {} } },
+    );
+
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = getToolDefinitions();
+        console.error(`[MCP] ${tools.length} tools registered`);
+        return { tools };
+    });
+
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            return await handleToolCall(name, args);
+        } catch (error) {
+            console.error(`[MCP] Error in ${name}: ${error.message}`);
+            return { content: [{ type: 'text', text: `Error: ${error.message}` }], isError: true };
+        }
+    });
+
+    return server;
+}
+
+// ================================================================
+// HELPERS
+// ================================================================
+
+function ok(msg) { return { content: [{ type: 'text', text: msg }] }; }
+function rndId() { return [...Array(8)].map(() => Math.floor(Math.random() * 16).toString(16)).join(''); }
+
+// ================================================================
+// STDIO MODE
+// ================================================================
+
+// Module-level references to prevent GC
+let _server = null;
+let _transport = null;
+
+async function startStdio() {
+    // Keepalive FIRST — ensures event loop never empties, even if stdin closes
+    global._mcpKeepAlive = setInterval(() => {}, 30000);
+
+    // Monitor stdin/stdout lifecycle (diagnostic)
+    process.stdin.on('end', () => {
+        console.error('[LIFECYCLE] stdin ended');
+    });
+    process.stdin.on('close', () => {
+        console.error('[LIFECYCLE] stdin closed');
+    });
+    process.stdin.on('error', (err) => {
+        console.error('[LIFECYCLE] stdin error:', err.message);
+    });
+    process.stdout.on('error', (err) => {
+        console.error('[LIFECYCLE] stdout error:', err.message);
+    });
+
+    _server = createMcpServer();
+    _transport = new StdioServerTransport();
+    await _server.connect(_transport);
+
+    console.error(`Vision Builder Control MCP v${VERSION} ready (stdio)`);
+}
+
+// ================================================================
+// HTTP/SSE MODE
+// ================================================================
+
+async function startHttp(port) {
+    const { SSEServerTransport } = await import("@modelcontextprotocol/sdk/server/sse.js");
+    const { createServer: createHttpServer } = await import("node:http");
+    const { URL } = await import("node:url");
+
+    const sessions = new Map();
+
+    const httpServer = createHttpServer(async (req, res) => {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+
+        if (req.method === 'OPTIONS') { res.writeHead(204); res.end(); return; }
+
+        const url = new URL(req.url, `http://localhost:${port}`);
+
+        if (req.method === 'GET' && url.pathname === '/sse') {
+            console.error('[HTTP] New SSE connection');
+            try {
+                const transport = new SSEServerTransport('/message', res);
+                const sessionId = transport.sessionId;
+                const server = createMcpServer();
+
+                const heartbeat = setInterval(() => {
+                    if (!res.writableEnded) { res.write(': keepalive\n\n'); }
+                    else { clearInterval(heartbeat); }
+                }, HEARTBEAT_MS);
+
+                transport.onclose = () => { clearInterval(heartbeat); sessions.delete(sessionId); };
+                res.on('close', () => { clearInterval(heartbeat); sessions.delete(sessionId); });
+
+                sessions.set(sessionId, { server, transport, heartbeat });
+                await server.connect(transport);
+                console.error(`[HTTP] Session established (${sessions.size} active)`);
+            } catch (err) {
+                console.error('[HTTP] SSE error:', err.message);
+                if (!res.headersSent) { res.writeHead(500); res.end('SSE failed'); }
+            }
+            return;
+        }
+
+        if (req.method === 'POST' && url.pathname === '/message') {
+            const sessionId = url.searchParams.get('sessionId');
+            if (!sessionId || !sessions.has(sessionId)) {
+                res.writeHead(404); res.end('Session not found'); return;
+            }
+            try {
+                await sessions.get(sessionId).transport.handlePostMessage(req, res);
+            } catch (err) {
+                if (!res.headersSent) { res.writeHead(500); res.end('Message failed'); }
+            }
+            return;
+        }
+
+        if (req.method === 'GET' && (url.pathname === '/health' || url.pathname === '/')) {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                status: 'ok', plugin: 'vision-builder-control-mcp', version: VERSION,
+                transport: 'sse', sessions: sessions.size, uptime: Math.round(process.uptime()),
+            }));
+            return;
+        }
+
+        res.writeHead(404); res.end('Not Found');
+    });
+
+    httpServer.listen(port, () => {
+        console.error(`Vision Builder Control MCP v${VERSION} ready (HTTP/SSE)`);
+        console.error(`   SSE: http://localhost:${port}/sse`);
+        console.error(`   Health: http://localhost:${port}/health`);
+    });
+
+    const shutdown = async () => {
+        for (const [, session] of sessions) {
+            clearInterval(session.heartbeat);
+            try { await session.transport.close(); } catch {}
+        }
+        sessions.clear();
+        httpServer.close();
+        process.exit(0);
+    };
+
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+
+// ================================================================
+// MAIN
+// ================================================================
+
+async function main() {
+    if (!CONFIG.username || !CONFIG.applicationPassword) {
+        console.error('Warning: WP_USER and WP_APP_PASSWORD not set');
+    }
+
+    if (httpMode) {
+        await startHttp(PORT);
+    } else {
+        await startStdio();
+    }
+}
+
+main().catch((err) => {
+    console.error('[FATAL] Startup failed:', err.message);
+    process.exit(1);
+});