@noleemits/vision-builder-control-mcp 4.46.2 → 4.47.0

package/index.js

@@ -111,7 +111,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.46.2';
+const VERSION = '4.47.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2429,7 +2429,8 @@ function getToolDefinitions() {
                     featured_image_id: { type: 'number', description: 'Media library attachment ID' },
                     featured_image_basename: { type: 'string', description: 'Filename of an attachment (e.g. "boating-accidents-v2.jpg") — resolves to the matching attachment ID. Use instead of featured_image_id when you have the source filename but not the ID.' },
                     elementor: { type: 'boolean', description: 'Set up for Elementor editing' },
-                    seo: { type: 'object', description: 'RankMath SEO: {title, description, focus_keyword, robots, ...}' }
+                    seo: { type: 'object', description: 'RankMath SEO: {title, description, focus_keyword, robots, ...}' },
+                    dedupe_by_title: { type: 'boolean', description: 'If true, check for an existing non-trashed post with the same (title, post_type) and return it instead of creating a duplicate. Response will have was_existing:true. Use for idempotent creates over flaky transports — protects against phantom duplicates when an MCP response times out but the server insert succeeded.' }
                 },
                 required: ['title']
             }
@@ -2469,6 +2470,35 @@ function getToolDefinitions() {
                 required: ['post_id']
             }
         },
+        {
+            name: 'get_post_by_slug',
+            description: 'Look up a single post by exact slug within a post type. Returns the post if found, or found:false if not. Use before create_post to check for slug collisions, or to resolve a slug into a post ID without scanning list_posts.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    slug: { type: 'string', description: 'Exact slug (post_name). Case-insensitive, sanitized server-side.' },
+                    post_type: { type: 'string', description: 'Post type slug. Default "post".' },
+                    status: { type: 'string', description: 'Comma-separated statuses to include. Default: publish,private,draft,pending (excludes trash).' }
+                },
+                required: ['slug']
+            }
+        },
+        {
+            name: 'change_post_type',
+            description: 'Migrate a WordPress post to a different post type IN PLACE — preserves post ID, post_meta (SEO, featured image, custom fields), comments, attachments, post_date, and any taxonomy terms registered on both types. Atomic operation (single DB write to the post_type column, no save_post re-fire). Optionally rewrites internal links across all post_content and creates a RankMath 301 redirect from the old permalink. Use this instead of create_post + delete_post when moving a page to a CPT — it is faster, lossless, and keeps the URL history.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'WordPress post/page ID to migrate' },
+                    new_post_type: { type: 'string', description: 'Target post type slug. Must be registered.' },
+                    slug_override: { type: 'string', description: 'Optional. Force a specific slug. If omitted and the existing slug collides on the new post type, a unique suffix is added automatically.' },
+                    update_internal_links: { type: 'boolean', description: 'Rewrite old permalink → new permalink across all post_content. Default: true.' },
+                    create_redirect: { type: 'boolean', description: 'Create a RankMath 301 from the old permalink to the new one. Default: true. Requires RankMath active.' },
+                    flush_rewrites: { type: 'boolean', description: 'Flush WP rewrite rules after the change. Default: true.' }
+                },
+                required: ['post_id', 'new_post_type']
+            }
+        },
         // ── RankMath SEO ──
         {
             name: 'get_seo',
@@ -4794,11 +4824,37 @@ async function handleToolCall(name, args) {
         const body = { title: args.title };
         const passthrough = ['post_type', 'content', 'excerpt', 'status', 'slug',
             'parent', 'parent_slug', 'taxonomies', 'featured_image_id',
-            'featured_image_basename', 'elementor', 'seo'];
+            'featured_image_basename', 'elementor', 'seo', 'dedupe_by_title'];
         for (const k of passthrough) if (args[k] !== undefined) body[k] = args[k];
         const r = await apiCall('/posts', 'POST', body);
         if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
-        return ok(`Post created!\nID: ${r.id} | Type: ${r.type} | Status: ${r.status}\nTitle: ${r.title}\nSlug: ${r.slug}\nURL: ${r.url}\nEdit: ${r.edit_url}`);
+        const prefix = r.was_existing ? 'Post already existed (dedupe hit)' : 'Post created';
+        return ok(`${prefix}!\nID: ${r.id} | Type: ${r.type} | Status: ${r.status}\nTitle: ${r.title}\nSlug: ${r.slug}\nURL: ${r.url}\nEdit: ${r.edit_url}`);
+    }
+
+    case 'get_post_by_slug': {
+        const params = new URLSearchParams();
+        params.set('slug', args.slug);
+        if (args.post_type) params.set('post_type', args.post_type);
+        if (args.status) params.set('status', args.status);
+        const r = await apiCall(`/posts/by-slug?${params}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        if (!r.found) return ok(`No post with slug "${r.slug}" found in post type "${r.post_type}".`);
+        return ok(`Found post!\nID: ${r.id} | Type: ${r.type} | Status: ${r.status}\nTitle: ${r.title}\nSlug: ${r.slug}\nURL: ${r.url}\nEdit: ${r.edit_url}`);
+    }
+
+    case 'change_post_type': {
+        const { post_id, ...body } = args;
+        const r = await apiCall(`/posts/${post_id}/change-type`, 'POST', body);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        let msg = `Post type changed!\nID: ${r.id}\n`;
+        msg += `Type: ${r.old_post_type} → ${r.new_post_type}\n`;
+        msg += `Permalink: ${r.old_permalink} → ${r.new_permalink}\n`;
+        if (r.slug_changed) msg += `Slug: ${r.old_slug} → ${r.new_slug} (collision auto-resolved)\n`;
+        msg += `Internal links rewritten: ${r.internal_links_updated}\n`;
+        msg += `301 redirect created: ${r.redirect_created ? 'yes' : 'no'}\n`;
+        msg += `Rewrite rules flushed: ${r.rewrites_flushed ? 'yes' : 'no'}`;
+        return ok(msg);
     }
 
     case 'update_post': {

package/package.json

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