@noleemits/vision-builder-control-mcp 4.32.1 → 4.34.0

package/index.js

@@ -2,7 +2,9 @@
 /**
  * Noleemits Vision Builder Control MCP Server
  *
- * Provides 65 tools for building and managing WordPress/Elementor sites.
+ * Provides 67 tools for building and managing WordPress/Elementor sites.
+ * v4.34.0: Design tokens auto-inject as CSS custom properties (--nvbc-color-*, --nvbc-fs-*, --nvbc-space-*) site-wide via wp_head; kit global CSS tools (get_kit_global_css, set_kit_global_css); get_kit_settings formatter handles gap-style objects.
+ * v4.33.0: Elementor kit layout settings (get_kit_settings, set_kit_settings) — read/write container_width, viewports, gutter.
  * v4.15.0: Injection engine v2 — icon-list injection, unfilled slot clearing.
  * v4.14.0: Pipeline quality fixes — smart counter parsing, post-processing, quality scores in browse, injection completeness.
  * v4.13.0: Phase 3 DX — display_conditions, null filter fix, garbage HTML cleanup, icon key docs, auto-inject convenience docs.
@@ -104,7 +106,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.32.0';
+const VERSION = '4.34.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -3050,6 +3052,41 @@ function getToolDefinitions() {
                 }
             }
         },
+        {
+            name: 'get_kit_settings',
+            description: 'Read Elementor kit layout settings (container_width, viewport_md, viewport_lg, space_between_widgets, etc.) from the active kit. Slider values come back as {unit, size, sizes} objects.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'set_kit_settings',
+            description: 'Update Elementor kit layout settings on the active kit. Pass a settings object with any whitelisted keys: container_width (px), container_width_tablet, container_width_mobile, space_between_widgets, viewport_md, viewport_lg, viewport_mobile, viewport_tablet. Slider values accept either a plain number (treated as px) or {size, unit, sizes?}. Clears Elementor CSS cache after applying. Always dry_run=true first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    settings: { type: 'object', description: 'Map of kit setting keys to values. Numbers auto-wrap into {unit:"px", size:N} for slider keys. Example: {"container_width": 1280}' },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true).' }
+                },
+                required: ['settings']
+            }
+        },
+        {
+            name: 'get_kit_global_css',
+            description: 'Read the active kit\'s custom_css (Elementor "Custom CSS" field). This CSS is output site-wide via Elementor\'s own stylesheet pipeline. Use to inspect site-wide CSS variables, base styles, etc.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'set_kit_global_css',
+            description: 'Write to the active kit\'s custom_css. Modes: "replace" (default — overwrites), "append" (adds to end), "prepend" (adds to start). Output goes through Elementor\'s stylesheet pipeline (no HTML widget needed). Always dry_run=true first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    css: { type: 'string', description: 'CSS text. Will be wrapped in <style> by Elementor — do not include style tags.' },
+                    mode: { type: 'string', enum: ['replace', 'append', 'prepend'], description: 'How to combine with existing CSS (default: replace).' },
+                    dry_run: { type: 'boolean', description: 'Preview without saving (default: true).' }
+                },
+                required: ['css']
+            }
+        },
         {
             name: 'audit_broken_images',
             description: 'Scan all published posts and Elementor pages for broken images (non-200 HTTP responses). Checks <img> tags in post_content and image/image-box widgets + background images in Elementor data. Returns broken URLs with HTTP status, error details, and which posts are affected.',
@@ -5178,6 +5215,73 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    case 'get_kit_settings': {
+        const r = await apiCall('/kit-settings');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== ELEMENTOR KIT SETTINGS ===\nKit ID: ${r.kit_id}\n\n`;
+        for (const [k, v] of Object.entries(r.settings || {})) {
+            if (v === null || v === '') { out += `  ${k}: (unset)\n`; continue; }
+            if (typeof v === 'object') {
+                const unit = v.unit || 'px';
+                if ('size' in v && v.size !== '' && v.size !== null) {
+                    out += `  ${k}: ${v.size}${unit}\n`;
+                } else if ('column' in v || 'row' in v) {
+                    const col = v.column ?? '';
+                    const row = v.row ?? '';
+                    out += `  ${k}: column=${col}${unit}, row=${row}${unit}\n`;
+                } else {
+                    out += `  ${k}: ${JSON.stringify(v)}\n`;
+                }
+            } else {
+                out += `  ${k}: ${v}\n`;
+            }
+        }
+        return ok(out);
+    }
+
+    case 'set_kit_settings': {
+        const body = { settings: args.settings || {} };
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/kit-settings', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== SET KIT SETTINGS (DRY RUN) ===\n` : `=== SET KIT SETTINGS ===\n`;
+        out += `Kit ID: ${r.kit_id}\n`;
+        if (r.changes?.length) {
+            r.changes.forEach(c => { out += `  • ${c}\n`; });
+        } else {
+            out += '  No changes detected.\n';
+        }
+        if (r.rejected && Object.keys(r.rejected).length) {
+            out += `\nRejected:\n`;
+            for (const [k, why] of Object.entries(r.rejected)) {
+                out += `  ✗ ${k}: ${why}\n`;
+            }
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
+    case 'get_kit_global_css': {
+        const r = await apiCall('/kit-global-css');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = `=== KIT GLOBAL CSS ===\nKit ID: ${r.kit_id}\nLength: ${r.length} bytes\n\n`;
+        out += r.css || '(empty)';
+        return ok(out);
+    }
+
+    case 'set_kit_global_css': {
+        const body = { css: args.css ?? '' };
+        if (args.mode !== undefined) body.mode = args.mode;
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/kit-global-css', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== SET KIT GLOBAL CSS (DRY RUN) ===\n` : `=== SET KIT GLOBAL CSS ===\n`;
+        out += `Kit ID: ${r.kit_id}\n`;
+        out += `Mode: ${r.mode}\n`;
+        out += `${r.summary}\n\n${r.note}`;
+        return ok(out);
+    }
+
     case 'audit_broken_images': {
         const params = new URLSearchParams();
         if (args.page_id) params.set('page_id', args.page_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noleemits/vision-builder-control-mcp",
-  "version": "4.32.1",
+  "version": "4.34.0",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",