@wplaunchify/ml-mcp-server 2.7.10 → 2.7.12

package/build/tools/fluent-crm.js

@@ -95,6 +95,31 @@ const createTemplateSchema = z.object({
     email_subject: z.string().optional(),
     design_template: z.enum(['simple', 'plain', 'classic', 'raw_classic', 'raw_html']).optional(),
 });
+// Note / Activity schemas
+const noteTypeSchema = z.enum(['note', 'call', 'email', 'meeting', 'activity']);
+const listNotesSchema = z.object({
+    id: z.number(),
+    per_page: z.number().optional(),
+    page: z.number().optional(),
+    type: noteTypeSchema.optional(),
+});
+const createNoteSchema = z.object({
+    id: z.number(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    type: noteTypeSchema.optional(),
+});
+const updateNoteSchema = z.object({
+    id: z.number(),
+    note_id: z.number(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    type: noteTypeSchema.optional(),
+});
+const deleteNoteSchema = z.object({
+    id: z.number(),
+    note_id: z.number(),
+});
 // ==================== TOOL DEFINITIONS ====================
 export const fluentCRMTools = [
     // Contact Management
@@ -298,6 +323,27 @@ export const fluentCRMTools = [
         description: 'Delete a FluentCRM email template',
         inputSchema: { type: 'object', properties: z.object({ id: z.number() }).shape }
     },
+    // Contact Notes / Activities
+    {
+        name: 'fcrm_list_notes',
+        description: 'List notes and activities for a FluentCRM contact. Filter by type: note, call, email, meeting, activity.',
+        inputSchema: { type: 'object', properties: listNotesSchema.shape }
+    },
+    {
+        name: 'fcrm_create_note',
+        description: 'Create a note or activity on a FluentCRM contact. Supports HTML in description.',
+        inputSchema: { type: 'object', properties: createNoteSchema.shape }
+    },
+    {
+        name: 'fcrm_update_note',
+        description: 'Update a note or activity on a FluentCRM contact.',
+        inputSchema: { type: 'object', properties: updateNoteSchema.shape }
+    },
+    {
+        name: 'fcrm_delete_note',
+        description: 'Delete a note or activity from a FluentCRM contact.',
+        inputSchema: { type: 'object', properties: deleteNoteSchema.shape }
+    },
 ];
 // ==================== TOOL HANDLERS ====================
 export const fluentCRMHandlers = {
@@ -661,4 +707,53 @@ export const fluentCRMHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    // Contact Notes / Activities handlers
+    fcrm_list_notes: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.per_page)
+                params.append('per_page', args.per_page);
+            if (args.page)
+                params.append('page', args.page);
+            if (args.type)
+                params.append('type', args.type);
+            const q = params.toString();
+            const path = `fc-manager/v1/fcrm/contacts/${args.id}/notes` + (q ? `?${q}` : '');
+            const response = await makeWordPressRequest('GET', path);
+            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_create_note: async (args) => {
+        try {
+            const { id, ...data } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/contacts/${id}/notes`, data);
+            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_update_note: async (args) => {
+        try {
+            const { id, note_id, ...data } = args;
+            const response = await makeWordPressRequest('PUT', `fc-manager/v1/fcrm/contacts/${id}/notes/${note_id}`, data);
+            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_delete_note: async (args) => {
+        try {
+            const { id, note_id } = args;
+            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/contacts/${id}/notes/${note_id}`);
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
 };

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.10",
+  "version": "2.7.12",
   "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",