@agifyai/leadify-mcp 8.6.3 → 8.6.5

package/dist/tools/schema.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
-type SchemaClient = Pick<LeadifyClient, "get" | "post">;
+type SchemaClient = Pick<LeadifyClient, "get" | "post" | "rpc">;
 export declare function registerSchemaTools(server: McpServer, client?: SchemaClient): void;
 export {};

package/dist/tools/schema.js

@@ -78,6 +78,42 @@ export function registerSchemaTools(server, client) {
             return handleToolError(error);
         }
     });
+    // ── schema_migration_preview / apply_schema_migration ─────────────────
+    server.tool("schema_migration_preview", "Preview the exact hash-pinned schema migration required to make a lead group READY. " +
+        "This is read-only. Review the returned expectedSchemaHash, planHash, impacted leads and " +
+        "conversion actions before calling apply_schema_migration.", {
+        lead_group_id: z.string().describe("ID of the lead group to inspect."),
+    }, async ({ lead_group_id }) => {
+        try {
+            const data = await (client ?? getClient()).rpc("leadGroups/schemaMigrationPreview", { leadGroupId: lead_group_id });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("apply_schema_migration", "Apply a destructive schema migration only after schema_migration_preview has been read and " +
+        "the exact expected_schema_hash and expected_plan_hash have been supplied. This API performs " +
+        "its own optimistic hash checks. Use only for the reviewed lead group; reread its leads and " +
+        "schema readiness afterwards.", {
+        lead_group_id: z.string().describe("ID of the reviewed lead group."),
+        expected_schema_hash: z.string().regex(/^[a-f0-9]{64}$/).describe("expectedSchemaHash from the fresh preview."),
+        expected_plan_hash: z.string().regex(/^[a-f0-9]{64}$/).describe("planHash from the same fresh preview."),
+        confirmation: z.literal("apply_destructive_schema_migration").describe("Exact acknowledgement required by the server."),
+    }, async ({ lead_group_id, expected_schema_hash, expected_plan_hash, confirmation }) => {
+        try {
+            const data = await (client ?? getClient()).rpc("leadGroups/applySchemaMigration", {
+                leadGroupId: lead_group_id,
+                expectedSchemaHash: expected_schema_hash,
+                expectedPlanHash: expected_plan_hash,
+                confirmation,
+            });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── delete_columns ─────────────────────────────────────────────────────
     server.tool("delete_columns", "Remove one or more columns (fields) from a lead group's schema and all lead data " +
         "stored in those fields. This action is irreversible — field definitions and values " +

package/package.json

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