@wplaunchify/ml-mcp-server 2.7.13 → 2.7.16

package/build/tools/fluent-cart-analytics.js

@@ -73,7 +73,7 @@ export const fluentCartAnalyticsHandlers = {
                 params.date_from = args.date_from;
             if (args.date_to)
                 params.date_to = args.date_to;
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/reports/overview', params);
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/reports/overview', params);
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -82,7 +82,7 @@ export const fluentCartAnalyticsHandlers = {
     },
     fcart_get_quick_stats: async (args) => {
         try {
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/reports/quick-stats');
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/reports/quick-stats');
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -91,7 +91,7 @@ export const fluentCartAnalyticsHandlers = {
     },
     fcart_get_dashboard_stats: async (args) => {
         try {
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/dashboard/stats');
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/dashboard/stats');
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -107,7 +107,7 @@ export const fluentCartAnalyticsHandlers = {
                 params.date_to = args.date_to;
             if (args.type)
                 params.type = args.type;
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/analytics', params);
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/analytics', params);
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -116,7 +116,7 @@ export const fluentCartAnalyticsHandlers = {
     },
     fcart_get_settings: async (args) => {
         try {
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/settings');
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/settings');
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -130,7 +130,7 @@ export const fluentCartAnalyticsHandlers = {
                 params.per_page = args.per_page;
             if (args.page)
                 params.page = args.page;
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/tax/classes', params);
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/tax/classes', params);
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {
@@ -139,7 +139,7 @@ export const fluentCartAnalyticsHandlers = {
     },
     fcart_list_shipping_zones: async (args) => {
         try {
-            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fluentcart/shipping/zones');
+            const response = await makeWordPressRequest('GET', 'fc-manager/v1/fcart/shipping/zones');
             return { toolResult: { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] } };
         }
         catch (error) {

package/build/tools/fluent-crm.js

@@ -120,6 +120,76 @@ const deleteNoteSchema = z.object({
     id: z.number(),
     note_id: z.number(),
 });
+const dryRunSchema = z.object({ dry_run: z.boolean().optional() });
+const upsertContactSchema = createContactSchema.extend({
+    id: z.number().optional(),
+    force_update: z.boolean().optional(),
+    detach_tags: z.array(z.union([z.number(), z.string()])).optional(),
+    detach_lists: z.array(z.union([z.number(), z.string()])).optional(),
+});
+const bulkUpsertContactsSchema = z.object({
+    contacts: z.array(z.record(z.any())),
+    force_update: z.boolean().optional(),
+    double_optin: z.boolean().optional(),
+    dry_run: z.boolean().optional(),
+});
+const applySegmentsSchema = z.object({
+    contact_ids: z.array(z.number()).optional(),
+    subscriber_ids: z.array(z.number()).optional(),
+    search: z.string().optional(),
+    status: fluentCrmContactStatusSchema.optional(),
+    attach_tags: z.array(z.union([z.number(), z.string()])).optional(),
+    detach_tags: z.array(z.union([z.number(), z.string()])).optional(),
+    tags: z.array(z.union([z.number(), z.string()])).optional(),
+    attach_lists: z.array(z.union([z.number(), z.string()])).optional(),
+    detach_lists: z.array(z.union([z.number(), z.string()])).optional(),
+    lists: z.array(z.union([z.number(), z.string()])).optional(),
+    dry_run: z.boolean().optional(),
+});
+const upsertCampaignSchema = createCampaignSchema.extend({
+    id: z.number().optional(),
+});
+const changeCampaignStatusSchema = z.object({
+    id: z.number(),
+    action: z.enum(['pause', 'resume', 'duplicate', 'schedule', 'send', 'delete']),
+    scheduled_at: z.string().optional(),
+    dry_run: z.boolean().optional(),
+});
+const sendTestEmailSchema = z.object({
+    id: z.number(),
+    email: z.string().email().optional(),
+});
+const sendEmailToContactSchema = z.object({
+    id: z.number(),
+    campaign: z.record(z.any()),
+});
+const listAutomationsSchema = z.object({
+    page: z.number().optional(),
+    per_page: z.number().optional(),
+    search: z.string().optional(),
+});
+const getSequenceSchema = z.object({
+    id: z.number(),
+    include_email_bodies: z.boolean().optional(),
+});
+const manageSequenceSubscribersSchema = z.object({
+    id: z.number(),
+    action: z.enum(['subscribe', 'unsubscribe']).optional(),
+    contact_ids: z.array(z.number()).optional(),
+    subscriber_ids: z.array(z.number()).optional(),
+    subscribers: z.record(z.any()).optional(),
+    dry_run: z.boolean().optional(),
+});
+const updateAutomationStatusSchema = z.object({
+    id: z.number(),
+    contact_id: z.number(),
+    status: z.string(),
+});
+const previewDeleteIdSchema = z.object({ id: z.number() });
+const previewDeleteNoteSchema = z.object({
+    id: z.number(),
+    note_id: z.number(),
+});
 // ==================== TOOL DEFINITIONS ====================
 export const fluentCRMTools = [
     // Contact Management
@@ -354,6 +424,111 @@ export const fluentCRMTools = [
         description: 'Count FluentCRM contacts matching filters without loading full list (same filters as fcrm_list_contacts).',
         inputSchema: { type: 'object', properties: listContactsSchema.shape }
     },
+    {
+        name: 'fcrm_upsert_contact',
+        description: 'Create or update a FluentCRM contact by id or email (single upsert).',
+        inputSchema: { type: 'object', properties: upsertContactSchema.shape }
+    },
+    {
+        name: 'fcrm_bulk_upsert_contacts',
+        description: 'Batch create/update up to 500 contacts. Set dry_run true to preview only.',
+        inputSchema: { type: 'object', properties: bulkUpsertContactsSchema.shape }
+    },
+    {
+        name: 'fcrm_apply_segments_to_contacts',
+        description: 'Bulk attach/detach tags and lists by contact IDs or search/status filters. dry_run previews ID lists.',
+        inputSchema: { type: 'object', properties: applySegmentsSchema.shape }
+    },
+    {
+        name: 'fcrm_upsert_campaign',
+        description: 'Create or update a FluentCRM campaign (pass id in body to update).',
+        inputSchema: { type: 'object', properties: upsertCampaignSchema.shape }
+    },
+    {
+        name: 'fcrm_change_campaign_status',
+        description: 'Change campaign state: pause, resume, duplicate, schedule, send, or delete.',
+        inputSchema: { type: 'object', properties: changeCampaignStatusSchema.shape }
+    },
+    {
+        name: 'fcrm_send_test_email',
+        description: 'Send a test copy of a campaign email.',
+        inputSchema: { type: 'object', properties: sendTestEmailSchema.shape }
+    },
+    {
+        name: 'fcrm_send_email_to_contact',
+        description: 'Send a one-off custom email to one contact (campaign object with subject and body).',
+        inputSchema: { type: 'object', properties: sendEmailToContactSchema.shape }
+    },
+    {
+        name: 'fcrm_preview_delete_contact',
+        description: 'Preview deleting a contact (dry run, no changes).',
+        inputSchema: { type: 'object', properties: previewDeleteIdSchema.shape }
+    },
+    {
+        name: 'fcrm_preview_delete_list',
+        description: 'Preview deleting a list (dry run).',
+        inputSchema: { type: 'object', properties: previewDeleteIdSchema.shape }
+    },
+    {
+        name: 'fcrm_preview_delete_tag',
+        description: 'Preview deleting a tag (dry run).',
+        inputSchema: { type: 'object', properties: previewDeleteIdSchema.shape }
+    },
+    {
+        name: 'fcrm_preview_delete_note',
+        description: 'Preview deleting a contact note (dry run).',
+        inputSchema: { type: 'object', properties: previewDeleteNoteSchema.shape }
+    },
+    {
+        name: 'fcrm_list_automations',
+        description: 'List FluentCRM automation funnels.',
+        inputSchema: { type: 'object', properties: listAutomationsSchema.shape }
+    },
+    {
+        name: 'fcrm_get_automation',
+        description: 'Get a FluentCRM automation funnel by ID.',
+        inputSchema: { type: 'object', properties: campaignIdSchema.shape }
+    },
+    {
+        name: 'fcrm_list_funnel_subscribers',
+        description: 'List contacts enrolled in an automation funnel.',
+        inputSchema: { type: 'object', properties: z.object({
+                id: z.number(),
+                page: z.number().optional(),
+                per_page: z.number().optional(),
+                search: z.string().optional(),
+            }).shape }
+    },
+    {
+        name: 'fcrm_update_contact_automation_status',
+        description: 'Update a contact status inside an automation funnel.',
+        inputSchema: { type: 'object', properties: updateAutomationStatusSchema.shape }
+    },
+    {
+        name: 'fcrm_list_sequences',
+        description: 'List email sequences (FluentCampaign Pro).',
+        inputSchema: { type: 'object', properties: listAutomationsSchema.shape }
+    },
+    {
+        name: 'fcrm_get_sequence',
+        description: 'Get an email sequence by ID. include_email_bodies loads sequence emails.',
+        inputSchema: { type: 'object', properties: getSequenceSchema.shape }
+    },
+    {
+        name: 'fcrm_manage_sequence_subscribers',
+        description: 'Subscribe or unsubscribe contacts on a sequence (max 5000 IDs; dry_run for ID preview).',
+        inputSchema: { type: 'object', properties: manageSequenceSubscribersSchema.shape }
+    },
+    {
+        name: 'fcrm_estimate_dynamic_segment',
+        description: 'Count contacts matching segment filters without returning rows (FluentCampaign Pro).',
+        inputSchema: { type: 'object', properties: z.object({
+                subscribers: z.record(z.any()).optional(),
+                sending_filter: z.string().optional(),
+                dynamic_segment: z.record(z.any()).optional(),
+                advanced_filters: z.array(z.any()).optional(),
+            }).shape }
+    },
 ];
 // ==================== TOOL HANDLERS ====================
 export const fluentCRMHandlers = {
@@ -617,6 +792,16 @@ export const fluentCRMHandlers = {
         }
     },
     fcrm_send_campaign: async (args) => {
+        try {
+            const { id, ...data } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/campaigns/${id}/send`, 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_campaign: async (args) => {
         try {
             const { id, ...data } = args;
             const response = await makeWordPressRequest('PUT', `fc-manager/v1/fcrm/campaigns/${id}`, data);
@@ -626,6 +811,15 @@ export const fluentCRMHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    fcrm_delete_campaign: async (args) => {
+        try {
+            const response = await makeWordPressRequest('DELETE', `fc-manager/v1/fcrm/campaigns/${args.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}` }] } };
+        }
+    },
     fcrm_get_campaign_stats: async (args) => {
         try {
             const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/campaigns/${args.id}/stats`);
@@ -791,4 +985,209 @@ export const fluentCRMHandlers = {
             return { toolResult: { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] } };
         }
     },
+    fcrm_upsert_contact: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/fcrm/contacts/upsert', args);
+            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_bulk_upsert_contacts: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/fcrm/contacts/bulk-upsert', args);
+            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_apply_segments_to_contacts: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/fcrm/contacts/apply-segments', args);
+            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_upsert_campaign: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/fcrm/campaigns/upsert', args);
+            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_change_campaign_status: async (args) => {
+        try {
+            const { id, ...data } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/campaigns/${id}/status`, 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_send_test_email: async (args) => {
+        try {
+            const { id, ...data } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/campaigns/${id}/send-test`, 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_send_email_to_contact: async (args) => {
+        try {
+            const { id, campaign } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/contacts/${id}/send-email`, { campaign });
+            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_preview_delete_contact: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/contacts/${args.id}/delete-preview`);
+            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_preview_delete_list: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/lists/${args.id}/delete-preview`);
+            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_preview_delete_tag: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/tags/${args.id}/delete-preview`);
+            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_preview_delete_note: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/contacts/${args.id}/notes/${args.note_id}/delete-preview`);
+            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_list_automations: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.page)
+                params.append('page', String(args.page));
+            if (args.per_page)
+                params.append('per_page', String(args.per_page));
+            if (args.search)
+                params.append('search', args.search);
+            const q = params.toString();
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/automations${q ? `?${q}` : ''}`);
+            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_automation: async (args) => {
+        try {
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/automations/${args.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}` }] } };
+        }
+    },
+    fcrm_list_funnel_subscribers: async (args) => {
+        try {
+            const { id, ...rest } = args;
+            const params = new URLSearchParams();
+            if (rest.page)
+                params.append('page', String(rest.page));
+            if (rest.per_page)
+                params.append('per_page', String(rest.per_page));
+            if (rest.search)
+                params.append('search', rest.search);
+            const q = params.toString();
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/automations/${id}/subscribers${q ? `?${q}` : ''}`);
+            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_contact_automation_status: async (args) => {
+        try {
+            const { id, contact_id, status } = args;
+            const response = await makeWordPressRequest('PUT', `fc-manager/v1/fcrm/automations/${id}/contacts/${contact_id}/status`, { status });
+            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_list_sequences: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.page)
+                params.append('page', String(args.page));
+            if (args.per_page)
+                params.append('per_page', String(args.per_page));
+            if (args.search)
+                params.append('search', args.search);
+            const q = params.toString();
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/sequences${q ? `?${q}` : ''}`);
+            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_sequence: async (args) => {
+        try {
+            const params = new URLSearchParams();
+            if (args.include_email_bodies)
+                params.append('include_email_bodies', 'true');
+            const q = params.toString();
+            const response = await makeWordPressRequest('GET', `fc-manager/v1/fcrm/sequences/${args.id}${q ? `?${q}` : ''}`);
+            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_manage_sequence_subscribers: async (args) => {
+        try {
+            const { id, ...data } = args;
+            const response = await makeWordPressRequest('POST', `fc-manager/v1/fcrm/sequences/${id}/subscribers`, 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_estimate_dynamic_segment: async (args) => {
+        try {
+            const response = await makeWordPressRequest('POST', 'fc-manager/v1/fcrm/segments/estimate', args);
+            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/package.json

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