@noleemits/vision-builder-control-mcp 4.38.1 → 4.41.1

package/index.js

@@ -107,7 +107,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.38.1';
+const VERSION = '4.41.1';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2422,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).',
@@ -2576,9 +2632,20 @@ function getToolDefinitions() {
                 required: ['name']
             }
         },
+        {
+            name: 'list_menu_items',
+            description: 'List all items in a nav menu, in order. Returns each item\'s id, title, url, type, object (page/post/category/etc.), object_id, parent (parent item ID, 0 for top-level), order, target, classes (CSS class array), and description. Use before set_menu_items so you can patch one entry without losing the others.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    menu_id: { type: 'number', description: 'Menu ID from list_nav_menus' }
+                },
+                required: ['menu_id']
+            }
+        },
         {
             name: 'set_menu_items',
-            description: 'Bulk-replace all items in a nav menu. Each item: {title, url (for type=custom), type ("custom"|"post_type"|"taxonomy"), object ("page"|"post"|"category"), object_id, parent_index (for nesting — 0-based index of parent in this same array), target ("_blank")}. Items are inserted in order; nested items must come AFTER their parent in the array.',
+            description: 'Bulk-replace all items in a nav menu. Each item: {title, url (for type=custom), type ("custom"|"post_type"|"taxonomy"), object ("page"|"post"|"category"), object_id, parent_index (for nesting — 0-based index of parent in this same array), target ("_blank"), classes (CSS classes — string or array, applied as <li class="...">), description (free text shown by some menu widgets)}. Items are inserted in order; nested items must come AFTER their parent in the array.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2595,7 +2662,9 @@ function getToolDefinitions() {
                                 object:       { type: 'string', description: 'e.g. "page", "post", "category" — required when type !== "custom"' },
                                 object_id:    { type: 'number', description: 'WP object ID — required when type !== "custom"' },
                                 parent_index: { type: 'number', description: 'Index in this array of the parent item (for nesting). Omit for top-level.' },
-                                target:       { type: 'string', enum: ['_blank', ''], description: 'Optional. "_blank" opens in new tab.' }
+                                target:       { type: 'string', enum: ['_blank', ''], description: 'Optional. "_blank" opens in new tab.' },
+                                classes:      { description: 'CSS classes for the <li>. Pass a string ("mega-menu primary") or an array (["mega-menu", "primary"]). Useful for targeting specific items in CSS without relying on URL substrings.' },
+                                description:  { type: 'string', description: 'Optional description text. Some menu walkers render it; otherwise stored as data-description.' }
                             }
                         }
                     }
@@ -4391,6 +4460,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);
@@ -4627,6 +4742,25 @@ async function handleToolCall(name, args) {
             : `Menu already existed: "${r.name}" (ID ${r.id})`);
     }
 
+    case 'list_menu_items': {
+        const r = await apiCall(`/menus/${args.menu_id}/items`);
+        if (!r.items || !r.items.length) return ok(`Menu ${args.menu_id} has no items.`);
+        const byParent = {};
+        r.items.forEach(it => { (byParent[it.parent || 0] ||= []).push(it); });
+        const lines = [];
+        const renderItem = (it, depth) => {
+            const indent = '  '.repeat(depth);
+            const target = it.type === 'custom'
+                ? it.url
+                : `${it.type}/${it.object}#${it.object_id}`;
+            const cls = Array.isArray(it.classes) && it.classes.length ? `  .${it.classes.join('.')}` : '';
+            lines.push(`${indent}[${it.id}] ${it.title} → ${target}${cls}`);
+            (byParent[it.id] || []).forEach(c => renderItem(c, depth + 1));
+        };
+        (byParent[0] || []).forEach(it => renderItem(it, 0));
+        return ok(`Menu ${r.menu_id} items (${r.items.length}):\n${lines.join('\n')}`);
+    }
+
     case 'set_menu_items': {
         const r = await apiCall(`/menus/${args.menu_id}/items`, 'POST', { items: args.items });
         const errLines = (r.errors || []).map(e => `  • #${e.index}: ${e.message}`);

package/package.json

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