@agifyai/leadify-mcp 8.0.0 → 8.1.1

package/README.md

@@ -179,6 +179,8 @@ Conséquences pratiques :
 | Tool | Description |
 |------|-------------|
 | `test_api_key` | Vérifier que la clé API configurée est valide (health check). |
+| `list_lead_groups` | Lister les groupes accessibles d'une organisation explicitement sélectionnée, en vue compacte. |
+| `get_lead_group` | Consulter les métadonnées compactes d'un groupe accessible par son ID. |
 | `add_leads` | Ajouter un ou plusieurs leads à un groupe. |
 | `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. |
@@ -192,6 +194,7 @@ Conséquences pratiques :
 | `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 nouvelle campagne rattachée à un groupe de leads (statut DRAFT). |
+| `list_campaigns` | Lister compactement les campagnes d'une organisation explicitement sélectionnée et leur statut courant. |
 | `get_campaign` | Récupérer les détails d'une campagne et ses KPIs temps réel. |
 | `update_campaign_status` | Changer le statut d'une campagne (DRAFT, ACTIVE, PAUSED, COMPLETED). |
 | `export_campaign` | Exporter les statistiques complètes d'une campagne en CSV. |

package/dist/server.js

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

package/dist/tools/campaigns.d.ts

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

package/dist/tools/campaigns.js

@@ -1,7 +1,25 @@
 import { z } from "zod";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
-export function registerCampaignTools(server) {
+const CAMPAIGN_STATUSES = ["DRAFT", "ACTIVE", "PAUSED", "COMPLETED"];
+function assertCampaignBelongsToOrganization(data, organizationId) {
+    if (!data || typeof data !== "object") {
+        throw new Error("Leadify returned an invalid campaign response");
+    }
+    const campaign = data;
+    const leadGroup = campaign.leadGroup;
+    const actualOrganizationId = campaign.organizationId ?? (leadGroup && typeof leadGroup === "object"
+        ? leadGroup.organizationId
+        : undefined);
+    if (actualOrganizationId !== organizationId) {
+        throw new Error("Campaign does not belong to the explicitly selected organization");
+    }
+    if (!CAMPAIGN_STATUSES.includes(campaign.status)) {
+        throw new Error("Leadify returned a campaign with an invalid current status");
+    }
+    return campaign;
+}
+export function registerCampaignTools(server, readClient) {
     // ── 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 " +
@@ -98,14 +116,63 @@ export function registerCampaignTools(server) {
         }
     });
     // ── get_campaign ───────────────────────────────────────────────────────
