@wplaunchify/ml-mcp-server 2.7.1 → 2.7.3

package/build/tools/fluent-crm.js

@@ -105,6 +105,50 @@ export const fluentCRMTools = [
         description: 'Delete a FluentCRM contact',
         inputSchema: { type: 'object', properties: z.object({ id: z.number() }).shape }
     },
+    // Contact Tag Management
+    {
+        name: 'fcrm_get_contact_tags',
+        description: 'Get all tags attached to a FluentCRM contact',
+        inputSchema: { type: 'object', properties: z.object({ id: z.number() }).shape }
+    },
+    {
+        name: 'fcrm_attach_tags',
+        description: 'Attach tags to an existing FluentCRM contact',
+        inputSchema: { type: 'object', properties: z.object({
+                id: z.number(),
+                tags: z.array(z.number()),
+            }).shape }
+    },
+    {
+        name: 'fcrm_detach_tags',
+        description: 'Remove tags from a FluentCRM contact',
+        inputSchema: { type: 'object', properties: z.object({
+                id: z.number(),
+                tags: z.array(z.number()),
+            }).shape }
+    },
+    // Contact List Management
+    {
+        name: 'fcrm_get_contact_lists',
+        description: 'Get all lists a FluentCRM contact belongs to',
+        inputSchema: { type: 'object', properties: z.object({ id: z.number() }).shape }
+    },
+    {
+        name: 'fcrm_attach_lists',
+        description: 'Add a FluentCRM contact to lists',
+        inputSchema: { type: 'object', properties: z.object({
+                id: z.number(),
+                lists: z.array(z.number()),
+            }).shape }
+    },
+    {
+        name: 'fcrm_detach_lists',
+        description: 'Remove a FluentCRM contact from lists',
+        inputSchema: { type: 'object', properties: z.object({
+                id: z.number(),
+                lists: z.array(z.number()),
+            }).shape }
+    },
     // List Management
     {
         name: 'fcrm_list_lists',
@@ -280,6 +324,66 @@ export const fluentCRMHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    // Contact Tag Management handlers
+    fcrm_get_contact_tags: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/contacts/${args.id}/tags`);
+            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_attach_tags: async (args) => {
+        try {
+            const { id, tags } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/contacts/${id}/tags`, { tags });
+            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_detach_tags: async (args) => {
+        try {
+            const { id, tags } = args;
+            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/contacts/${id}/tags`, { tags });
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
+    // Contact List Management handlers
+    fcrm_get_contact_lists: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/contacts/${args.id}/lists`);
+            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_attach_lists: async (args) => {
+        try {
+            const { id, lists } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/contacts/${id}/lists`, { lists });
+            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_detach_lists: async (args) => {
+        try {
+            const { id, lists } = args;
+            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/contacts/${id}/lists`, { lists });
+            return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
+        }
+    },
     // List handlers
     fcrm_list_lists: async (args) => {
         try {

package/build/tools/index.js

@@ -24,6 +24,7 @@ import { fluentCommunityAdminTools, fluentCommunityAdminHandlers } from './fluen
 import { fluentCommunityCoreTools, fluentCommunityCoreHandlers } from './fluent-community-core.js';
 import { fluentCommunityLearningTools, fluentCommunityLearningHandlers } from './fluent-community-learning.js';
 import { fluentMcpProTools, fluentMcpProHandlers } from './fluent-mcp-pro.js';
+import { mlSocialTools, mlSocialHandlers } from './ml-social.js';
 // Tool categories for selective loading
 const toolCategories = {
     wordpress: [
@@ -37,7 +38,8 @@ const toolCategories = {
         ...mlCanvasTools,
         ...mlSimpleSiteTools,
         ...mlImageEditorTools, // AI image generation via ML Image Editor
-        ...mlMediaHubTools // Image search & icon import via ML Media Hub P2P
+        ...mlMediaHubTools, // Image search & icon import via ML Media Hub P2P
+        ...mlSocialTools // Social media publishing via ML Social
     ],
     // Full FluentCommunity (91 tools) - legacy support
     fluentcommunity: [
@@ -80,7 +82,7 @@ const toolCategories = {
     ]
 };
 const handlerCategories = {
-    // WP (ENABLED_TOOLS=wordpress) - 45+ tools (includes ML Image Editor & Media Hub)
+    // WP (ENABLED_TOOLS=wordpress) - 45+ tools (includes ML Image Editor & Media Hub & Social)
     wordpress: {
         ...unifiedContentHandlers,
         ...unifiedTaxonomyHandlers,
@@ -92,7 +94,8 @@ const handlerCategories = {
         ...mlCanvasHandlers, // ML Canvas Block tools
         ...mlSimpleSiteHandlers, // ML Simple Site tools
         ...mlImageEditorHandlers, // AI image generation
-        ...mlMediaHubHandlers // Image search & icon import
+        ...mlMediaHubHandlers, // Image search & icon import
+        ...mlSocialHandlers // Social media publishing
     },
     fluentcommunity: {
         ...fluentCommunityHandlers,

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

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+export declare const mlSocialTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            content: z.ZodString;
+            platforms: z.ZodArray<z.ZodObject<{
+                accountId: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                accountId: string;
+            }, {
+                accountId: string;
+            }>, "many">;
+            mediaItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                type: z.ZodEnum<["image", "video"]>;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                type: "image" | "video";
+            }, {
+                url: string;
+                type: "image" | "video";
+            }>, "many">>;
+            scheduledFor: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+            publishNow: z.ZodOptional<z.ZodBoolean>;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: z.ZodOptional<z.ZodNumber>;
+        };
+    };
+})[];
+export declare const mlSocialHandlers: {
+    social_status: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    social_accounts: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    social_publish: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    social_posts: (args: any) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+};

package/build/tools/ml-social.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+import { makeWordPressRequest } from '../wordpress.js';
+// ML Social Tools - Social Media Publishing via Late API
+// Requires ML Social plugin on WordPress
+export const mlSocialTools = [
+    {
+        name: 'social_status',
+        description: 'Check ML Social connection status - returns whether Late API is configured and connected, plus account/platform counts',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'social_accounts',
+        description: 'List all connected social media accounts with their IDs, platforms, and usernames. Use these account IDs when publishing posts.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'social_publish',
+        description: 'Publish content to one or more social media platforms. Supports immediate posting or scheduling. First call social_accounts to get valid account IDs.',
+        inputSchema: { type: 'object', properties: z.object({
+                content: z.string().describe('Post text content (required). Platform character limits: Twitter 280, LinkedIn 3000, Instagram 2200'),
+                platforms: z.array(z.object({
+                    accountId: z.string().describe('Account ID from social_accounts'),
+                })).describe('Array of platform objects. Each must have accountId from social_accounts.'),
+                mediaItems: z.array(z.object({
+                    url: z.string().describe('Public URL to image or video'),
+                    type: z.enum(['image', 'video']).describe('Media type'),
+                })).optional().describe('Optional array of media attachments'),
+                scheduledFor: z.string().optional().describe('Optional ISO 8601 timestamp to schedule post (e.g., 2026-02-05T09:00:00Z)'),
+                timezone: z.string().optional().describe('Optional timezone for scheduled posts (e.g., America/Chicago)'),
+                publishNow: z.boolean().optional().describe('Set to true to publish immediately (default). Set to false with scheduledFor to schedule.'),
+            }).shape },
+    },
+    {
+        name: 'social_posts',
+        description: 'List recent social media posts created through ML Social. Shows post content, platforms, status, and timestamps.',
+        inputSchema: { type: 'object', properties: z.object({
+                limit: z.number().optional().describe('Number of posts to return (default: 20, max: 100)'),
+            }).shape },
+    },
+];
+export const mlSocialHandlers = {
+    social_status: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', 'ml-social/v1/status');
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error checking social status: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    social_accounts: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', 'ml-social/v1/accounts');
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error listing social accounts: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    social_publish: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'ml-social/v1/post', args);
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error publishing to social: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+    social_posts: async (args) => {
+        try {
+            const params = args.limit ? `?limit=${args.limit}` : '';
+            const response = await makeWordPressRequest('GET', `ml-social/v1/posts${params}`);
+            return {
+                toolResult: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            return {
+                toolResult: {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Error listing social posts: ${error.message}`
+                        }]
+                }
+            };
+        }
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.7.1",
+  "version": "2.7.3",
   "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",