@agifyai/leadify-mcp 8.6.10 → 8.7.0

package/README.md

@@ -232,6 +232,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `create_lead_group` | Créer un groupe et choisir son type canonique optionnel (`GENERIC`, `COMPANY` ou `PERSON`) via `entity_kind`. |
 | `update_lead_group` | Modifier un groupe, y compris son `entity_kind`, avec réconciliation du schéma côté Leadify. |
 | `add_leads` | Ajouter un ou plusieurs leads à un groupe. |
+| `upsert_person_leads_with_employment` | Créer ou réconcilier atomiquement des Person Leads, PERSON, EMPLOYED_BY, projections et historique, sans effet commercial. |
 | `get_leads` | Rechercher et lister des leads avec filtres, recherche et pagination, dont le critère composé `event_filter`. |
 | `get_lead` | Récupérer les détails complets d'un lead par son ID. |
 | `update_lead` | Mettre à jour un ou plusieurs champs d'un lead existant. |
@@ -255,7 +256,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `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 campagne DRAFT mono-canal rattachée à un Lead Group qui possède déjà sa paire Persona–Offre. Aucun `persona_id` ou contexte indépendant n’est accepté au niveau Campagne. `channel` (`LINKEDIN` ou `EMAIL`) est obligatoire ; `start_at` inclusif, `end_at` exclusif et `timezone` IANA configurent la fenêtre métier. À `end_at`, Leadify met la campagne en pause réversible (`WINDOW_END`) sans la clôturer. |
-| `update_campaign_configuration` | Modifier le nom, la description et la fenêtre de toute campagne encore `OPEN`; le canal reste modifiable uniquement en DRAFT. Prolonger `end_at` dans le futur ou le supprimer relance automatiquement une pause `WINDOW_END` après validation du fournisseur, mais jamais une pause manuelle. La fenêtre demandée reste enregistrée si cette validation échoue. La Persona est héritée du Lead Group et n’est pas modifiable au niveau Campagne. |
+| `update_campaign` / `update_campaign_configuration` | Modifier le nom, la description et la fenêtre de toute campagne encore `OPEN`; le canal reste modifiable uniquement en DRAFT. Prolonger `end_at` dans le futur ou le supprimer relance automatiquement une pause `WINDOW_END` après validation du fournisseur, mais jamais une pause manuelle. La fenêtre demandée reste enregistrée si cette validation échoue. La Persona est héritée du Lead Group et n’est pas modifiable au niveau Campagne. |
 | `delete_campaign` | Supprimer irréversiblement une campagne `DRAFT` ou `PAUSED` encore `OPEN`, avec la confirmation explicite `delete_campaign`. Une campagne active ou clôturée est refusée, et aucun envoi n’est déclenché. |
 | `list_campaigns` | Lister compactement les campagnes d'une organisation explicitement sélectionnée, avec état effectif, fenêtre, motif de pause et clôture. |
 | `get_campaign` | Récupérer les détails d'une campagne, son état effectif, sa clôture et son éventuel rapport final figé, ainsi que ses KPIs temps réel. |

package/dist/server.js

@@ -19,6 +19,7 @@ import { registerCanonicalBackfillTools } from "./tools/canonical_backfill.js";
 import { registerCommercialTruthTools } from "./tools/commercial_truth.js";
 import { registerEventTools } from "./tools/events.js";
 import { registerContextEntityTools } from "./tools/context_entities.js";
+import { registerPersonEmploymentTools } from "./tools/person_employment.js";
 import { MCP_SERVER_NAME, MCP_VERSION } from "./version.js";
 export function createServer() {
     const server = new McpServer({
@@ -32,6 +33,7 @@ export function createServer() {
     registerLeadTools(server);
     registerRelationshipTools(server);
     registerCanonicalBackfillTools(server);
+    registerPersonEmploymentTools(server);
     registerEventTools(server);
     registerCommercialTruthTools(server);
     registerSchemaTools(server);

package/dist/tools/campaigns.js

@@ -130,39 +130,44 @@ export function registerCampaignTools(server, readClient, writeClient, mutationC
             return handleToolError(error);
         }
     });
-    server.tool("update_campaign_configuration", "Edit the lifecycle window of any OPEN campaign; changing channel remains limited to DRAFT. " +
+    const registerCampaignUpdateTool = (name, description) => {
+        server.tool(name, description, {
+            id: z.string().describe("Campaign ID."),
+            channel: z.enum(["LINKEDIN", "EMAIL"]).optional().describe("Delivery channel; mutable only while status is DRAFT."),
+            start_at: z.string().datetime().nullable().optional().describe("Inclusive UTC start timestamp, or null to remove the lower bound."),
+            end_at: z.string().datetime().nullable().optional().describe("Exclusive UTC end timestamp, or null to remove the upper bound. A future value or null can auto-resume only a WINDOW_END pause."),
+            timezone: z.string().min(1).optional().describe("IANA timezone used for the business window, for example Europe/Paris."),
+            name: z.string().min(1).optional().describe("New campaign name."),
+            description: z.string().nullable().optional().describe("New campaign description, or null to clear it."),
+        }, async ({ id, channel, start_at, end_at, timezone, name, description }) => {
+            try {
+                const body = {};
+                if (channel !== undefined)
+                    body.channel = channel;
+                if (start_at !== undefined)
+                    body.startAt = start_at;
+                if (end_at !== undefined)
+                    body.endAt = end_at;
+                if (timezone !== undefined)
+                    body.timezone = timezone;
+                if (name !== undefined)
+                    body.name = name;
+                if (description !== undefined)
+                    body.description = description;
+                return toolResult(await (mutationClient ?? getClient()).put(`/api/campaign/${encodeURIComponent(id)}/configuration`, body));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+    };
+    const updateCampaignDescription = "Edit the name, description, and lifecycle window of any OPEN campaign; changing channel remains limited to DRAFT. " +
         "Extending endAt into the future or removing it automatically resumes only a campaign paused " +
         "because WINDOW_END, after provider validation and immediate replanning. A MANUAL pause never " +
         "auto-resumes. The requested window remains saved when provider validation fails, and a CLOSED " +
-        "campaign is terminal.", {
-        id: z.string().describe("Campaign ID."),
-        channel: z.enum(["LINKEDIN", "EMAIL"]).optional().describe("Delivery channel; mutable only while status is DRAFT."),
-        start_at: z.string().datetime().nullable().optional().describe("Inclusive UTC start timestamp, or null to remove the lower bound."),
-        end_at: z.string().datetime().nullable().optional().describe("Exclusive UTC end timestamp, or null to remove the upper bound. A future value or null can auto-resume only a WINDOW_END pause."),
-        timezone: z.string().min(1).optional().describe("IANA timezone used for the business window, for example Europe/Paris."),
-        name: z.string().min(1).optional().describe("New campaign name."),
-        description: z.string().nullable().optional().describe("New campaign description, or null to clear it."),
-    }, async ({ id, channel, start_at, end_at, timezone, name, description }) => {
-        try {
-            const body = {};
-            if (channel !== undefined)
-                body.channel = channel;
-            if (start_at !== undefined)
-                body.startAt = start_at;
-            if (end_at !== undefined)
-                body.endAt = end_at;
-            if (timezone !== undefined)
-                body.timezone = timezone;
-            if (name !== undefined)
-                body.name = name;
-            if (description !== undefined)
-                body.description = description;
-            return toolResult(await (mutationClient ?? getClient()).put(`/api/campaign/${encodeURIComponent(id)}/configuration`, body));
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
+        "campaign is terminal. Persona is inherited from the Lead Group and cannot be changed here.";
+    registerCampaignUpdateTool("update_campaign", updateCampaignDescription);
+    registerCampaignUpdateTool("update_campaign_configuration", updateCampaignDescription);
     server.tool("delete_campaign", "Irreversibly delete one OPEN campaign that is DRAFT or PAUSED. Active and permanently closed campaigns are refused. This operation never sends outreach. Always confirm with the user before calling this tool.", {
         id: z.string().describe("Campaign ID."),
         confirmation: z.literal("delete_campaign").describe("Exact acknowledgement required before deleting the campaign."),

package/dist/tools/person_employment.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPersonEmploymentTools(server: McpServer, client?: import("../client.js").LeadifyClient): void;

package/dist/tools/person_employment.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError, toolResult } from "../types.js";
+export function registerPersonEmploymentTools(server, client = getClient()) {
+    server.tool("upsert_person_leads_with_employment", "Atomically create or reconcile Person Leads with their canonical PERSON identity, EMPLOYED_BY relationship, parent_lead/child_leads projections, evidence and append-only card_history. company_lead_id must be exact and already project an Account plus Legal Entity or compatible Establishment. Each batch entry is independently transactional and idempotent. This is the only supported Person write path for sourcing; never fall back to add_leads, canonical backfill, or separate relationship writes. It never qualifies, enriches contact details, sends outreach, creates campaigns, or activates anything.", {
+        people: z.array(z.object({
+            organization_id: z.string().trim().min(1),
+            person_group_id: z.string().trim().min(1),
+            company_lead_id: z.string().trim().min(1),
+            person_lead_id: z.string().trim().min(1).optional(),
+            fields: z.record(z.unknown()),
+            card_history_append: z.string().trim().min(1).max(100_000),
+            evidence_ids: z.array(z.string().trim().min(1)).min(1).max(100),
+            idempotency_key: z.string().trim().min(1).max(220),
+        }).strict()).min(1).max(100),
+    }, async ({ people }) => {
+        try {
+            return toolResult(await client.post("/api/person-employment/upsert", {
+                people: people.map((person) => ({
+                    organizationId: person.organization_id,
+                    personGroupId: person.person_group_id,
+                    companyLeadId: person.company_lead_id,
+                    personLeadId: person.person_lead_id,
+                    fields: person.fields,
+                    cardHistoryAppend: person.card_history_append,
+                    evidenceIds: person.evidence_ids,
+                    idempotencyKey: person.idempotency_key,
+                })),
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/package.json

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