@agifyai/leadify-mcp 8.6.11 → 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. |

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