@agifyai/leadify-mcp 8.4.1 → 8.5.0

package/README.md

@@ -4,6 +4,8 @@ Serveur MCP (Model Context Protocol) pour l'API Leadify. Expose les endpoints RE
 
 Package npm : [`@agifyai/leadify-mcp`](https://www.npmjs.com/package/@agifyai/leadify-mcp)
 
+`get_mcp_runtime_info` est le diagnostic de livraison en lecture seule. Il expose la version exacte du package et du serveur, puis vérifie qu'un `organization_id` explicitement choisi est accessible à la clé configurée. Il ne lit aucun prospect et n'effectue aucune écriture, aucun envoi, aucune publication ni activation.
+
 ---
 
 ## 📦 Pour les utilisateurs
@@ -198,7 +200,8 @@ Pour `add_leads` et `update_lead`, `location` utilise l’objet canonique
 `{ city, region?, postalCode?, countryCode, street? }`. `city` et le code pays
 ISO-2 `countryCode` sont obligatoires. La projection `geo` est calculée par
 Leadify et ne doit jamais être envoyée par un agent MCP.
-| `delete_sequence_messages` | Supprimer uniquement les messages de séquence générés d'un lead, après confirmation explicite. |
+| `preview_reset_sequence_messages` / `execute_reset_sequence_messages` | Prévisualiser puis effacer irréversiblement les messages générés d'un prospect, d'une liste explicite ou d'un groupe explicite. L'exécution exige le digest de preview et une clé d'idempotence. |
+| `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. |

package/dist/server.js

@@ -15,10 +15,11 @@ import { registerFineTuningTools } from "./tools/fine_tuning.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
 import { registerLeadViewTools } from "./tools/views.js";
 import { registerRelationshipTools } from "./tools/relationships.js";
+import { MCP_SERVER_NAME, MCP_VERSION } from "./version.js";
 export function createServer() {
     const server = new McpServer({
-        name: "leadify",
-        version: "8.4.0",
+        name: MCP_SERVER_NAME,
+        version: MCP_VERSION,
     });
     registerAuthTools(server);
     registerOrganizationTools(server);

package/dist/tools/auth.d.ts

@@ -1,2 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerAuthTools(server: McpServer): void;
+import { getClient } from "../client.js";
+type ReadClient = Pick<ReturnType<typeof getClient>, "get">;
+export declare function projectMcpRuntimeInfo(data: unknown, organizationId: string): Record<string, unknown>;
+export declare function registerAuthTools(server: McpServer, injectedClient?: ReadClient): void;
+export {};

package/dist/tools/auth.js

@@ -1,16 +1,45 @@
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
-export function registerAuthTools(server) {
+import { z } from "zod";
+import { MCP_PACKAGE_NAME, MCP_SERVER_NAME, MCP_VERSION } from "../version.js";
+export function projectMcpRuntimeInfo(data, organizationId) {
+    const source = data && typeof data === "object" ? data : {};
+    const organizations = Array.isArray(source.organizations) ? source.organizations : [];
+    const organization = organizations.find((candidate) => candidate.id === organizationId);
+    return {
+        package: MCP_PACKAGE_NAME,
+        server: MCP_SERVER_NAME,
+        version: MCP_VERSION,
+        organization: organization ? { id: organization.id, name: organization.name ?? null, slug: organization.slug ?? null } : null,
+        organizationAccessible: Boolean(organization),
+        readOnly: true,
+        writes: 0,
+        sends: 0,
+        externalActivation: 0,
+    };
+}
+export function registerAuthTools(server, injectedClient) {
     server.tool("test_api_key", "Verify that the configured Leadify API key is valid and has not been revoked. " +
         "Returns a success message if the key is active. Use this as a health check " +
         "before performing other operations, or to diagnose authentication errors " +
         "(401/403) from other tools.", {}, async () => {
         try {
-            const data = await getClient().get("/test-api-key");
+            const data = await (injectedClient ?? getClient()).get("/test-api-key");
             return toolResult(data);
         }
         catch (error) {
             return handleToolError(error);
         }
     });
+    server.tool("get_mcp_runtime_info", "Read the exact Leadify MCP package/server version and verify that one explicitly selected organization is accessible to the configured API key. This diagnostic is read-only: it never reads prospects and never writes, sends, schedules, publishes, or activates anything.", {
+        organization_id: z.string().min(1).describe("Exact organization ID selected by the caller. The server never chooses an organization implicitly."),
+    }, async ({ organization_id }) => {
+        try {
+            const data = await (injectedClient ?? getClient()).get("/api/organizations");
+            return toolResult(projectMcpRuntimeInfo(data, organization_id));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
 }

package/dist/tools/leads.js

@@ -33,6 +33,31 @@ const leadUpdateSchema = z.object({
         }
     }
 });
+const destructiveResetScopeShape = {
+    organization_id: z.string().trim().min(1).describe("Explicit organization ID. The server verifies tenant access and admin permission."),
+    scope: z.enum(["lead", "lead_ids", "lead_group"]).describe("Exactly one explicit target scope; no implicit group or organization selection is allowed."),
+    lead_id: z.string().trim().min(1).optional().describe("Required only when scope is lead."),
+    lead_ids: z.array(z.string().trim().min(1)).min(1).max(100).optional().describe("Required only when scope is lead_ids; unique JSON list of lead IDs."),
+    lead_group_id: z.string().trim().min(1).optional().describe("Required only when scope is lead_group."),
+};
+const destructiveResetScopeSchema = z.object(destructiveResetScopeShape).superRefine((value, context) => {
+    const exactly = value.scope === "lead" ? Boolean(value.lead_id) && !value.lead_ids && !value.lead_group_id
+        : value.scope === "lead_ids" ? !value.lead_id && Boolean(value.lead_ids) && !value.lead_group_id
+            : !value.lead_id && !value.lead_ids && Boolean(value.lead_group_id);
+    if (!exactly)
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide exactly the identifier required by scope and no other target identifier." });
+    if (value.lead_ids && new Set(value.lead_ids).size !== value.lead_ids.length)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["lead_ids"], message: "lead_ids must not contain duplicates." });
+});
+function resetScopePayload(value) {
+    return {
+        organizationId: value.organization_id,
+        scope: value.scope,
+        ...(value.scope === "lead" ? { leadId: value.lead_id } : {}),
+        ...(value.scope === "lead_ids" ? { leadIds: value.lead_ids } : {}),
+        ...(value.scope === "lead_group" ? { leadGroupId: value.lead_group_id } : {}),
+    };
+}
 function projectLead(lead, fields) {
     const source = lead && typeof lead === "object" ? lead : {};
     const data = source.data && typeof source.data === "object" ? source.data : {};
@@ -51,6 +76,30 @@ function compactLeadsResponse(data, fields, includeSchema) {
     return result;
 }
 export function registerLeadTools(server, client = getClient()) {
+    for (const reset of [
+        { key: "sequence_messages", label: "generated sequence messages" },
+        { key: "ai_fields", label: "AI-generated fields" },
+    ]) {
+        const route = reset.key === "sequence_messages" ? "sequence-messages" : "ai-fields";
+        server.tool(`preview_reset_${reset.key}`, `Preview the irreversible reset of ${reset.label}. This is non-mutating and returns the mandatory previewDigest, exact lead IDs and fields that would be cleared. Select one explicit scope only.`, destructiveResetScopeShape, async (params) => {
+            try {
+                const checked = destructiveResetScopeSchema.parse(params);
+                return toolResult(await client.post(`/api/resets/${route}/preview`, resetScopePayload(checked)));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+        server.tool(`execute_reset_${reset.key}`, `IRREVERSIBLE: execute the ${reset.label} reset only after its preview. Requires that preview's exact digest and a unique idempotency key; the result includes persisted readback. This never sends outreach or changes campaigns, activities or contacts.`, { ...destructiveResetScopeShape, preview_digest: z.string().regex(/^[a-f0-9]{64}$/), idempotency_key: z.string().trim().min(8).max(200) }, async (params) => {
+            try {
+                const checked = destructiveResetScopeSchema.parse(params);
+                return toolResult(await client.post(`/api/resets/${route}/execute`, { ...resetScopePayload(checked), previewDigest: params.preview_digest, idempotencyKey: params.idempotency_key }));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+    }
     // ── 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, " +
@@ -231,20 +280,6 @@ export function registerLeadTools(server, client = getClient()) {
             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) {
-            return handleToolError(error);
-        }
-    });
     // ── delete_leads ───────────────────────────────────────────────────────
     server.tool("delete_leads", "Permanently delete one or more leads by their IDs. This action is irreversible. " +
         "Returns the count and IDs of deleted leads. If some leads are not found or " +

package/dist/version.d.ts

@@ -0,0 +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.0";

package/dist/version.js

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

package/package.json

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