@agifyai/leadify-mcp 8.7.1 → 8.7.2

package/README.md

@@ -233,6 +233,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `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. |
+| `create_person_employment_evidence` / `get_person_employment_evidence` | Créer puis relire une preuve d’emploi individuelle tenant-scopée ; transmettre l’`evidence.id` retourné tel quel à l’upsert Person. |
 | `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. |
@@ -320,3 +321,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `append_fine_tuning` | Appendre du contenu à une section du Fine Tuning (nonNegotiableRules, pitfalls, structure, examples). Toujours en mode append — garantie contractuelle. |
 | `set_fine_tuning_output_config` | Remplacer uniquement la configuration métier de sorties d’un Fine Tuning (`linkedinConnection`, `linkedinMessage`, `email`, activations et quantités). Préserve Markdown, langues et fallback ; ne génère, ne planifie, n’active ni n’envoie aucun outreach. |
 | `pipeline_next_lead` | Sélectionner le prochain lead à traiter (score descendant, sans message). Exclusion des IDs déjà vus, limit 1-5. |
+
+### `source-icp-prospects` : preuve d’emploi
+
+Pour chaque candidat accepté, créer `create_person_employment_evidence` avec le tenant, la Company Lead, l’identité Person, la provenance et une clé idempotente. Relire si nécessaire avec `get_person_employment_evidence`, puis transmettre exclusivement l’`evidence.id` retourné dans `evidence_ids` de `upsert_person_leads_with_employment`.

package/dist/tools/person_employment.js

@@ -1,7 +1,49 @@
 import { z } from "zod";
 import { getClient } from "../client.js";
 import { handleToolError, toolResult } from "../types.js";
+const evidenceDate = z.string().datetime();
+const evidenceId = z.string().trim().min(1);
 export function registerPersonEmploymentTools(server, client = getClient()) {
+    server.tool("create_person_employment_evidence", "Create one tenant-scoped, idempotent employment proof for an exact Person and Company Lead. Use the returned evidence.id unchanged in upsert_person_leads_with_employment; do not invent or reuse Company or event evidence IDs.", {
+        organization_id: z.string().trim().min(1),
+        company_lead_id: z.string().trim().min(1),
+        person: z.object({
+            full_name: z.string().trim().min(1).max(500),
+            email: z.string().trim().email().max(320).optional(),
+            linkedin_url: z.string().trim().url().max(2_000).optional(),
+        }).strict(),
+        provider: z.string().trim().min(1).max(120),
+        source_url: z.string().trim().url().max(2_000),
+        excerpt: z.string().trim().min(1).max(20_000),
+        observed_at: evidenceDate,
+        verified_at: evidenceDate,
+        idempotency_key: z.string().trim().min(1).max(220),
+    }, async ({ organization_id, company_lead_id, person, provider, source_url, excerpt, observed_at, verified_at, idempotency_key }) => {
+        try {
+            return toolResult(await client.post("/api/person-employment/evidence", {
+                organizationId: organization_id,
+                companyLeadId: company_lead_id,
+                person: { fullName: person.full_name, email: person.email, linkedinUrl: person.linkedin_url },
+                provider,
+                sourceUrl: source_url,
+                excerpt,
+                observedAt: observed_at,
+                verifiedAt: verified_at,
+                idempotencyKey: idempotency_key,
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("get_person_employment_evidence", "Read back one employment proof only within the explicitly selected tenant. Use this to obtain or verify the evidence.id before the atomic Person employment upsert.", { organization_id: z.string().trim().min(1), evidence_id: evidenceId }, async ({ organization_id, evidence_id }) => {
+        try {
+            return toolResult(await client.get(`/api/person-employment/evidence/${encodeURIComponent(evidence_id)}`, new URLSearchParams({ organizationId: organization_id })));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     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),

package/package.json

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