@noleemits/vision-builder-control-mcp 4.37.0 → 4.39.0

package/index.js

@@ -107,7 +107,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.37.0';
+const VERSION = '4.39.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2151,7 +2151,7 @@ function getToolDefinitions() {
         },
         {
             name: 'update_element',
-            description: 'Update any element\'s settings by its Elementor ID or path. Patch widget properties like hover_color, background_color, __globals__ overrides, text, link URLs, etc. Supports dot-notation for nested keys (e.g. "__globals__.hover_color"). Supports element_path as alternative to element_id (e.g. "sectionId/1/0" = section → child 1 → child 0). Use list_elements or export_page first to find the element ID and current settings. IMPORTANT: Prefer settings_json (JSON string) over settings (object) for reliable MCP transport. AUTO-INJECTED KEYS: background_background:"classic" auto-set when you set background_color; typography_typography:"custom" auto-set when you set font properties; flex_grow expands to all 3 required keys; grid column strings auto-wrapped in object format. ICON WIDGET: For view="default" use "icon_size" for dimensions. For view="stacked" or "framed" (circle/square background) use "size" instead — "icon_size" is silently ignored in stacked/framed mode.',
+            description: 'Update any element\'s settings by its Elementor ID or path. Patch widget properties like hover_color, background_color, __globals__ overrides, text, link URLs, etc. Supports dot-notation for nested keys (e.g. "__globals__.hover_color"). Supports element_path as alternative to element_id (e.g. "sectionId/1/0" = section → child 1 → child 0). Use list_elements or export_page first to find the element ID and current settings. IMPORTANT: Prefer settings_json (JSON string) over settings (object) for reliable MCP transport. AUTO-INJECTED KEYS: background_background:"classic" auto-set when you set background_color; typography_typography:"custom" auto-set when you set font properties; flex_grow expands to all 3 required keys; grid column strings auto-wrapped in object format. ICON WIDGET: For view="default" use "icon_size" for dimensions. For view="stacked" or "framed" (circle/square background) use "size" instead — "icon_size" is silently ignored in stacked/framed mode. LOOP-GRID WIDGET: query settings use the prefix "post_query_" (post_query_post_type, post_query_orderby, post_query_order, post_query_posts_per_page) — NOT "posts_post_type". Setting "posts_post_type" is silently accepted but ignored. RACE CONDITION: when patching multiple elements on the SAME page in parallel, use batch_update_elements instead — parallel update_element calls can clobber each other.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2309,11 +2309,12 @@ function getToolDefinitions() {
         },
         {
             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.',
+            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. Pass full_content=true to return the complete raw post_content (default: 500-char preview).',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    post_id: { type: 'number', description: 'WordPress post/page ID' }
+                    post_id: { type: 'number', description: 'WordPress post/page ID' },
+                    full_content: { type: 'boolean', description: 'If true, return the complete raw post_content instead of a 500-char preview. Default: false.' }
                 },
                 required: ['post_id']
             }
@@ -2421,6 +2422,62 @@ function getToolDefinitions() {
                 }
             }
         },
+        {
+            name: 'get_rankmath_global',
+            description: 'Read RankMath sitewide settings: Knowledge Graph / Organization (name, type, logo, phone, email, address), social profiles (Facebook URL, Twitter handle, additional profile URLs), and default Open Graph image. Use to audit before bulk-updating sitewide schema/social data.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'update_rankmath_global',
+            description: 'Update RankMath sitewide settings (Knowledge Graph / Organization, social profiles, defaults). Send a partial structured object — only provided keys are written. Use to push organization name/logo/phone/address, social URLs, and default OG image into RankMath schema in one call.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization: {
+                        type: 'object',
+                        description: 'Knowledge Graph / Organization fields',
+                        properties: {
+                            type: { type: 'string', description: '"company" or "person"' },
+                            name: { type: 'string' },
+                            logo: { type: 'string', description: 'Logo URL (use a media library URL)' },
+                            phone: { type: 'string' },
+                            email: { type: 'string' },
+                            address: {
+                                type: 'object',
+                                properties: {
+                                    street: { type: 'string' },
+                                    city: { type: 'string' },
+                                    state: { type: 'string' },
+                                    zip: { type: 'string' },
+                                    country: { type: 'string' }
+                                }
+                            }
+                        }
+                    },
+                    social: {
+                        type: 'object',
+                        description: 'Social profile URLs',
+                        properties: {
+                            facebook: { type: 'string', description: 'Facebook page URL' },
+                            twitter: { type: 'string', description: 'Twitter handle (e.g. "@firmname")' },
+                            additional_profiles: { type: 'array', items: { type: 'string' }, description: 'Additional profile URLs (LinkedIn, Instagram, YouTube, etc.) — one URL per array entry' }
+                        }
+                    },
+                    defaults: {
+                        type: 'object',
+                        description: 'Sitewide defaults',
+                        properties: {
+                            open_graph_image: { type: 'string', description: 'Default OG image URL' },
+                            open_graph_image_id: { type: 'number', description: 'Default OG image attachment ID' }
+                        }
+                    },
+                    local_business_type: { type: 'string', description: 'schema.org Local Business type (e.g. "LegalService")' }
+                }
+            }
+        },
         {
             name: 'audit_faq_schema',
             description: 'Audit all published posts/pages for FAQ schema issues: duplicate FAQPage markup (NVBC meta + RankMath block), orphaned NVBC schemas, unconverted plain FAQs, invalid JSON, empty Q&As, and encoding issues (bare u003c).',
@@ -3248,6 +3305,21 @@ function getToolDefinitions() {
                 required: ['source_id', 'section_index', 'target_id']
             }
         },
