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

package/index.js

@@ -107,7 +107,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.39.0';
+const VERSION = '4.41.1';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2632,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: {
@@ -2651,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.' }
                             }
                         }
                     }
@@ -4729,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.39.0",
+  "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",