@agifyai/leadify-mcp 8.4.0 → 8.4.1

package/README.md

@@ -193,6 +193,11 @@ Conséquences pratiques :
 | `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. |
 | `update_lead` | Mettre à jour un ou plusieurs champs d'un lead existant. |
+
+Pour `add_leads` et `update_lead`, `location` utilise l’objet canonique
+`{ city, region?, postalCode?, countryCode, street? }`. `city` et le code pays
+ISO-2 `countryCode` sont obligatoires. La projection `geo` est calculée par
+Leadify et ne doit jamais être envoyée par un agent MCP.
 | `delete_sequence_messages` | Supprimer uniquement les messages de séquence générés d'un lead, après confirmation explicite. |
 | `delete_leads` | Supprimer définitivement des leads par leurs IDs. |
 | `update_schema` | Ajouter ou modifier les définitions de champs d'un groupe. |

package/dist/tools/leads.js

@@ -2,6 +2,37 @@ import { z } from "zod";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
 const DEFAULT_LEAD_FIELDS = ["firstName", "lastName", "email", "company", "jobTitle", "linkedin"];
+const canonicalLocationSchema = z.object({
+    city: z.string().trim().min(1).max(200),
+    region: z.string().trim().min(1).max(500).optional(),
+    postalCode: z.string().trim().min(1).max(500).optional(),
+    countryCode: z.string().trim().regex(/^[A-Za-z]{2}$/).transform((value) => value.toUpperCase()),
+    street: z.string().trim().min(1).max(500).optional(),
+}).strict().describe("Canonical Leadify location source. city and ISO-2 countryCode are required; region, postalCode and street are optional. geo is system-owned and forbidden.");
+const leadInputSchema = z.record(z.unknown()).superRefine((lead, context) => {
+    if (!Object.hasOwn(lead, "location"))
+        return;
+    const parsed = canonicalLocationSchema.safeParse(lead.location);
+    if (!parsed.success) {
+        for (const issue of parsed.error.issues) {
+            context.addIssue({ ...issue, path: ["location", ...issue.path] });
+        }
+    }
+});
+const leadUpdateSchema = z.object({
+    property_name: z.string().describe("Name of the field to update (e.g. 'email', 'status', 'card_analysis')."),
+    value: z.unknown().describe("New value for the field. location must use the canonical object; location.geo is forbidden."),
+    is_select: z.boolean().optional().describe("If true, the field is created/updated as a 'select' dropdown type. Use for categorical fields like status, source, etc."),
+}).superRefine((update, context) => {
+    if (update.property_name !== "location")
+        return;
+    const parsed = canonicalLocationSchema.safeParse(update.value);
+    if (!parsed.success) {
+        for (const issue of parsed.error.issues) {
+            context.addIssue({ ...issue, path: ["value", ...issue.path] });
+        }
+    }
+});
 function projectLead(lead, fields) {
     const source = lead && typeof lead === "object" ? lead : {};
     const data = source.data && typeof source.data === "object" ? source.data : {};
@@ -32,10 +63,10 @@ export function registerLeadTools(server, client = getClient()) {
             .string()
             .describe("ID of the lead group to add leads to."),
         leads: z
-            .array(z.record(z.unknown()))
+            .array(leadInputSchema)
             .describe("Array of lead objects. Each object is a key-value map of field names to values. " +
             "Common fields: email, firstName, lastName, company, jobTitle, phone, linkedin, " +
-            "website, location, seniority, specialty, age. Also supports card_* fields, " +
+            "website, seniority, specialty, age. location must be {city, region?, postalCode?, countryCode, street?}; geo is computed by Leadify. Also supports card_* fields, " +
             "percent_* fields and boolean flags (decisionMaking, excluded). Canonical relation fields are rejected."),
         is_select_fields: z
             .array(z.string())
@@ -152,22 +183,11 @@ export function registerLeadTools(server, client = getClient()) {
         "Supports all field types including special fields (card_*, percent_*, boolean flags " +
         "like decisionMaking/excluded). When a configured canonical relation field is changed, " +
         "the backend routes it through the typed relationship service and keeps the JSON field read-only. Returns the updated lead. " +
+        "location must be the canonical object {city, region?, postalCode?, countryCode, street?}; never submit geo. " +
         "For bulk updates across many leads, call this tool once per lead.", {
         lead_id: z.string().describe("ID of the lead to update."),
         updates: z
-            .array(z.object({
-            property_name: z
-                .string()
-                .describe("Name of the field to update (e.g. 'email', 'status', 'card_analysis')."),
-            value: z
-                .unknown()
-                .describe("New value for the field. Type depends on the field."),
-            is_select: z
-                .boolean()
-                .optional()
-                .describe("If true, the field is created/updated as a 'select' dropdown type. " +
-                "Use for categorical fields like status, source, etc."),
-        }))
+            .array(leadUpdateSchema)
             .min(1)
             .describe("Array of field updates to apply."),
     }, async ({ lead_id, updates }) => {

package/package.json

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