-    server.tool("get_campaign", "Retrieve full details for a campaign by its ID, including real-time calculated KPIs " +
-        "(invitations sent, accept rate, messages sent, emails sent, reply rate, golden signals). " +
-        "Use this to check a campaign's current performance.", {
+    server.tool("get_campaign", "Retrieve a campaign chosen from list_campaigns, scoped to the explicitly selected " +
+        "organization. Includes its normalized current status (DRAFT, ACTIVE, PAUSED, or COMPLETED) " +
+        "and real-time KPIs. Never use campaign logs as the source of status.", {
         id: z.string().describe("Campaign ID."),
-    }, async ({ id }) => {
+        organization_id: z.string().describe("Organization selected explicitly via discover_leadify_context or list_organizations."),
+    }, async ({ id, organization_id }) => {
         try {
-            const data = await getClient().get(`/api/campaign/${encodeURIComponent(id)}`);
-            return toolResult(data);
+            const data = await (readClient ?? getClient()).get(`/api/campaign/${encodeURIComponent(id)}`);
+            return toolResult(assertCampaignBelongsToOrganization(data, organization_id));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── list_campaigns ─────────────────────────────────────────────────────
+    server.tool("list_campaigns", "List campaigns in one explicitly selected organization with compact current status metadata. " +
+        "Use this after discover_leadify_context to identify ACTIVE, DRAFT, PAUSED, or COMPLETED " +
+        "campaigns without reading historical logs.", {
+        organization_id: z.string().describe("Organization selected explicitly via discover_leadify_context or list_organizations."),
+        status: z.enum(CAMPAIGN_STATUSES).optional().describe("Optional current-status filter."),
+        limit: z.number().int().min(1).max(100).optional().default(50).describe("Maximum campaigns returned, bounded to 100."),
+    }, async ({ organization_id, status, limit }) => {
+        try {
+            const data = await (readClient ?? getClient()).get("/api/campaigns", new URLSearchParams({ organizationId: organization_id }));
+            if (!data || typeof data !== "object" || !Array.isArray(data.campaigns)) {
+                throw new Error("Leadify returned an invalid campaign list response");
+            }
+            const response = data;
+            if (response.organizationId !== organization_id) {
+                throw new Error("Leadify returned campaigns from a different organization");
+            }
+            const campaigns = response.campaigns.map((item) => {
+                if (!item || typeof item !== "object")
+                    throw new Error("Leadify returned an invalid campaign");
+                const campaign = item;
+                if (!CAMPAIGN_STATUSES.includes(campaign.status)) {
+                    throw new Error("Leadify returned a campaign with an invalid current status");
+                }
+                return {
+                    id: campaign.id,
+                    name: campaign.name,
+                    status: campaign.status,
+                    channel: campaign.channel,
+                    leadGroupId: campaign.leadGroupId,
+                    createdAt: campaign.createdAt,
+                    updatedAt: campaign.updatedAt,
+                };
+            });
+            const filtered = status ? campaigns.filter((campaign) => campaign.status === status) : campaigns;
+            const statusCounts = Object.fromEntries(CAMPAIGN_STATUSES.map((value) => [value, campaigns.filter((campaign) => campaign.status === value).length]));
+            return toolResult({
+                organizationId: organization_id,
+                campaigns: filtered.slice(0, limit),
+                total: filtered.length,
+                truncated: filtered.length > limit,
+                statusCounts,
+            });
         }
         catch (error) {
             return handleToolError(error);

package/dist/tools/organizations.d.ts

@@ -1,3 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare function assertLeadGroupsBelongToOrganization(data: unknown, organizationId: string): Array<Record<string, unknown>>;
+/** Keep group reads navigable: never return schema, profiles, or lead data. */
+export declare function compactLeadGroup(group: unknown): Record<string, unknown>;
 export declare function registerOrganizationTools(server: McpServer): void;

package/dist/tools/organizations.js

@@ -22,6 +22,28 @@ export function assertLeadGroupsBelongToOrganization(data, organizationId) {
     }
     return leadGroups;
 }
+/** Keep group reads navigable: never return schema, profiles, or lead data. */
+export function compactLeadGroup(group) {
+    const source = group && typeof group === "object" ? group : {};
+    const count = source._count && typeof source._count === "object"
+        ? source._count
+        : {};
+    return {
+        id: source.id,
+        name: source.name,
+        description: source.description ?? null,
+        organizationId: source.organizationId,
+        entityKind: source.entityKind ?? "GENERIC",
+        personaTypes: Array.isArray(source.personaTypes) ? source.personaTypes : [],
+        hasPersona: Boolean(source.personaId),
+        disabledTools: Array.isArray(source.disabledTools) ? source.disabledTools : [],
+        leadCount: typeof count.leads === "number" ? count.leads : 0,
+        published: source.published ?? false,
+        refreshEnabled: source.refreshEnabled ?? false,
+        refreshFrequencyDays: source.refreshFrequencyDays ?? null,
+        createdAt: source.createdAt ?? null,
+    };
+}
 export function registerOrganizationTools(server) {
     // ── list_organizations ─────────────────────────────────────────────────
     server.tool("list_organizations", "List every organization accessible to the caller, returning each with id, name, and " +
@@ -64,6 +86,21 @@ export function registerOrganizationTools(server) {
             return handleToolError(error);
         }
     });
+    server.tool("get_lead_group", "Read the compact metadata of one accessible lead group by ID. Use this after list_lead_groups " +
+        "or discover_leadify_context to confirm its type and operational state. Returns only navigation " +
+        "metadata (no lead records, schema, company profile, or persona payload) and reports inaccessible " +
+        "groups as not found, without revealing their organization.", {
+        lead_group_id: z.string().describe("Lead group ID returned by Leadify discovery or another authorized Leadify response."),
+    }, async ({ lead_group_id }) => {
+        try {
+            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}`);
+            const source = data && typeof data === "object" ? data : {};
+            return toolResult({ leadGroup: compactLeadGroup(source.leadGroup) });
+        }
+        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 " +

package/package.json

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