@agifyai/leadify-mcp 8.5.2 → 8.5.3

package/README.md

@@ -219,7 +219,8 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `get_campaign_logs` | Récupérer les logs de campagne avec filtres et pagination. |
 | `delete_campaign_log` | Supprimer une entrée de log de campagne. |
 | `update_campaign_stats` | Mettre à jour les statistiques d'email d'une campagne pour un groupe de leads. |
-| `create_campaign` | Créer une campagne DRAFT mono-canal rattachée à un groupe de leads. `channel` (`LINKEDIN` ou `EMAIL`) est obligatoire : aucun défaut LinkedIn implicite. La fenêtre de campagne (`startAt`/`endAt`) et le contrat de clôture ne sont pas encore supportés par l'API Leadify ; ne pas utiliser cet outil pour une campagne bornée dans le temps avant cette livraison. |
+| `create_campaign` | Créer une campagne DRAFT mono-canal rattachée à un groupe de leads. `channel` (`LINKEDIN` ou `EMAIL`) est obligatoire ; `start_at`, `end_at` et `timezone` configurent la fenêtre métier. À `end_at`, Leadify ferme la campagne idempotemment, annule uniquement les jobs prouvablement pré-fournisseur et préserve les autres pour réconciliation. |
+| `update_campaign_configuration` | Corriger le canal ou la fenêtre d'une campagne DRAFT encore ouverte, sans activation ni enrôlement. |
 | `list_campaigns` | Lister compactement les campagnes d'une organisation explicitement sélectionnée et leur statut courant. |
 | `get_campaign` | Récupérer les détails d'une campagne et ses KPIs temps réel. |
 | `update_campaign_status` | Changer le statut d'une campagne (DRAFT, ACTIVE, PAUSED, COMPLETED). |

package/dist/tools/campaigns.d.ts

@@ -2,5 +2,6 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
 type CampaignReadClient = Pick<LeadifyClient, "get">;
 type CampaignWriteClient = Pick<LeadifyClient, "post">;
-export declare function registerCampaignTools(server: McpServer, readClient?: CampaignReadClient, writeClient?: CampaignWriteClient): void;
+type CampaignMutationClient = Pick<LeadifyClient, "put">;
+export declare function registerCampaignTools(server: McpServer, readClient?: CampaignReadClient, writeClient?: CampaignWriteClient, mutationClient?: CampaignMutationClient): void;
 export {};

package/dist/tools/campaigns.js

@@ -19,7 +19,7 @@ function assertCampaignBelongsToOrganization(data, organizationId) {
     }
     return campaign;
 }
-export function registerCampaignTools(server, readClient, writeClient) {
+export function registerCampaignTools(server, readClient, writeClient, mutationClient) {
     // ── update_campaign_stats ──────────────────────────────────────────────
     server.tool("update_campaign_stats", "Update email campaign statistics for a lead group. If the given campaignSlug " +
         "doesn't exist in the group's stats yet, it is created; otherwise provided fields " +
@@ -88,26 +88,33 @@ export function registerCampaignTools(server, readClient, writeClient) {
         }
     });
     // ── create_campaign ────────────────────────────────────────────────────
-    server.tool("create_campaign", "Create a mono-channel DRAFT campaign linked to an existing lead group. channel is required " +
-        "so no campaign silently defaults to LinkedIn. The current Leadify API does not yet persist " +
-        "a campaign start/end window or closure contract: do not use this tool for a time-bounded " +
-        "campaign until that API support is released. Returns the new campaign ID; use " +
-        "update_campaign_status only after the campaign is fully configured and explicitly approved.", {
+    server.tool("create_campaign", "Create a mono-channel DRAFT campaign with an explicit channel, optional ISO-8601 start/end " +
+        "window, and IANA timezone. At endAt Leadify closes the campaign idempotently, cancels only " +
+        "pre-provider jobs, and preserves any provider-barrier job for reconciliation.", {
         name: z.string().describe("Campaign name."),
         lead_group_id: z.string().describe("ID of the lead group to associate."),
         channel: z.enum(["LINKEDIN", "EMAIL"]).describe("Required effective delivery channel. Create separate campaigns for LinkedIn and email."),
+        start_at: z.string().datetime().optional().describe("Optional inclusive campaign start timestamp in ISO-8601 UTC."),
+        end_at: z.string().datetime().optional().describe("Optional exclusive campaign end timestamp in ISO-8601 UTC; must be after start_at."),
+        timezone: z.string().min(1).optional().describe("IANA timezone used for the campaign business window, for example Europe/Paris."),
         description: z.string().optional().describe("Optional description."),
         persona_id: z
             .string()
             .optional()
             .describe("ID of the persona to assign (optional)."),
-    }, async ({ name, lead_group_id, channel, description, persona_id }) => {
+    }, async ({ name, lead_group_id, channel, start_at, end_at, timezone, description, persona_id }) => {
         try {
             const body = {
                 name,
                 leadGroupId: lead_group_id,
                 channel,
             };
+            if (start_at !== undefined)
+                body.startAt = start_at;
+            if (end_at !== undefined)
+                body.endAt = end_at;
+            if (timezone !== undefined)
+                body.timezone = timezone;
             if (description !== undefined)
                 body.description = description;
             if (persona_id !== undefined)
@@ -119,6 +126,29 @@ export function registerCampaignTools(server, readClient, writeClient) {
             return handleToolError(error);
         }
     });
+    server.tool("update_campaign_configuration", "Correct an open DRAFT campaign's channel or lifecycle window before activation. This tool refuses ACTIVE, PAUSED, COMPLETED, or closed campaigns and never activates or enrolls prospects.", {
+        id: z.string().describe("Campaign ID."),
+        channel: z.enum(["LINKEDIN", "EMAIL"]).optional(),
+        start_at: z.string().datetime().nullable().optional(),
+        end_at: z.string().datetime().nullable().optional(),
+        timezone: z.string().min(1).optional(),
+    }, async ({ id, channel, start_at, end_at, timezone }) => {
+        try {
+            const body = {};
+            if (channel !== undefined)
+                body.channel = channel;
+            if (start_at !== undefined)
+                body.startAt = start_at;
+            if (end_at !== undefined)
+                body.endAt = end_at;
+            if (timezone !== undefined)
+                body.timezone = timezone;
+            return toolResult(await (mutationClient ?? getClient()).put(`/api/campaign/${encodeURIComponent(id)}/configuration`, body));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── get_campaign ───────────────────────────────────────────────────────
     server.tool("get_campaign", "Retrieve a campaign chosen from list_campaigns, scoped to the explicitly selected " +
         "organization. Includes its normalized current status (DRAFT, ACTIVE, PAUSED, or COMPLETED) " +

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export declare const MCP_SERVER_NAME = "leadify";
-export declare const MCP_VERSION = "8.5.2";
+export declare const MCP_VERSION = "8.5.3";

package/dist/version.js

@@ -1,3 +1,3 @@
 export const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export const MCP_SERVER_NAME = "leadify";
-export const MCP_VERSION = "8.5.2";
+export const MCP_VERSION = "8.5.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "8.5.2",
+  "version": "8.5.3",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",