@agifyai/leadify-mcp 8.0.0 → 8.1.0

package/README.md

@@ -192,6 +192,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.0",
     });
     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/package.json

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