@agifyai/leadify-mcp 7.1.1 → 7.1.3

package/dist/server.js

@@ -16,7 +16,7 @@ import { registerFineTuningTools } from "./tools/fine_tuning.js";
 export function createServer() {
     const server = new McpServer({
         name: "leadify",
-        version: "6.0.0",
+        version: "7.1.3",
     });
     registerAuthTools(server);
     registerOrganizationTools(server);

package/dist/tools/organizations.d.ts

@@ -1,2 +1,3 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function assertLeadGroupsBelongToOrganization(data: unknown, organizationId: string): Array<Record<string, unknown>>;
 export declare function registerOrganizationTools(server: McpServer): void;

package/dist/tools/organizations.js

@@ -1,5 +1,27 @@
+import { z } from "zod";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
+export function assertLeadGroupsBelongToOrganization(data, organizationId) {
+    if (!data ||
+        typeof data !== "object" ||
+        !Array.isArray(data.leadGroups)) {
+        throw new Error("Leadify returned an invalid lead group list response");
+    }
+    const leadGroups = data.leadGroups;
+    for (const group of leadGroups) {
+        if (!group || typeof group !== "object") {
+            throw new Error("Leadify returned an invalid lead group");
+        }
+        const actualOrganizationId = group.organizationId;
+        if (actualOrganizationId !== organizationId) {
+            const groupId = group.id;
+            throw new Error(`Leadify returned group ${typeof groupId === "string" ? groupId : "without an id"} ` +
+                `from organization ${typeof actualOrganizationId === "string" ? actualOrganizationId : "without an organization"} ` +
+                `while ${organizationId} was requested`);
+        }
+    }
+    return leadGroups;
+}
 export function registerOrganizationTools(server) {
     // ── list_organizations ─────────────────────────────────────────────────
     server.tool("list_organizations", "List every organization accessible to the caller, returning each with id, name, and " +
@@ -14,4 +36,67 @@ export function registerOrganizationTools(server) {
             return handleToolError(error);
         }
     });
+    server.tool("list_lead_groups", "List lead groups visible in one explicitly selected organization. Returns a compact " +
+        "navigation view only: id, name, organizationId, lead count, published and refresh state. " +
+        "Start with discover_leadify_context when no organization_id is known.", {
+        organization_id: z.string().describe("Organization ID explicitly selected from list_organizations or discover_leadify_context."),
+        limit: z.number().int().min(1).max(100).optional().default(50).describe("Maximum groups returned, bounded to 100."),
+    }, async ({ organization_id, limit }) => {
+        try {
+            const params = new URLSearchParams({ organizationId: organization_id });
+            const data = await getClient().get("/api/lead-groups", params);
+            const groups = assertLeadGroupsBelongToOrganization(data, organization_id);
+            return toolResult({
+                organizationId: organization_id,
+                leadGroups: groups.slice(0, limit).map((group) => ({
+                    id: group.id,
+                    name: group.name,
+                    organizationId: group.organizationId,
+                    leadCount: group._count?.leads ?? 0,
+                    published: group.published ?? false,
+                    refreshEnabled: group.refreshEnabled ?? false,
+                })),
+                total: groups.length,
+                truncated: groups.length > limit,
+            });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("discover_leadify_context", "Safe zero-ID entry point for Leadify. With no organization_id, lists accessible organizations " +
+        "and never chooses one when several are available. With an explicit organization_id, returns " +
+        "a compact list of its lead groups. Use the returned lead_group_id with lead, campaign, persona " +
+        "and data-room tools.", {
+        organization_id: z.string().optional().describe("Organization selected explicitly after discovery. Omit only for the first step."),
+        limit: z.number().int().min(1).max(100).optional().default(50).describe("Maximum lead groups returned after selection."),
+    }, async ({ organization_id, limit }) => {
+        try {
+            const orgData = await getClient().get("/api/organizations");
+            const organizations = Array.isArray(orgData.organizations)
+                ? orgData.organizations.map((org) => ({ id: org.id, name: org.name ?? null, slug: org.slug ?? null }))
+                : [];
+            if (!organization_id) {
+                if (organizations.length !== 1) {
+                    return toolResult({ organizations, selectionRequired: organizations.length > 1, message: organizations.length === 0 ? "No accessible organization." : "Select organization_id explicitly before reading lead groups." });
+                }
+                organization_id = String(organizations[0].id);
+            }
+            if (!organizations.some((org) => org.id === organization_id)) {
+                return toolResult({ organizations, selectionRequired: true, message: "organization_id is not accessible to this key." });
+            }
+            const groupsData = await getClient().get("/api/lead-groups", new URLSearchParams({ organizationId: organization_id }));
+            const groups = assertLeadGroupsBelongToOrganization(groupsData, organization_id);
+            return toolResult({
+                organization: organizations.find((org) => org.id === organization_id),
+                leadGroups: groups.slice(0, limit).map((group) => ({ id: group.id, name: group.name, organizationId: group.organizationId, leadCount: group._count?.leads ?? 0, published: group.published ?? false })),
+                total: groups.length,
+                truncated: groups.length > limit,
+                next: "Choose a lead_group_id, then use get_leads, get_data_room_context, or get_lead_group_persona.",
+            });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "7.1.1",
+  "version": "7.1.3",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",
@@ -15,7 +15,8 @@
     "build": "rm -rf dist && tsc && chmod +x dist/index.js",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test test/**/*.test.mjs"
   },
   "repository": {
     "type": "git",