@agifyai/leadify-mcp 8.1.0 → 8.2.0

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. |
@@ -201,6 +203,7 @@ Conséquences pratiques :
 | `signal_disable` | Désactiver un signal (faux positif / écarté manuellement). Flip de `state` uniquement. |
 | `signal_delete` | Supprimer définitivement un signal (cas rare : donnée erronée, doublon). |
 | `add_activity` | Journaliser une interaction prospect (LinkedIn, email, call) dans le feed du lead. |
+| `compile_context_pack` | Compiler en lecture seule un Context Pack canonique depuis une cible explicite (`organization`, `lead_group`, `campaign`, `account`, `person`) ou un couple lead + campagne pour `WRITE_OUTREACH`. Retourne publications courantes, sources, freshness, contradictions et provenance. N’utilise jamais la Data Room legacy ni ne choisit de cible implicite. |
 | `get_context_workspace` | Lire le Context Workspace canonique versionné (`company_brain` ou `gtm_playbook`) d'une organisation explicitement sélectionnée. Retourne le brouillon et la dernière version publiée. |
 | `update_company_brain_sections` | Modifier uniquement les sections indiquées du Company Brain : le MCP relit le brouillon ou la dernière publication, fusionne les sections ciblées, puis sauvegarde avec révision attendue et clé d'idempotence. |
 | `update_gtm_playbook_sections` | Modifier uniquement les sections indiquées du GTM Playbook, avec la même lecture-fusion-révision atomiquement contrôlée. |

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.1.0",
+        version: "8.2.0",
     });
     registerAuthTools(server);
     registerOrganizationTools(server);

package/dist/tools/context_workspace.d.ts

@@ -4,6 +4,9 @@ export interface ContextWorkspaceClient {
     put(path: string, body: unknown): Promise<unknown>;
     post(path: string, body: unknown): Promise<unknown>;
 }
+export interface ContextPackClient {
+    post(path: string, body: unknown): Promise<unknown>;
+}
 /** Bounded projection for agents: the active draft and latest published version only. */
 export declare function projectContextWorkspaceRead(data: unknown): Record<string, unknown>;
 export declare function registerContextWorkspaceTools(server: McpServer, client?: ContextWorkspaceClient): void;

package/dist/tools/context_workspace.js

@@ -102,6 +102,37 @@ async function updateSections(client, input) {
     });
 }
 export function registerContextWorkspaceTools(server, client = getClient()) {
+    server.registerTool("compile_context_pack", {
+        title: "Compile the canonical Context Pack",
+        description: "Compile the canonical, tenant-scoped Context Pack for one explicitly selected target. Use `target_kind` + `target_id` for organization, " +
+            "lead group, campaign, account, or person; use lead + campaign only for the WRITE_OUTREACH pack. This is read-only and never uses Data Room.",
+        inputSchema: {
+            organization_id: z.string().trim().min(1).describe("Organization explicitly selected through discover_leadify_context."),
+            target_kind: z.enum(["organization", "lead_group", "campaign", "account", "person"]).optional().describe("Direct canonical target; never causes an implicit lead/campaign selection."),
+            target_id: z.string().trim().min(1).optional().describe("Required for every target except organization."),
+            lead_id: z.string().trim().min(1).optional().describe("Lead targeted by a WRITE_OUTREACH pack; requires campaign_id."),
+            campaign_id: z.string().trim().min(1).optional().describe("Campaign targeted by a WRITE_OUTREACH pack; requires lead_id."),
+            max_evidence_age_ms: z.number().int().positive().max(90 * 24 * 60 * 60 * 1000).optional().describe("Optional freshness limit; defaults to 30 days and never exceeds 90 days."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ organization_id, target_kind, target_id, lead_id, campaign_id, max_evidence_age_ms }) => {
+        try {
+            if (target_kind) {
+                if (target_kind !== "organization" && !target_id)
+                    return toolResult({ error: "target_id is required for this target_kind" });
+                return toolResult(await client.post("/api/context-pack/target", { organizationId: organization_id, target: { kind: target_kind, ...(target_id ? { id: target_id } : {}) } }));
+            }
+            if (!lead_id || !campaign_id)
+                return toolResult({ error: "Provide target_kind (and target_id when needed), or both lead_id and campaign_id." });
+            const body = { organizationId: organization_id, leadId: lead_id, campaignId: campaign_id };
+            if (max_evidence_age_ms !== undefined)
+                body.maxEvidenceAgeMs = max_evidence_age_ms;
+            return toolResult(await client.post("/api/context-pack/compile", body));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     server.registerTool("get_context_workspace", {
         title: "Read canonical versioned Context Workspace",
         description: "Read the canonical Leadify Context Workspace for one explicitly selected organization and kind. " +

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.1.0",
+  "version": "8.2.0",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",