@wplaunchify/ml-mcp-server 2.7.7 → 2.7.9

package/build/tools/fluent-crm.js

@@ -6,12 +6,20 @@ import { makeWordPressRequest } from '../wordpress.js';
  * Proxies to FluentCRM's database via WordPress plugin
  */
 // ==================== ZOD SCHEMA DEFINITIONS ====================
+const fluentCrmContactStatusSchema = z.enum([
+    'subscribed',
+    'pending',
+    'unsubscribed',
+    'bounced',
+    'complained',
+    'transactional',
+]);
 // Contact schemas
 const listContactsSchema = z.object({
     page: z.number().optional(),
     per_page: z.number().optional(),
     search: z.string().optional(),
-    status: z.enum(['subscribed', 'unsubscribed', 'bounced', 'complained']).optional(),
+    status: fluentCrmContactStatusSchema.optional(),
     tags: z.array(z.number()).optional(),
     lists: z.array(z.number()).optional(),
 });
@@ -19,11 +27,18 @@ const createContactSchema = z.object({
     email: z.string().email(),
     first_name: z.string().optional(),
     last_name: z.string().optional(),
-    status: z.enum(['subscribed', 'unsubscribed', 'pending']).optional(),
+    status: fluentCrmContactStatusSchema.optional(),
     tags: z.array(z.number()).optional(),
     lists: z.array(z.number()).optional(),
     custom_fields: z.record(z.any()).optional(),
 });
+const updateContactSchema = z.object({
+    id: z.number(),
+    email: z.string().email().optional(),
+    first_name: z.string().optional(),
+    last_name: z.string().optional(),
+    status: fluentCrmContactStatusSchema.optional(),
+});
 // List schemas
 const listListsSchema = z.object({
     page: z.number().optional(),
@@ -59,6 +74,15 @@ const createCampaignSchema = z.object({
     status: z.enum(['draft', 'scheduled']).optional(),
     scheduled_at: z.string().optional(),
 });
+const campaignIdSchema = z.object({ id: z.number() });
+const campaignLinksSchema = z.object({
+    id: z.number(),
+    limit: z.number().int().positive().optional(),
+});
+const campaignClickersSchema = z.object({
+    id: z.number(),
+    include_contact: z.boolean().optional(),
+});
 // Template schemas
 const listTemplatesSchema = z.object({
     page: z.number().optional(),
@@ -92,13 +116,7 @@ export const fluentCRMTools = [
     {
         name: 'fcrm_update_contact',
         description: 'Update an existing FluentCRM contact',
-        inputSchema: { type: 'object', properties: z.object({
-                id: z.number(),
-                email: z.string().email().optional(),
-                first_name: z.string().optional(),
-                last_name: z.string().optional(),
-                status: z.enum(['subscribed', 'unsubscribed', 'pending']).optional(),
-            }).shape }
+        inputSchema: { type: 'object', properties: updateContactSchema.shape }
     },
     {
         name: 'fcrm_delete_contact',
@@ -218,7 +236,22 @@ export const fluentCRMTools = [
     {
         name: 'fcrm_get_campaign',
         description: 'Get a specific FluentCRM campaign by ID',
-        inputSchema: { type: 'object', properties: z.object({ id: z.number() }).shape }
+        inputSchema: { type: 'object', properties: campaignIdSchema.shape }
+    },
+    {
+        name: 'fcrm_get_campaign_stats',
+        description: 'Get FluentCRM campaign analytics: sends, opens, clicks, rates, unsubscribes (requires FluentMCP REST route fc-manager/v1/fcrm/campaigns/{id}/stats)',
+        inputSchema: { type: 'object', properties: campaignIdSchema.shape }
+    },
+    {
+        name: 'fcrm_get_campaign_links',
+        description: 'Get per-link unique click counts for a FluentCRM campaign (optional limit; default 50 on server; requires FluentMCP route .../campaigns/{id}/links)',
+        inputSchema: { type: 'object', properties: campaignLinksSchema.shape }
+    },
+    {
+        name: 'fcrm_get_campaign_clickers',
+        description: 'List subscribers who clicked links in a campaign; set include_contact true for email and names (requires FluentMCP route .../campaigns/{id}/clickers)',
+        inputSchema: { type: 'object', properties: campaignClickersSchema.shape }
     },
     {
         name: 'fcrm_create_campaign',
@@ -537,6 +570,43 @@ export const fluentCRMHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    fcrm_get_campaign_stats: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/campaigns/${args.id}/stats`);
+            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_campaign_links: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.limit != null)
+                params.append('limit', String(args.limit));
+            const q = params.toString();
+            const path = `fc-manager/v1/fcrm/campaigns/${args.id}/links` + (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_get_campaign_clickers: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.include_contact === true)
+                params.append('include_contact', 'true');
+            const q = params.toString();
+            const path = `fc-manager/v1/fcrm/campaigns/${args.id}/clickers` + (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}` }] } };
+        }
+    },
     // Template handlers
     fcrm_list_templates: async (args) => {
         try {

package/package.json

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