@agifyai/leadify-mcp 8.6.9 → 8.6.11

package/README.md

@@ -235,6 +235,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `get_leads` | Rechercher et lister des leads avec filtres, recherche et pagination, dont le critère composé `event_filter`. |
 | `get_lead` | Récupérer les détails complets d'un lead par son ID. |
 | `update_lead` | Mettre à jour un ou plusieurs champs d'un lead existant. |
+| `clear_lead_field` | Effacer irréversiblement une valeur stockée, sans modifier le schéma du groupe. Exige la confirmation explicite `clear_lead_field`. |
 | `list_events` | Lister les événements tenant-scoped ; les événements archivés sont masqués par défaut. |
 | `get_event` | Lire un événement partagé et son état d’archivage. |
 | `create_event` | Créer un événement partagé avec une clé d’idempotence. |
@@ -246,7 +247,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `preview_reset_ai_fields` / `execute_reset_ai_fields` | Prévisualiser puis effacer irréversiblement les champs IA d'un prospect, d'une liste explicite ou d'un groupe explicite, sans toucher aux contacts, flags manuels, activités ou campagnes. |
 | `delete_leads` | Supprimer définitivement des leads par leurs IDs. |
 | `update_schema` | Ajouter ou modifier les définitions de champs d'un groupe. |
-| `delete_columns` | Supprimer des colonnes du schéma et des données d'un groupe. |
+| `delete_columns` | Supprimer des colonnes du schéma et des données d'un groupe. Avec `force: true`, supprimer aussi une clé de données orpheline absente du schéma. |
 | `update_hidden_columns` | Afficher ou masquer des colonnes dans la vue tableau (réversible). |
 | `list_crm_schema_packs` | Lister le catalogue canonique des CRM Schema Packs, leurs domaines et contraintes de compatibilité. |
 | `add_campaign_log` | Enregistrer une entrée de log de campagne pour un lead. |
