@agifyai/leadify-mcp 1.5.0 → 1.5.2

package/dist/tools/pipeline.d.ts

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

package/dist/tools/pipeline.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { toolResult, handleToolError } from "../types.js";
+export function registerPipelineTools(server) {
+    // ── trigger_outreach ─────────────────────────────────────────────────────
+    server.tool("trigger_outreach", "Generate an outreach message for a lead via the Trigger.dev agent. " +
+        "DRY-RUN BY DEFAULT (dryrun=true) — the agent runs all logic (analysis, messaging, research) " +
+        "but NEVER persists anything to the database. Essential for iterating on messages via the " +
+        "MCP pipeline without polluting the DB. Use dryrun=false for production writes. " +
+        "The 'force' flag (default false) bypasses the 'already has a message?' guard — " +
+        "useful for re-generating on an already-processed lead. " +
+        "Waits up to 120s for the remote agent to complete.", {
+        lead_id: z.string().describe("ID of the lead to generate a message for."),
+        dryrun: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("true (default) = dry-run mode: agent runs but writes nothing to DB. " +
+            "false = production mode: agent writes card_message, card_analysis, etc. to lead.data."),
+        force: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("true = bypass the 'already has a message?' check so you can re-generate. " +
+            "false (default) = normal behaviour: skip leads that already have card_message."),
+    }, async ({ lead_id, dryrun, force }) => {
+        try {
+            const data = await getClient().post("/api/trigger-outreach", {
+                leadId: lead_id,
+                dryrun,
+                force,
+            });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── append_fine_tuning ───────────────────────────────────────────────────
+    server.tool("append_fine_tuning", "Append content to a Fine Tuning section for a lead group. " +
+        "ALWAYS in append mode — NEVER replaces existing content (contractual guarantee). " +
+        "Use this to incrementally build up rules and examples as you iterate with the user. " +
+        "Sections: nonNegotiableRules (imperative rules), pitfalls (traps to avoid), " +
+        "structure (imposed message structure), examples (validated message samples). " +
+        "For full rewrites, use the Leadify UI or the classic update endpoint.", {
+        lead_group_id: z.string().describe("ID of the lead group."),
+        section: z
+            .enum(["nonNegotiableRules", "pitfalls", "structure", "examples"])
+            .describe("Fine Tuning section to enrich."),
+        content: z
+            .string()
+            .describe("Content to APPEND (not replace). Concatenated after existing content."),
+        separator: z
+            .string()
+            .optional()
+            .default("\n\n---\n\n")
+            .describe("Separator between old and new content. Default: '\\n\\n---\\n\\n'."),
+    }, async ({ lead_group_id, section, content, separator }) => {
+        try {
+            const data = await getClient().post("/api/pipeline/append-fine-tuning", {
+                leadGroupId: lead_group_id,
+                section,
+                content,
+                separator,
+            });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ── pipeline_next_lead ───────────────────────────────────────────────────
+    server.tool("pipeline_next_lead", "Select the next lead to process in the campaign pipeline. " +
+        "Returns the hottest leads (highest score) that don't yet have a message " +
+        "(card_message empty or missing). Exclude already-processed leads via exclude_lead_ids. " +
+        "Call this at the start of each pipeline iteration to get a fresh lead.", {
+        lead_group_id: z.string().describe("ID of the lead group to query."),
+        exclude_lead_ids: z
+            .array(z.string())
+            .optional()
+            .default([])
+            .describe("IDs of leads already processed in this session (to avoid duplicates)."),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(5)
+            .optional()
+            .default(1)
+            .describe("Maximum number of leads to return (1-5, default 1)."),
+    }, async ({ lead_group_id, exclude_lead_ids, limit }) => {
+        try {
+            const data = await getClient().post("/api/pipeline/next-lead", {
+                leadGroupId: lead_group_id,
+                excludeLeadIds: exclude_lead_ids,
+                limit,
+            });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/types.js

@@ -29,6 +29,17 @@ export function toolError(message, details) {
 }
 export function handleToolError(error) {
     if (error instanceof LeadifyApiError) {
+        // If the backend returned a cumulative ZodIssue list (formatZodError now
+        // emits `issues[]` on every 422), surface the count up-front in the
+        // message so the caller can fix every field in a single retry instead
+        // of looping one-error-at-a-time on the legacy `error` field.
+        const body = error.responseBody;
+        if (body && typeof body === "object" && !Array.isArray(body) && "issues" in body) {
+            const issues = body.issues;
+            if (Array.isArray(issues) && issues.length > 1) {
+                return toolError(`Validation failed: ${issues.length} issues. See details.response.issues[] for every path that needs fixing.`, { statusCode: error.statusCode, response: body });
+            }
+        }
         return toolError(error.message, {
             statusCode: error.statusCode,
             response: error.responseBody,

package/package.json

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