@noleemits/vision-builder-control-mcp 4.15.1 → 4.16.0

package/README.md

@@ -1,6 +1,6 @@
 # Vision Builder Control — MCP Server
 
-**v4.2.2** | 63 tools for WordPress + Elementor management via Claude
+**v4.15.2** | 65+ tools for WordPress + Elementor management via Claude
 
 ## Quick Start
 

package/index.js

@@ -104,7 +104,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.15.1';
+const VERSION = '4.16.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2051,7 +2051,7 @@ function getToolDefinitions() {
         },
         {
             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.',
+            description: 'Global find & replace across all Elementor pages. Searches heading titles, text-editor HTML, button text, image-box titles/descriptions, icon-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: {
@@ -2116,6 +2116,7 @@ function getToolDefinitions() {
                     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' },
+                    category: { type: 'string', description: 'Filter by category: ID (number) or slug (string). Only applies to post types with categories.' },
                     per_page: { type: 'number', description: 'Results per page, max 100 (default: 50)' },
                     page: { type: 'number', description: 'Page number (default: 1)' }
                 }
@@ -2229,6 +2230,35 @@ function getToolDefinitions() {
                 }
             }
         },
+        {
+            name: 'update_term_seo',
+            description: 'Update RankMath SEO fields on a taxonomy term (category, tag, custom taxonomy). Accepts any subset: title, description, focus_keyword, canonical_url, noindex (boolean convenience flag).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    term_id: { type: 'number', description: 'WordPress term ID' },
+                    taxonomy: { type: 'string', description: 'Taxonomy slug, e.g. "category", "post_tag", "testimonial-category"' },
+                    title: { type: 'string', description: 'SEO meta title' },
+                    description: { type: 'string', description: 'SEO meta description' },
+                    focus_keyword: { type: 'string', description: 'Primary focus keyword' },
+                    canonical_url: { type: 'string', description: 'Canonical URL' },
+                    noindex: { type: 'boolean', description: 'Set true to noindex this term archive' }
+                },
+                required: ['term_id']
+            }
+        },
+        {
+            name: 'get_term_seo',
+            description: 'Read current RankMath SEO fields for a taxonomy term.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    term_id: { type: 'number', description: 'WordPress term ID' },
+                    taxonomy: { type: 'string', description: 'Optional taxonomy slug for validation' }
+                },
+                required: ['term_id']
+            }
+        },
         // ── Taxonomies ──
         {
             name: 'list_taxonomies',
@@ -3678,6 +3708,7 @@ async function handleToolCall(name, args) {
         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.category) params.set('category', args.category);
         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()}` : '';
@@ -3808,6 +3839,37 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    case 'update_term_seo': {
+        const { term_id, taxonomy, ...seoFields } = args;
+        const body = { ...seoFields };
+        if (taxonomy) body.taxonomy = taxonomy;
+        const r = await apiCall(`/terms/${term_id}/seo`, 'POST', body);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `SEO updated for term "${r.name}" (${r.taxonomy}, ID ${r.term_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 'get_term_seo': {
+        const { term_id, taxonomy } = args;
+        const qs = taxonomy ? `?taxonomy=${encodeURIComponent(taxonomy)}` : '';
+        const r = await apiCall(`/terms/${term_id}/seo${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let out = `SEO for term "${r.name}" (${r.taxonomy}, ID ${r.term_id}):\n`;
+        if (r.seo) {
+            for (const [k, v] of Object.entries(r.seo)) {
+                out += `  ${k}: ${typeof v === 'object' ? JSON.stringify(v) : v}\n`;
+            }
+        } else {
+            out += '  No RankMath SEO data set on this term.';
+        }
+        return ok(out);
+    }
+
     // ── Taxonomies ──
 
     case 'list_taxonomies': {

package/package.json

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