@@ -254,10 +255,14 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `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 Lead Group qui possède déjà sa paire Persona–Offre. Aucun `persona_id` ou contexte indépendant n’est accepté au niveau Campagne. `channel` (`LINKEDIN` ou `EMAIL`) est obligatoire ; `start_at` inclusif, `end_at` exclusif et `timezone` IANA configurent la fenêtre métier. À `end_at`, Leadify met la campagne en pause réversible (`WINDOW_END`) sans la clôturer. |
-| `update_campaign_configuration` | Modifier la fenêtre de toute campagne encore `OPEN`; le canal reste modifiable uniquement en DRAFT. Prolonger `end_at` dans le futur ou le supprimer relance automatiquement une pause `WINDOW_END` après validation du fournisseur, mais jamais une pause manuelle. La fenêtre demandée reste enregistrée si cette validation échoue. |
+| `update_campaign` / `update_campaign_configuration` | Modifier le nom, la description et la fenêtre de toute campagne encore `OPEN`; le canal reste modifiable uniquement en DRAFT. Prolonger `end_at` dans le futur ou le supprimer relance automatiquement une pause `WINDOW_END` après validation du fournisseur, mais jamais une pause manuelle. La fenêtre demandée reste enregistrée si cette validation échoue. La Persona est héritée du Lead Group et n’est pas modifiable au niveau Campagne. |
+| `delete_campaign` | Supprimer irréversiblement une campagne `DRAFT` ou `PAUSED` encore `OPEN`, avec la confirmation explicite `delete_campaign`. Une campagne active ou clôturée est refusée, et aucun envoi n’est déclenché. |
 | `list_campaigns` | Lister compactement les campagnes d'une organisation explicitement sélectionnée, avec état effectif, fenêtre, motif de pause et clôture. |
 | `get_campaign` | Récupérer les détails d'une campagne, son état effectif, sa clôture et son éventuel rapport final figé, ainsi que ses KPIs temps réel. |
 | `update_campaign_status` | Changer le statut d'une campagne. `PAUSED` est une pause manuelle réversible ; `COMPLETED` déclenche la clôture définitive terminale et son rapport final immuable. |
+| `get_campaign_audience` | Lire l'audience explicitement enrôlée d'une campagne dans une organisation explicitement sélectionnée, avec les seuls signaux nécessaires à la décision, sans contenu de message ni envoi. |
+| `preview_unenroll_campaign_audience` | Prévisualiser de façon déterministe les membres explicites sans message pour le canal de leur campagne ou sans aucun canal de contact. Retourne les `lead_ids` exacts, sans mutation. |
+| `unenroll_campaign_audience` | Désenrôler uniquement la liste complète de `lead_ids` renvoyée par le preview courant. Relit et refuse toute sélection partielle, étendue ou périmée ; aucun envoi. |
 | `export_campaign` | Exporter les statistiques en CSV ; après clôture définitive, l'export provient du rapport final figé. |
 | `signal_upsert` | Créer ou mettre à jour un signal de business intelligence (INFO, CRITICAL, GOLDEN). Remet le state à `active`. |
 | `signal_expire` | Expirer un signal (événement périmé). Flip de `state` uniquement. |

package/dist/client.js

@@ -22,12 +22,13 @@ export class LeadifyClient {
             init.body = JSON.stringify(body);
         }
         const response = await fetch(url.toString(), init);
+        const text = await response.text();
         let data;
         try {
-            data = await response.json();
+            data = JSON.parse(text);
         }
         catch {
-            data = { raw: await response.text() };
+            data = { raw: text };
         }
         if (!response.ok) {
             throw new LeadifyApiError(response.status, data);

package/dist/tools/campaigns.d.ts

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

package/dist/tools/campaigns.js

@@ -27,7 +27,7 @@ function assertCampaignBelongsToOrganization(data, organizationId) {
     }
     return campaign;
 }
-export function registerCampaignTools(server, readClient, writeClient, mutationClient) {
+export function registerCampaignTools(server, readClient, writeClient, mutationClient, deleteClient) {
     // ── 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 " +
@@ -130,28 +130,50 @@ export function registerCampaignTools(server, readClient, writeClient, mutationC
             return handleToolError(error);
         }
     });
-    server.tool("update_campaign_configuration", "Edit the lifecycle window of any OPEN campaign; changing channel remains limited to DRAFT. " +
+    const registerCampaignUpdateTool = (name, description) => {
+        server.tool(name, description, {
+            id: z.string().describe("Campaign ID."),
+            channel: z.enum(["LINKEDIN", "EMAIL"]).optional().describe("Delivery channel; mutable only while status is DRAFT."),
+            start_at: z.string().datetime().nullable().optional().describe("Inclusive UTC start timestamp, or null to remove the lower bound."),
+            end_at: z.string().datetime().nullable().optional().describe("Exclusive UTC end timestamp, or null to remove the upper bound. A future value or null can auto-resume only a WINDOW_END pause."),
+            timezone: z.string().min(1).optional().describe("IANA timezone used for the business window, for example Europe/Paris."),
+            name: z.string().min(1).optional().describe("New campaign name."),
+            description: z.string().nullable().optional().describe("New campaign description, or null to clear it."),
+        }, async ({ id, channel, start_at, end_at, timezone, name, description }) => {
+            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;
+                if (name !== undefined)
+                    body.name = name;
+                if (description !== undefined)
+                    body.description = description;
+                return toolResult(await (mutationClient ?? getClient()).put(`/api/campaign/${encodeURIComponent(id)}/configuration`, body));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+    };
+    const updateCampaignDescription = "Edit the name, description, and lifecycle window of any OPEN campaign; changing channel remains limited to DRAFT. " +
         "Extending endAt into the future or removing it automatically resumes only a campaign paused " +
         "because WINDOW_END, after provider validation and immediate replanning. A MANUAL pause never " +
         "auto-resumes. The requested window remains saved when provider validation fails, and a CLOSED " +
-        "campaign is terminal.", {
+        "campaign is terminal. Persona is inherited from the Lead Group and cannot be changed here.";
+    registerCampaignUpdateTool("update_campaign", updateCampaignDescription);
+    registerCampaignUpdateTool("update_campaign_configuration", updateCampaignDescription);
+    server.tool("delete_campaign", "Irreversibly delete one OPEN campaign that is DRAFT or PAUSED. Active and permanently closed campaigns are refused. This operation never sends outreach. Always confirm with the user before calling this tool.", {
         id: z.string().describe("Campaign ID."),
-        channel: z.enum(["LINKEDIN", "EMAIL"]).optional().describe("Delivery channel; mutable only while status is DRAFT."),
-        start_at: z.string().datetime().nullable().optional().describe("Inclusive UTC start timestamp, or null to remove the lower bound."),
-        end_at: z.string().datetime().nullable().optional().describe("Exclusive UTC end timestamp, or null to remove the upper bound. A future value or null can auto-resume only a WINDOW_END pause."),
-        timezone: z.string().min(1).optional().describe("IANA timezone used for the business window, for example Europe/Paris."),
-    }, async ({ id, channel, start_at, end_at, timezone }) => {
+        confirmation: z.literal("delete_campaign").describe("Exact acknowledgement required before deleting the campaign."),
+    }, async ({ id }) => {
         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));
+            return toolResult(await (deleteClient ?? getClient()).delete(`/api/campaign/${encodeURIComponent(id)}`));
         }
         catch (error) {
             return handleToolError(error);
@@ -262,6 +284,51 @@ export function registerCampaignTools(server, readClient, writeClient, mutationC
             return handleToolError(error);
         }
     });
+    server.tool("get_campaign_audience", "Read only the explicit audience of a campaign in an explicitly selected organization. " +
+        "Returns decision-safe presence signals, never outreach message content, and never sends.", {
+        organization_id: z.string().describe("Organization selected explicitly via list_organizations."),
+        campaign_id: z.string().describe("Campaign ID selected from list_campaigns or get_campaign."),
+    }, async ({ organization_id, campaign_id }) => {
+        try {
+            return toolResult(await (readClient ?? getClient()).get(`/api/campaign/${encodeURIComponent(campaign_id)}/audience`, new URLSearchParams({ organizationId: organization_id })));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("preview_unenroll_campaign_audience", "Deterministically preview explicit campaign members that can be removed because the campaign-channel message is missing or no delivery channel exists. " +
+        "Read-only, no send, and returns the exact lead_ids required by unenroll_campaign_audience.", {
+        organization_id: z.string().describe("Organization selected explicitly via list_organizations."),
+        campaign_id: z.string().describe("Campaign ID selected from list_campaigns or get_campaign."),
+    }, async ({ organization_id, campaign_id }) => {
+        try {
+            const data = await (readClient ?? getClient()).get(`/api/campaign/${encodeURIComponent(campaign_id)}/audience`, new URLSearchParams({ organizationId: organization_id }));
+            const leadIds = Array.isArray(data.removableLeadIds) ? data.removableLeadIds : [];
+            return toolResult({ ...data, leadIds, noSend: true, persisted: false });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("unenroll_campaign_audience", "Remove exactly the lead_ids returned by preview_unenroll_campaign_audience. Re-reads the preview first and refuses a stale, partial, or expanded selection. " +
+        "This only removes explicit membership; it never sends. An ACTIVE campaign may be replanned by Leadify solely to stop pending jobs.", {
+        organization_id: z.string().describe("Organization selected explicitly via list_organizations."),
+        campaign_id: z.string().describe("Campaign ID selected from preview_unenroll_campaign_audience."),
+        lead_ids: z.array(z.string()).min(1).describe("Exact, complete lead_ids returned by the preview."),
+    }, async ({ organization_id, campaign_id, lead_ids }) => {
+        try {
+            const data = await (readClient ?? getClient()).get(`/api/campaign/${encodeURIComponent(campaign_id)}/audience`, new URLSearchParams({ organizationId: organization_id }));
+            const expected = Array.isArray(data.removableLeadIds) ? data.removableLeadIds : [];
+            const selected = [...new Set(lead_ids)].sort();
+            if (selected.length !== lead_ids.length || JSON.stringify(selected) !== JSON.stringify([...expected].sort())) {
+                throw new Error("lead_ids must exactly match the current preview_unenroll_campaign_audience result");
+            }
+            return toolResult(await (deleteClient ?? getClient()).delete(`/api/campaign/${encodeURIComponent(campaign_id)}/prospects`, { leadIds: lead_ids }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── export_campaign ────────────────────────────────────────────────────
     server.tool("export_campaign", "Export a campaign's statistics and metrics as CSV. A permanently closed campaign is exported " +
         "from its immutable final report, so late replies remain visible in current activity without " +

package/dist/tools/leads.js

@@ -285,6 +285,22 @@ export function registerLeadTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
+    server.tool("clear_lead_field", "Irreversibly remove one stored value from a lead without changing its lead-group schema. " +
+        "Canonical relationship fields require their dedicated relationship mutation. Always confirm with the user before calling this tool.", {
+        lead_id: z.string().describe("ID of the lead to change."),
+        property_name: z.string().min(1).describe("Stored field name to clear. The field definition remains in the schema."),
+        confirmation: z.literal("clear_lead_field").describe("Exact acknowledgement required before removing the stored value."),
+    }, async ({ lead_id, property_name }) => {
+        try {
+            return toolResult(await client.delete("/clear-lead-field", {
+                leadId: lead_id,
+                propertyName: property_name,
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── delete_sequence_messages ──────────────────────────────────────────
     server.tool("upsert_lead_note", "Create a free-form note in a prospect's Notes tab. Idempotent for the same lead and exact note body: retrying the call returns the original note instead of adding a duplicate.", {
         lead_id: z.string().describe("ID of the prospect that owns the note."),

package/dist/tools/schema.js

@@ -125,7 +125,8 @@ export function registerSchemaTools(server, client) {
             .array(z.string())
             .min(1)
             .describe("Array of column/field names to delete."),
-    }, async ({ lead_group_id, column_names }) => {
+        force: z.literal(true).optional().describe("Required only to remove a rogue data key that is absent from the group schema."),
+    }, async ({ lead_group_id, column_names, force }) => {
         try {
             const body = {
                 leadGroupId: lead_group_id,
@@ -136,6 +137,8 @@ export function registerSchemaTools(server, client) {
             else {
                 body.columnNames = column_names;
             }
+            if (force)
+                body.force = true;
             const data = await (client ?? getClient()).post("/delete-column", body);
             return toolResult(data);
         }

package/package.json

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