@agifyai/leadify-mcp 8.4.0 → 8.4.2

package/README.md

@@ -4,6 +4,8 @@ Serveur MCP (Model Context Protocol) pour l'API Leadify. Expose les endpoints RE
 
 Package npm : [`@agifyai/leadify-mcp`](https://www.npmjs.com/package/@agifyai/leadify-mcp)
 
+`get_mcp_runtime_info` est le diagnostic de livraison en lecture seule. Il expose la version exacte du package et du serveur, puis vérifie qu'un `organization_id` explicitement choisi est accessible à la clé configurée. Il ne lit aucun prospect et n'effectue aucune écriture, aucun envoi, aucune publication ni activation.
+
 ---
 
 ## 📦 Pour les utilisateurs
@@ -193,6 +195,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/server.js

@@ -15,10 +15,11 @@ import { registerFineTuningTools } from "./tools/fine_tuning.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
 import { registerLeadViewTools } from "./tools/views.js";
 import { registerRelationshipTools } from "./tools/relationships.js";
+import { MCP_SERVER_NAME, MCP_VERSION } from "./version.js";
 export function createServer() {
     const server = new McpServer({
-        name: "leadify",
-        version: "8.4.0",
+        name: MCP_SERVER_NAME,
+        version: MCP_VERSION,
     });
     registerAuthTools(server);
     registerOrganizationTools(server);

package/dist/tools/auth.d.ts

@@ -1,2 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerAuthTools(server: McpServer): void;
+import { getClient } from "../client.js";
+type ReadClient = Pick<ReturnType<typeof getClient>, "get">;
+export declare function projectMcpRuntimeInfo(data: unknown, organizationId: string): Record<string, unknown>;
+export declare function registerAuthTools(server: McpServer, injectedClient?: ReadClient): void;
+export {};

package/dist/tools/auth.js

@@ -1,16 +1,45 @@
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
-export function registerAuthTools(server) {
+import { z } from "zod";
+import { MCP_PACKAGE_NAME, MCP_SERVER_NAME, MCP_VERSION } from "../version.js";
+export function projectMcpRuntimeInfo(data, organizationId) {
+    const source = data && typeof data === "object" ? data : {};
+    const organizations = Array.isArray(source.organizations) ? source.organizations : [];
+    const organization = organizations.find((candidate) => candidate.id === organizationId);
+    return {
+        package: MCP_PACKAGE_NAME,
+        server: MCP_SERVER_NAME,
+        version: MCP_VERSION,
+        organization: organization ? { id: organization.id, name: organization.name ?? null, slug: organization.slug ?? null } : null,
+        organizationAccessible: Boolean(organization),
+        readOnly: true,
+        writes: 0,
+        sends: 0,
+        externalActivation: 0,
+    };
+}
+export function registerAuthTools(server, injectedClient) {
     server.tool("test_api_key", "Verify that the configured Leadify API key is valid and has not been revoked. " +
         "Returns a success message if the key is active. Use this as a health check " +
         "before performing other operations, or to diagnose authentication errors " +
         "(401/403) from other tools.", {}, async () => {
         try {
-            const data = await getClient().get("/test-api-key");
+            const data = await (injectedClient ?? getClient()).get("/test-api-key");
             return toolResult(data);
         }
         catch (error) {
             return handleToolError(error);
         }
     });
+    server.tool("get_mcp_runtime_info", "Read the exact Leadify MCP package/server version and verify that one explicitly selected organization is accessible to the configured API key. This diagnostic is read-only: it never reads prospects and never writes, sends, schedules, publishes, or activates anything.", {
+        organization_id: z.string().min(1).describe("Exact organization ID selected by the caller. The server never chooses an organization implicitly."),
+    }, async ({ organization_id }) => {
+        try {
+            const data = await (injectedClient ?? getClient()).get("/api/organizations");
+            return toolResult(projectMcpRuntimeInfo(data, organization_id));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
 }

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/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
+export declare const MCP_SERVER_NAME = "leadify";
+export declare const MCP_VERSION = "8.4.2";

package/dist/version.js

@@ -0,0 +1,3 @@
+export const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
+export const MCP_SERVER_NAME = "leadify";
+export const MCP_VERSION = "8.4.2";

package/package.json

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