@agifyai/leadify-mcp 1.4.1

package/dist/tools/schema.d.ts

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

package/dist/tools/schema.js

@@ -0,0 +1,130 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { toolResult, handleToolError } from "../types.js";
+export function registerSchemaTools(server) {
+    // ── update_schema ──────────────────────────────────────────────────────
+    server.tool("update_schema", "Add or modify field definitions in a lead group's schema. Each field update " +
+        "specifies the internal field name, display label, data type, whether it's required, " +
+        "and options for select/multiselect types. Available types: string, textarea, email, " +
+        "phone, number, date, boolean, select, multiselect, url. Requires admin permissions. " +
+        "Use this to configure how fields appear and behave in the Leadify UI — for example, " +
+        "adding a new 'status' dropdown or changing a field's label.", {
+        lead_group_id: z
+            .string()
+            .describe("ID of the lead group whose schema to update."),
+        schema_updates: z
+            .array(z.object({
+            field_name: z
+                .string()
+                .describe("Internal field name in the schema (e.g. 'status', 'notes')."),
+            label: z
+                .string()
+                .describe("Display label shown in the UI (e.g. 'Statut', 'Notes')."),
+            type: z
+                .enum([
+                "string",
+                "textarea",
+                "email",
+                "phone",
+                "number",
+                "date",
+                "boolean",
+                "select",
+                "multiselect",
+                "url",
+            ])
+                .describe("Data type of the field."),
+            required: z
+                .boolean()
+                .optional()
+                .describe("Whether the field is required when creating/updating leads."),
+            options: z
+                .array(z.string())
+                .optional()
+                .describe("List of allowed values for 'select' and 'multiselect' field types. " +
+                "Ignored for other types."),
+        }))
+            .min(1)
+            .describe("Array of field definitions to add or update."),
+    }, async ({ lead_group_id, schema_updates }) => {
+        try {
+            const body = {
+                leadGroupId: lead_group_id,
+                schemaUpdates: schema_updates.map((u) => ({
+                    schemaFieldName: u.field_name,
+                    label: u.label,
+                    type: u.type,
+                    ...(u.required !== undefined ? { required: u.required } : {}),
+                    ...(u.options ? { options: u.options } : {}),
+                })),
+            };
+            const data = await getClient().post("/update-schema", body);
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── delete_columns ─────────────────────────────────────────────────────
+    server.tool("delete_columns", "Remove one or more columns (fields) from a lead group's schema and all lead data " +
+        "stored in those fields. This action is irreversible — field definitions and values " +
+        "across all leads in the group are permanently deleted. Requires admin permissions. " +
+        "Always confirm with the user before calling this tool.", {
+        lead_group_id: z
+            .string()
+            .describe("ID of the lead group to remove columns from."),
+        column_names: z
+            .array(z.string())
+            .min(1)
+            .describe("Array of column/field names to delete."),
+    }, async ({ lead_group_id, column_names }) => {
+        try {
+            const body = {
+                leadGroupId: lead_group_id,
+            };
+            if (column_names.length === 1) {
+                body.columnName = column_names[0];
+            }
+            else {
+                body.columnNames = column_names;
+            }
+            const data = await getClient().post("/delete-column", body);
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── update_hidden_columns ──────────────────────────────────────────────
+    server.tool("update_hidden_columns", "Show or hide columns in a lead group's table view without deleting underlying data. " +
+        "Hidden columns still exist in the schema and retain their values but are not " +
+        "displayed in the default UI table. Requires admin permissions. Use this to " +
+        "declutter the interface while preserving data — unlike delete_columns, this is reversible.", {
+        lead_group_id: z
+            .string()
+            .describe("ID of the lead group to configure."),
+        add_hidden: z
+            .array(z.string())
+            .optional()
+            .describe("Column names to hide from the table view."),
+        remove_hidden: z
+            .array(z.string())
+            .optional()
+            .describe("Column names to make visible again in the table view."),
+    }, async ({ lead_group_id, add_hidden, remove_hidden }) => {
+        try {
+            const body = {
+                leadGroupId: lead_group_id,
+            };
+            if (add_hidden)
+                body.addHiddenColumns = add_hidden;
+            if (remove_hidden)
+                body.removeHiddenColumns = remove_hidden;
+            const data = await getClient().post("/update-hidden-columns", body);
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/tools/signals.d.ts

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

package/dist/tools/signals.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { toolResult, handleToolError } from "../types.js";
+export function registerSignalTools(server) {
+    // ── add_signal ─────────────────────────────────────────────────────────
+    server.tool("add_signal", "Attach a business intelligence signal to a lead. Signals report key events picked " +
+        "up by external agents — budget approvals, position changes, tender publications, " +
+        "etc. Each signal has a level (INFO, CRITICAL, GOLDEN) and is shown in the lead's " +
+        "feed. Use GOLDEN sparingly for truly actionable buying-intent signals.", {
+        lead_id: z.string().describe("ID of the target lead."),
+        level: z
+            .enum(["INFO", "CRITICAL", "GOLDEN"])
+            .describe("Signal priority level."),
+        title: z
+            .string()
+            .describe("Short title of the signal (e.g. 'Budget IRM approuvé')."),
+        content: z
+            .string()
+            .describe("Detailed description of the signal."),
+        agent_source: z
+            .string()
+            .optional()
+            .describe("Short identifier of the source agent. MUST be 3 to 4 words max, " +
+            "kebab-case or space-separated (e.g. 'leadify qualification', " +
+            "'briefify research', 'dealmind coach'). Default: 'unknown'."),
+        source_url: z
+            .string()
+            .url()
+            .optional()
+            .describe("URL of the original information source."),
+    }, async ({ lead_id, level, title, content, agent_source, source_url }) => {
+        try {
+            const body = {
+                leadId: lead_id,
+                level,
+                title,
+                content,
+            };
+            if (agent_source !== undefined)
+                body.agentSource = agent_source;
+            if (source_url !== undefined)
+                body.sourceUrl = source_url;
+            const data = await getClient().post("/add-signal", body);
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export declare class LeadifyApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: unknown;
+    constructor(statusCode: number, responseBody: unknown);
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function toolResult(data: unknown): ToolResult;
+export declare function toolError(message: string, details?: unknown): ToolResult;
+export declare function handleToolError(error: unknown): ToolResult;

package/dist/types.js

@@ -0,0 +1,38 @@
+export class LeadifyApiError extends Error {
+    statusCode;
+    responseBody;
+    constructor(statusCode, responseBody) {
+        const msg = typeof responseBody === "object" &&
+            responseBody !== null &&
+            "error" in responseBody
+            ? String(responseBody.error)
+            : `HTTP ${statusCode}`;
+        super(msg);
+        this.name = "LeadifyApiError";
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+export function toolResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function toolError(message, details) {
+    const error = { error: message };
+    if (details !== undefined)
+        error.details = details;
+    return {
+        content: [{ type: "text", text: JSON.stringify(error, null, 2) }],
+        isError: true,
+    };
+}
+export function handleToolError(error) {
+    if (error instanceof LeadifyApiError) {
+        return toolError(error.message, {
+            statusCode: error.statusCode,
+            response: error.responseBody,
+        });
+    }
+    return toolError(error instanceof Error ? error.message : String(error));
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@agifyai/leadify-mcp",
+  "version": "1.4.1",
+  "description": "MCP server for Leadify lead management API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "leadify-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgifyAI/mcp_leadify.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}