@agifyai/leadify-mcp 8.2.0 → 8.3.1

package/README.md

@@ -185,6 +185,7 @@ Conséquences pratiques :
 | `get_leads` | Rechercher et lister des leads avec filtres, recherche et pagination. |
 | `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. |
+| `delete_sequence_messages` | Supprimer uniquement les messages de séquence générés d'un lead, après confirmation explicite. |
 | `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. |

package/dist/server.js

@@ -13,14 +13,16 @@ import { registerOrganizationTools } from "./tools/organizations.js";
 import { registerPipelineTools } from "./tools/pipeline.js";
 import { registerFineTuningTools } from "./tools/fine_tuning.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
+import { registerLeadViewTools } from "./tools/views.js";
 export function createServer() {
     const server = new McpServer({
         name: "leadify",
-        version: "8.2.0",
+        version: "8.3.1",
     });
     registerAuthTools(server);
     registerOrganizationTools(server);
     registerLeadGroupTools(server);
+    registerLeadViewTools(server);
     registerLeadTools(server);
     registerSchemaTools(server);
     registerLogTools(server);

package/dist/tools/leads.d.ts

@@ -1,2 +1,2 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerLeadTools(server: McpServer): void;
+export declare function registerLeadTools(server: McpServer, client?: import("../client.js").LeadifyClient): void;

package/dist/tools/leads.js

@@ -19,7 +19,7 @@ function compactLeadsResponse(data, fields, includeSchema) {
         result.schema = source.schema;
     return result;
 }
-export function registerLeadTools(server) {
+export function registerLeadTools(server, client = getClient()) {
     // ── add_leads ──────────────────────────────────────────────────────────
     server.tool("add_leads", "Add one or more leads to a specific lead group in Leadify. Provide the group ID " +
         "and an array of lead objects with any combination of fields (email, firstName, " +
@@ -51,7 +51,7 @@ export function registerLeadTools(server) {
                 body.leadData.isSelectFields =
                     is_select_fields;
             }
-            const data = await getClient().post("/add-lead", body);
+            const data = await client.post("/add-lead", body);
             return toolResult(data);
         }
         catch (error) {
@@ -113,7 +113,7 @@ export function registerLeadTools(server) {
                     }
                 }
             }
-            const data = await getClient().get("/get-leads", params);
+            const data = await client.get("/get-leads", params);
             return toolResult(compactLeadsResponse(data, fields ?? DEFAULT_LEAD_FIELDS, include_schema));
         }
         catch (error) {
@@ -130,7 +130,7 @@ export function registerLeadTools(server) {
         try {
             const params = new URLSearchParams();
             params.set("id", id);
-            const data = await getClient().get("/get-lead", params);
+            const data = await client.get("/get-lead", params);
             const source = data && typeof data === "object" ? data : {};
             const lead = source.lead;
             const result = { lead: projectLead(lead, fields ?? DEFAULT_LEAD_FIELDS) };
@@ -178,7 +178,21 @@ export function registerLeadTools(server) {
                     ...(u.is_select !== undefined ? { isSelect: u.is_select } : {}),
                 })),
             };
-            const data = await getClient().put("/update-lead", body);
+            const data = await client.put("/update-lead", body);
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── delete_sequence_messages ──────────────────────────────────────────
+    server.tool("delete_sequence_messages", "Permanently remove only the generated LinkedIn and email sequence messages for one lead. " +
+        "It does not modify the lead's contact data, qualification, activities, campaign state, or any other fields. " +
+        "This action is irreversible: obtain explicit user confirmation before calling it.", {
+        lead_id: z.string().describe("ID of the lead whose generated sequence messages must be removed."),
+    }, async ({ lead_id }) => {
+        try {
+            const data = await client.post("/api/delete-sequence-messages", { leadId: lead_id });
             return toolResult(data);
         }
         catch (error) {
@@ -196,7 +210,7 @@ export function registerLeadTools(server) {
             .describe("Array of lead IDs to delete."),
     }, async ({ lead_ids }) => {
         try {
-            const data = await getClient().post("/delete-lead", {
+            const data = await client.post("/delete-lead", {
                 leadIds: lead_ids,
             });
             return toolResult(data);

package/dist/tools/views.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLeadViewTools(server: McpServer): void;

package/dist/tools/views.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError, toolResult } from "../types.js";
+const filterSchema = z.object({
+    field: z.string().describe("A standard, virtual, or selected lead-group schema field."),
+    operator: z.enum(["equals", "contains", "gte", "lte", "not_equals", "not_contains", "is_true", "is_false", "is_null", "is_not_null", "activity_days_ago", "activity_count_equals", "activity_count_gte", "activity_count_lte", "bbox"]),
+    value: z.unknown().optional(),
+});
+const viewConfigSchema = {
+    organization_id: z.string().describe("Organization that owns the explicitly selected lead group."),
+    lead_group_id: z.string().describe("Lead group ID. The view is shared with this group's organization."),
+    name: z.string().min(1),
+    filters: z.array(filterSchema),
+    columns: z.array(z.string()).optional(),
+    sort: z.object({ field: z.string(), direction: z.enum(["asc", "desc"]) }).optional(),
+    pagination: z.object({ page: z.number().int().min(1), limit: z.number().int().min(1).max(1000) }).optional(),
+};
+export function registerLeadViewTools(server) {
+    server.tool("list_lead_views", "List the virtual read-only default view and every saved view shared by the selected lead group's organization. Use get_lead_view for one full configuration.", { organization_id: z.string(), lead_group_id: z.string() }, async ({ organization_id, lead_group_id }) => {
+        try {
+            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views`);
+            const result = data;
+            return toolResult({ ...result, organizationId: organization_id });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("get_lead_view", "Read one selected saved view, or the read-only virtual view ID `default`, after selecting its organization and lead group.", { organization_id: z.string(), lead_group_id: z.string(), view_id: z.string() }, async ({ organization_id, lead_group_id, view_id }) => {
+        try {
+            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views/${encodeURIComponent(view_id)}`);
+            return toolResult({ ...data, organizationId: organization_id });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("preview_lead_view", "Validate a proposed organization-shared lead view without writing it. Use this before create_lead_view; no data or preference is changed.", viewConfigSchema, async ({ organization_id, lead_group_id, name, filters, columns, sort, pagination }) => {
+        try {
+            const data = await getClient().post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views/preview`, { organizationId: organization_id, name, filters, columns, sort, pagination });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("create_lead_view", "Create an organization-shared saved view after previewing it. Idempotency key is required: retry the same request with the same key; changing the payload with that key conflicts. Update and delete are intentionally unavailable.", { ...viewConfigSchema, idempotency_key: z.string().min(8).max(200) }, async ({ organization_id, lead_group_id, name, filters, columns, sort, pagination, idempotency_key }) => {
+        try {
+            const data = await getClient().post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views`, { organizationId: organization_id, name, filters, columns, sort, pagination, idempotencyKey: idempotency_key });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/package.json

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