+        {
+            name: 'clone_template',
+            description: 'Clone an entire Theme Builder template (single, archive, loop-item, header, footer, popup) in one call. Auto-handles the elementor_library_type taxonomy, _elementor_template_type meta, edit-mode meta, and (optionally) display conditions. Saves 4-5 calls (create_post + copy_section × N + display_conditions) into one. Use this instead of stitching those calls together when you need a brand-new Theme Builder template based on an existing design.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    source_template_id: { type: 'number', description: 'Existing template ID to clone (must be a post of type elementor_library)' },
+                    title: { type: 'string', description: 'Title for the new template (e.g. "WAL Single Location")' },
+                    slug: { type: 'string', description: 'Optional URL slug. Auto-derived from title if omitted.' },
+                    conditions: { type: 'array', items: { type: 'string' }, description: 'Display conditions to set on the new template, e.g. ["include/singular/location"] or ["include/archive/location_archive"]. Omit to leave unset.' },
+                    status: { type: 'string', enum: ['publish', 'draft', 'private', 'pending'], description: 'Post status (default: publish)' }
+                },
+                required: ['source_template_id', 'title']
+            }
+        },
         {
             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.',
@@ -4313,8 +4385,8 @@ async function handleToolCall(name, args) {
             }
         }
         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`;
+            const body = args.full_content ? r.content : (r.content.length > 500 ? r.content.slice(0, 500) + '...' : r.content);
+            out += `\n--- CONTENT (${r.content_length} chars) ---\n${body}\n`;
         }
         return ok(out);
     }
@@ -4375,6 +4447,52 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    case 'get_rankmath_global': {
+        const r = await apiCall('/seo/global');
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `=== RANKMATH GLOBAL SETTINGS ===\n`;
+        out += `\n--- Organization ---\n`;
+        out += `  Type: ${r.organization.type || '(unset)'}\n`;
+        out += `  Name: ${r.organization.name || '(unset)'}\n`;
+        out += `  Logo: ${r.organization.logo || '(unset)'}\n`;
+        out += `  Phone: ${r.organization.phone || '(unset)'}\n`;
+        out += `  Email: ${r.organization.email || '(unset)'}\n`;
+        const a = r.organization.address || {};
+        if (a.street || a.city) {
+            out += `  Address: ${a.street || ''}${a.street && a.city ? ', ' : ''}${a.city || ''}${a.state ? ', ' + a.state : ''} ${a.zip || ''}${a.country ? ' ' + a.country : ''}\n`;
+        } else {
+            out += `  Address: (unset)\n`;
+        }
+        out += `\n--- Social ---\n`;
+        out += `  Facebook: ${r.social.facebook || '(unset)'}\n`;
+        out += `  Twitter: ${r.social.twitter || '(unset)'}\n`;
+        if (r.social.additional_profiles && r.social.additional_profiles.length) {
+            out += `  Additional profiles:\n`;
+            r.social.additional_profiles.forEach(u => out += `    - ${u}\n`);
+        } else {
+            out += `  Additional profiles: (none)\n`;
+        }
+        out += `\n--- Defaults ---\n`;
+        out += `  OG image: ${r.defaults.open_graph_image || '(unset)'}\n`;
+        if (r.defaults.open_graph_image_id) out += `  OG image ID: ${r.defaults.open_graph_image_id}\n`;
+        if (r.local_business_type) out += `\nLocal business type: ${r.local_business_type}\n`;
+        return ok(out);
+    }
+
+    case 'update_rankmath_global': {
+        const r = await apiCall('/seo/global', 'POST', args);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `RankMath sitewide settings updated!\n`;
+        out += `Updated: ${(r.updated_fields || []).join(', ') || '(none)'}\n`;
+        if (r.current && r.current.organization) {
+            out += `\n--- New state ---\n`;
+            out += `  Org: ${r.current.organization.name || '(unset)'} (${r.current.organization.type || 'unset'})\n`;
+            out += `  Phone: ${r.current.organization.phone || '(unset)'}\n`;
+            out += `  Facebook: ${r.current.social.facebook || '(unset)'}\n`;
+        }
+        return ok(out);
+    }
+
     case 'audit_seo': {
         const params = new URLSearchParams();
         if (args.post_type) params.set('post_type', args.post_type);
@@ -5619,6 +5737,31 @@ async function handleToolCall(name, args) {
         return ok(msg);
     }
 
+    case 'clone_template': {
+        const sourceId = args.source_template_id;
+        if (!sourceId || !args.title) {
+            return ok('Failed: source_template_id and title are required.');
+        }
+        const body = { title: args.title };
+        if (args.slug) body.slug = args.slug;
+        if (Array.isArray(args.conditions)) body.conditions = args.conditions;
+        if (args.status) body.status = args.status;
+        const r = await apiCall(`/templates/${sourceId}/clone`, 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        let msg = `Template cloned!\n`;
+        msg += `Source: ID ${r.source_id}\n`;
+        msg += `New template: ID ${r.new_id} ("${r.title}")\n`;
+        msg += `Type: ${r.template_type || '(none — taxonomy missing on source)'}\n`;
+        msg += `Sections copied: ${r.sections_copied} | Elements: ${r.elements_copied}\n`;
+        if (r.conditions && r.conditions.length) {
+            msg += `Conditions: ${r.conditions.join(', ')}\n`;
+        } else {
+            msg += `Conditions: (none — set via display_conditions if needed)\n`;
+        }
+        msg += `Edit URL: ${r.edit_url}`;
+        return ok(msg);
+    }
+
     case 'append_section': {
         // Enforce root settings on appended sections
         if (args.section) addBoilerplate(args.section);

package/package.json

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