@wplaunchify/ml-mcp-server 2.7.11 → 2.7.13

package/build/tools/debug.d.ts

@@ -1,6 +1,23 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 export declare const debugTools: Tool[];
 export declare const debugHandlers: {
+    fmcp_get_site_context: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
     debug_options: (args: any) => Promise<{
         toolResult: {
             content: {

package/build/tools/debug.js

@@ -7,8 +7,14 @@ import { z } from 'zod';
 // Zod Schema Definitions
 const debugOptionsSchema = z.object({});
 const debugFluentCRMSchema = z.object({});
+const siteContextSchema = z.object({});
 // Tool Definitions
 export const debugTools = [
+    {
+        name: 'fmcp_get_site_context',
+        description: 'Site-wide FluentMCP context: installed products, versions, counts, ENABLED_TOOLS categories, discovery URLs. Call first on a new site.',
+        inputSchema: { type: 'object', properties: siteContextSchema.shape }
+    },
     {
         name: 'debug_options',
         description: 'Debug endpoint to find FluentCommunity option names and values',
@@ -22,6 +28,15 @@ export const debugTools = [
 ];
 // Tool Handlers
 export const debugHandlers = {
+    fmcp_get_site_context: async () => {
+        try {
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/mcp/site-context');
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
     debug_options: async (args) => {
         try {
             const response = await makeWordPressRequest('GET', 'fc-manager/v1/debug/options');

package/build/tools/fluent-crm.js

@@ -344,6 +344,16 @@ export const fluentCRMTools = [
         description: 'Delete a note or activity from a FluentCRM contact.',
         inputSchema: { type: 'object', properties: deleteNoteSchema.shape }
     },
+    {
+        name: 'fcrm_get_crm_context',
+        description: 'FluentCRM context: versions, counts, contact statuses, note types, custom fields schema, canonical /fcrm endpoints.',
+        inputSchema: { type: 'object', properties: z.object({}).shape }
+    },
+    {
+        name: 'fcrm_estimate_contacts',
+        description: 'Count FluentCRM contacts matching filters without loading full list (same filters as fcrm_list_contacts).',
+        inputSchema: { type: 'object', properties: listContactsSchema.shape }
+    },
 ];
 // ==================== TOOL HANDLERS ====================
 export const fluentCRMHandlers = {
@@ -748,8 +758,33 @@ export const fluentCRMHandlers = {
     },
     fcrm_delete_note: async (args) => {
         try {
-            const { id, note_id } = args;
-            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/contacts/${id}/notes/${note_id}`);
+            const { id, note_id, ...rest } = args;
+            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/contacts/${id}/notes/${note_id}`, rest);
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
+    fcrm_get_crm_context: async () => {
+        try {
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcrm/context');
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
+    fcrm_estimate_contacts: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.search)
+                params.append('search', args.search);
+            if (args.status)
+                params.append('status', args.status);
+            const q = params.toString();
+            const path = 'fc-manager/v1/fcrm/contacts/estimate' + (q ? `?${q}` : '');
+            const response = await makeWordPressRequest('GET', path);
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {

package/build/tools/index.js

@@ -40,6 +40,7 @@ const toolCategories = {
         ...mlImageEditorTools, // AI image generation via ML Image Editor
         ...mlMediaHubTools, // Image search & icon import via ML Media Hub P2P
         ...mlSocialTools, // Social media publishing via ML Social
+        ...debugTools, // fmcp_get_site_context (v2.7.0)
         ...fluentMcpProTools // FluentMCP Pro (WooCommerce, file system, database, etc.)
     ],
     // Full FluentCommunity (91 tools) - legacy support
@@ -97,6 +98,7 @@ const handlerCategories = {
         ...mlImageEditorHandlers, // AI image generation
         ...mlMediaHubHandlers, // Image search & icon import
         ...mlSocialHandlers, // Social media publishing
+        ...debugHandlers, // fmcp_get_site_context
         ...fluentMcpProHandlers // FluentMCP Pro (WooCommerce, file system, database, etc.)
     },
     fluentcommunity: {

package/build/tools/ml-canvas.d.ts

@@ -8,10 +8,12 @@ export declare const mlCanvasTools: ({
             title: z.ZodString;
             html: z.ZodOptional<z.ZodString>;
             css: z.ZodOptional<z.ZodString>;
+            post_type: z.ZodOptional<z.ZodEnum<["page", "post"]>>;
             hideHeader: z.ZodOptional<z.ZodBoolean>;
             hideFooter: z.ZodOptional<z.ZodBoolean>;
             canvasMode: z.ZodOptional<z.ZodBoolean>;
             hideTitle: z.ZodOptional<z.ZodBoolean>;
+            dequeueKadenceGlobal: z.ZodOptional<z.ZodBoolean>;
             status: z.ZodOptional<z.ZodEnum<["draft", "publish"]>>;
         };
     };
@@ -26,6 +28,7 @@ export declare const mlCanvasTools: ({
             replace_html: z.ZodOptional<z.ZodString>;
             find_css: z.ZodOptional<z.ZodString>;
             replace_css: z.ZodOptional<z.ZodString>;
+            dequeueKadenceGlobal: z.ZodOptional<z.ZodBoolean>;
         };
     };
 } | {

package/build/tools/ml-canvas.js

@@ -4,27 +4,30 @@ import { makeWordPressRequest } from '../wordpress.js';
 export const mlCanvasTools = [
     {
         name: 'mlcanvas_create_page',
-        description: 'Create a custom HTML/CSS page using ML Canvas Block. Perfect for landing pages, full-width designs, and custom layouts. No block recovery needed!',
+        description: 'Create a custom HTML/CSS page using ML Canvas Block. IMPORTANT CSS RULES: (1) Do NOT generate <html> or <body> tags - start at your wrapper div. (2) Set backgrounds on .container (or your own class), NEVER on body. (3) Use class-based selectors (.hero h1) not bare elements (h1). For full custom pages, set hideHeader, hideFooter, hideTitle, canvasMode, and dequeueKadenceGlobal all to true.',
         inputSchema: { type: 'object', properties: z.object({
                 title: z.string().describe('Page title (required)'),
-                html: z.string().optional().describe('Custom HTML content'),
-                css: z.string().optional().describe('Custom CSS styles'),
+                html: z.string().optional().describe('Custom HTML content. Start with a wrapper div like <div class="container">. Do NOT include <html> or <body> tags.'),
+                css: z.string().optional().describe('Custom CSS styles. Target .container for page backgrounds, NOT body. Use class-based selectors for headings.'),
+                post_type: z.enum(['page', 'post']).optional().describe('Content type: page (default) or post'),
                 hideHeader: z.boolean().optional().describe('Hide site header'),
                 hideFooter: z.boolean().optional().describe('Hide site footer'),
                 canvasMode: z.boolean().optional().describe('Full-width canvas mode (100% width, zero padding)'),
                 hideTitle: z.boolean().optional().describe('Hide page title/hero section'),
+                dequeueKadenceGlobal: z.boolean().optional().describe('Remove Kadence theme global CSS to prevent heading/color overrides. Recommended true for custom designs.'),
                 status: z.enum(['draft', 'publish']).optional().describe('Page status (default: draft)'),
             }).shape },
     },
     {
         name: 'mlcanvas_edit_page',
-        description: 'Surgical editing for ML Canvas pages - find/replace specific HTML/CSS snippets without rewriting entire page. Works on ANY post type with ML Canvas block.',
+        description: 'Surgical editing for ML Canvas pages - find/replace specific HTML/CSS snippets without rewriting entire page. Works on ANY post type with ML Canvas block. Can also toggle page settings like dequeueKadenceGlobal.',
         inputSchema: { type: 'object', properties: z.object({
                 page_id: z.number().describe('Page/Post ID to edit (required)'),
                 find_html: z.string().optional().describe('HTML string to find and replace'),
                 replace_html: z.string().optional().describe('New HTML to replace with'),
                 find_css: z.string().optional().describe('CSS string to find and replace'),
                 replace_css: z.string().optional().describe('New CSS to replace with'),
+                dequeueKadenceGlobal: z.boolean().optional().describe('Remove Kadence theme global CSS on this page'),
             }).shape },
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.7.11",
+  "version": "2.7.13",
   "description": "Universal MCP Server for WordPress + Fluent Suite (Community, CRM, Cart) + FluentMCP Pro. Comprehensive tools for AI-powered WordPress management via Claude, Cursor, and other MCP clients.",
   "type": "module",
   "main": "./build/server.js",