@elitedcs/ghl-mcp 3.2.0 → 3.3.1

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.2.0",
-      description: "GoHighLevel MCP Server for Claude. 173 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.3.1",
+      description: "GoHighLevel MCP Server for Claude. 174 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -41,6 +41,7 @@ var require_package = __commonJS({
         "dist/index.js",
         "templates/action-schemas.json",
         "templates/clinic-medspa.json",
+        "templates/trigger-schemas.json",
         "README.md",
         "CHANGELOG.md"
       ],
@@ -405,12 +406,24 @@ var TriggerCommonSchema = import_zod2.z.object({
   schedule_config: import_zod2.z.record(import_zod2.z.unknown()).optional(),
   date_updated: import_zod2.z.string().optional()
 }).passthrough();
-function typedTrigger(typeLiteral, knownFields) {
-  const fieldDesc = knownFields.length === 0 ? "No filter fields \u2014 trigger matches any event of this type." : `Known field paths: ${knownFields.join(", ")}.`;
+function describe(status, knownFields) {
+  switch (status) {
+    case "fieldless":
+      return "No filter fields \u2014 trigger fires on any event of this type.";
+    case "documented":
+      return `Known field paths: ${knownFields.join(", ")}.`;
+    case "partial":
+      return knownFields.length > 0 ? `Known field paths: ${knownFields.join(", ")}. Note: GHL exposes additional filter fields that aren't yet captured; pass them through if known.` : "GHL exposes one or more filter fields for this trigger; the exact field paths are not yet captured. Pass through whatever you know from the GHL UI.";
+    case "uncaptured":
+      return "Filter field paths not yet captured. Pass through whatever fields you know from the GHL UI; reads will accept any.";
+  }
+}
+function typedTrigger(typeLiteral, knownFields, status = "documented") {
+  const fieldDesc = describe(status, knownFields);
   return TriggerCommonSchema.extend({
     type: import_zod2.z.literal(typeLiteral),
     conditions: import_zod2.z.array(import_zod2.z.object({
-      operator: import_zod2.z.string().describe("Comparison operator (equals, greater_than, less_than, contains, index-of-true, etc.)."),
+      operator: import_zod2.z.string().describe("Comparison operator (equals, greater_than, less_than, contains, index-of-true, is-any-of, etc.)."),
       field: import_zod2.z.string().describe(fieldDesc),
       value: import_zod2.z.unknown().optional(),
       title: import_zod2.z.string().optional(),
@@ -430,9 +443,6 @@ var ContactTagTriggerSchema = TriggerCommonSchema.extend({
     id: import_zod2.z.string().optional()
   }).passthrough())
 });
-var CustomerReplyTriggerSchema = typedTrigger("customer_reply", [
-  // No fields in the catalogue — Customer Reply matches any inbound message.
-]);
 var AppointmentTriggerSchema = typedTrigger("appointment", [
   "calendar.id",
   "appointment.status",
@@ -441,15 +451,105 @@ var AppointmentTriggerSchema = typedTrigger("appointment", [
   "appointment.eventType",
   "appointment.modifiedBy"
 ]);
-var PipelineStageUpdatedTriggerSchema = typedTrigger("pipeline_stage_updated", [
-  "opportunity.pipelineId",
-  "opportunity.pipelineStageId",
+var BirthdayReminderTriggerSchema = typedTrigger("birthday_reminder", [
+  "contact.birthMonth",
+  "contact.birthDay",
+  "contact.dateOfBirth"
+]);
+var CallStatusTriggerSchema = typedTrigger("call_status", [
+  "call_status",
+  "custom_disposition",
+  "message.direction",
+  "workflow.id"
+]);
+var CategoryCompletedTriggerSchema = typedTrigger("category_completed", [
+  "membership.product.id"
+]);
+var CategoryStartedTriggerSchema = typedTrigger("category_started", [
+  "membership.product.id"
+]);
+var ContactChangedTriggerSchema = typedTrigger("contact_changed", [
+  "contact.tags",
+  "contact.dnd",
+  "contact.assignedTo",
+  "contact.phone",
+  "contact.email",
+  "contact.type",
+  "contact.address1",
+  "contact.city",
+  "contact.state",
+  "contact.country",
+  "contact.postalCode",
+  "contact.website"
+]);
+var ContactCreatedTriggerSchema = typedTrigger("contact_created", [
+  "tagsAdded",
+  "contact.phone",
+  "contact.email",
+  "contact.type"
+]);
+var CustomerAppointmentTriggerSchema = typedTrigger("customer_appointment", [
+  "calendar.id",
+  "contact.tags"
+]);
+var CustomerReplyTriggerSchema = typedTrigger("customer_reply", [
+  "workflow.id",
+  "message.type",
+  "message.body",
+  "contact.tags"
+]);
+var DndContactTriggerSchema = typedTrigger("dnd_contact", [
+  "contact.dnd_direction",
+  "contact.dnd",
   "contact.tags"
 ]);
 var FormSubmissionTriggerSchema = typedTrigger("form_submission", [
   "form.id",
   "formData.termsAndConditions"
 ]);
+var InvoiceTriggerSchema = typedTrigger("invoice", [
+  "invoice.status",
+  "contact.tags"
+]);
+var IvrIncomingCallTriggerSchema = typedTrigger("ivr_incoming_call", [
+  "inbound_number"
+]);
+var LessonCompletedTriggerSchema = typedTrigger("lesson_completed", [
+  "membership.product.id"
+]);
+var LessonStartedTriggerSchema = typedTrigger("lesson_started", [
+  "membership.product.id"
+]);
+var MailgunEmailEventTriggerSchema = typedTrigger("mailgun_email_event", [
+  "workflow.id",
+  "mailgun.event"
+  // opened | clicked | bounced | delivered | etc.
+]);
+var MembershipContactCreatedTriggerSchema = typedTrigger("membership_contact_created", [
+  "offer.id"
+]);
+var NoteAddTriggerSchema = typedTrigger("note_add", [
+  "contact.tags"
+]);
+var NoteChangedTriggerSchema = typedTrigger("note_changed", [
+  "contact.tags"
+]);
+var OfferAccessGrantedTriggerSchema = typedTrigger("offer_access_granted", [
+  "offer.id"
+]);
+var OfferAccessRemovedTriggerSchema = typedTrigger("offer_access_removed", [
+  "offer.id"
+]);
+var OpportunityChangedTriggerSchema = typedTrigger("opportunity_changed", [
+  "opportunity.pipelineId",
+  "contact.tags",
+  "opportunity.assignedTo",
+  "opportunity.monetaryValue",
+  "opportunity.forecastExpectedCloseDate",
+  "opportunity.forecastProbability",
+  "opportunity.status",
+  "opportunity.lostReasonId"
+]);
 var OpportunityCreatedTriggerSchema = typedTrigger("opportunity_created", [
   "opportunity.pipelineId",
   "contact.tags",
@@ -460,8 +560,9 @@ var OpportunityCreatedTriggerSchema = typedTrigger("opportunity_created", [
   "opportunity.status",
   "opportunity.lostReasonId"
 ]);
-var OpportunityChangedTriggerSchema = typedTrigger("opportunity_changed", [
+var OpportunityDecayTriggerSchema = typedTrigger("opportunity_decay", [
   "opportunity.pipelineId",
+  "opportunity.lastActionDate",
   "contact.tags",
   "opportunity.assignedTo",
   "opportunity.monetaryValue",
@@ -481,44 +582,146 @@ var OpportunityStatusChangedTriggerSchema = typedTrigger("opportunity_status_cha
   "opportunity.forecastProbability",
   "opportunity.lostReasonId"
 ]);
-var PaymentReceivedTriggerSchema = typedTrigger("payment_received", [
-  // No filter fields — fires on any payment received.
+var PipelineStageUpdatedTriggerSchema = typedTrigger("pipeline_stage_updated", [
+  "opportunity.pipelineId",
+  "opportunity.pipelineStageId",
+  // not in catalogue but central to this trigger by name
+  "contact.tags",
+  "opportunity.assignedTo",
+  "opportunity.monetaryValue",
+  "opportunity.forecastExpectedCloseDate",
+  "opportunity.forecastProbability",
+  "opportunity.status",
+  "opportunity.lostReasonId"
 ]);
-var InboundWebhookTriggerSchema = typedTrigger("inbound_webhook", [
-  // No filter fields — fires on any inbound webhook hit.
+var ProductAccessGrantedTriggerSchema = typedTrigger("product_access_granted", [
+  "product.id"
 ]);
-var MailgunEmailEventTriggerSchema = typedTrigger("mailgun_email_event", [
-  "workflow.id",
-  "mailgun.event"
-  // opened | clicked | bounced | delivered | etc.
+var ProductAccessRemovedTriggerSchema = typedTrigger("product_access_removed", [
+  "product.id"
 ]);
-var NoteAddTriggerSchema = typedTrigger("note_add", [
-  "contact.tags"
+var ProductCompletedTriggerSchema = typedTrigger("product_completed", [
+  "membership.product.id"
+]);
+var ProductStartedTriggerSchema = typedTrigger("product_started", [
+  "membership.product.id"
+]);
+var ShopifyAbandonedCartTriggerSchema = typedTrigger("shopify_abandoned_cart", [
+  "duration",
+  "cart_value"
+]);
+var ShopifyOrderFulfilledTriggerSchema = typedTrigger("shopify_order_fulfilled", [
+  "cart_value"
+]);
+var ShopifyOrderPlacedTriggerSchema = typedTrigger("shopify_order_placed", [
+  "cart_value"
+]);
+var SurveySubmissionTriggerSchema = typedTrigger("survey_submission", [
+  "survey.id",
+  "surveySubmission.disqualified",
+  "surveyData.termsAndConditions"
 ]);
 var TaskAddedTriggerSchema = typedTrigger("task_added", [
   "task.assignedTo"
 ]);
+var TaskDueDateReminderTriggerSchema = typedTrigger("task_due_date_reminder", [
+  "task.dueDate"
+]);
+var TikTokFormSubmittedTriggerSchema = typedTrigger("tik_tok_form_submitted", [
+  "tikTok.formId"
+]);
+var TriggerLinkTriggerSchema = typedTrigger("trigger_link", [
+  "link.id"
+]);
+var TwoStepFormSubmissionTriggerSchema = typedTrigger("two_step_form_submission", [
+  "twoStepOrderForm.funnelId",
+  "twoStepOrderForm.submissionType"
+]);
+var ValidationErrorTriggerSchema = typedTrigger("validation_error", [
+  "contact.phoneInfo"
+]);
+var VideoEventTriggerSchema = typedTrigger("video_event", [
+  "video.funnelId",
+  "video.videoId",
+  "video.duration"
+]);
+var CustomDateReminderTriggerSchema = typedTrigger("custom_date_reminder", [], "partial");
+var InboundTriggerTriggerSchema = typedTrigger("inbound_trigger", ["contact.tags"], "partial");
+var FacebookCommentOnPostTriggerSchema = typedTrigger("facebook_comment_on_post", [], "partial");
+var IgCommentOnPostTriggerSchema = typedTrigger("ig_comment_on_post", [], "partial");
+var InboundWebhookTriggerSchema = typedTrigger("inbound_webhook", [], "fieldless");
+var PaymentReceivedTriggerSchema = typedTrigger("payment_received", [], "fieldless");
+var AffiliateCreatedTriggerSchema = typedTrigger("affiliate_created", [], "uncaptured");
+var SchedulerTriggerTriggerSchema = typedTrigger("scheduler_trigger", [], "uncaptured");
+var UserLogInTriggerSchema = typedTrigger("user_log_in", [], "uncaptured");
+var OrderSubmissionTriggerSchema = typedTrigger("order_submission", [], "uncaptured");
+var ConvAiTriggerTriggerSchema = typedTrigger("conv_ai_trigger", [], "uncaptured");
+var ConvAiAutonomousTriggerTriggerSchema = typedTrigger("conv_ai_autonomous_trigger", [], "uncaptured");
+var CustomObjectCreatedTriggerSchema = typedTrigger("custom_object_created", [], "uncaptured");
+var CustomObjectChangedTriggerSchema = typedTrigger("custom_object_changed", [], "uncaptured");
+var FacebookLeadGenTriggerSchema = typedTrigger("facebook_lead_gen", [], "uncaptured");
 var UnknownTriggerSchema = TriggerCommonSchema.extend({
   type: import_zod2.z.string(),
   conditions: import_zod2.z.array(import_zod2.z.record(import_zod2.z.unknown())).optional()
 });
 var WorkflowTriggerSchema = import_zod2.z.union([
-  // Originally typed (v3.0.x)
   ContactTagTriggerSchema,
-  CustomerReplyTriggerSchema,
   AppointmentTriggerSchema,
-  PipelineStageUpdatedTriggerSchema,
-  // Added in v3.2.0
+  BirthdayReminderTriggerSchema,
+  CallStatusTriggerSchema,
+  CategoryCompletedTriggerSchema,
+  CategoryStartedTriggerSchema,
+  ContactChangedTriggerSchema,
+  ContactCreatedTriggerSchema,
+  CustomerAppointmentTriggerSchema,
+  CustomerReplyTriggerSchema,
+  DndContactTriggerSchema,
   FormSubmissionTriggerSchema,
-  OpportunityCreatedTriggerSchema,
-  OpportunityChangedTriggerSchema,
-  OpportunityStatusChangedTriggerSchema,
-  PaymentReceivedTriggerSchema,
-  InboundWebhookTriggerSchema,
+  InvoiceTriggerSchema,
+  IvrIncomingCallTriggerSchema,
+  LessonCompletedTriggerSchema,
+  LessonStartedTriggerSchema,
   MailgunEmailEventTriggerSchema,
+  MembershipContactCreatedTriggerSchema,
   NoteAddTriggerSchema,
+  NoteChangedTriggerSchema,
+  OfferAccessGrantedTriggerSchema,
+  OfferAccessRemovedTriggerSchema,
+  OpportunityChangedTriggerSchema,
+  OpportunityCreatedTriggerSchema,
+  OpportunityDecayTriggerSchema,
+  OpportunityStatusChangedTriggerSchema,
+  PipelineStageUpdatedTriggerSchema,
+  ProductAccessGrantedTriggerSchema,
+  ProductAccessRemovedTriggerSchema,
+  ProductCompletedTriggerSchema,
+  ProductStartedTriggerSchema,
+  ShopifyAbandonedCartTriggerSchema,
+  ShopifyOrderFulfilledTriggerSchema,
+  ShopifyOrderPlacedTriggerSchema,
+  SurveySubmissionTriggerSchema,
   TaskAddedTriggerSchema,
-  // Fallback for the remaining 44 native trigger types + any future ones
+  TaskDueDateReminderTriggerSchema,
+  TikTokFormSubmittedTriggerSchema,
+  TriggerLinkTriggerSchema,
+  TwoStepFormSubmissionTriggerSchema,
+  ValidationErrorTriggerSchema,
+  VideoEventTriggerSchema,
+  CustomDateReminderTriggerSchema,
+  InboundTriggerTriggerSchema,
+  FacebookCommentOnPostTriggerSchema,
+  IgCommentOnPostTriggerSchema,
+  InboundWebhookTriggerSchema,
+  PaymentReceivedTriggerSchema,
+  AffiliateCreatedTriggerSchema,
+  SchedulerTriggerTriggerSchema,
+  UserLogInTriggerSchema,
+  OrderSubmissionTriggerSchema,
+  ConvAiTriggerTriggerSchema,
+  ConvAiAutonomousTriggerTriggerSchema,
+  CustomObjectCreatedTriggerSchema,
+  CustomObjectChangedTriggerSchema,
+  FacebookLeadGenTriggerSchema,
   UnknownTriggerSchema
 ]);
 
@@ -5728,6 +5931,287 @@ ${errors.join("\n")}` : "\nNo errors!",
   );
 }
 
+// src/tools/validators.ts
+var import_zod40 = require("zod");
+function extractFromTrigger(trigger, refs) {
+  const triggerName = String(trigger.name ?? trigger.type ?? "unnamed trigger");
+  const where = `trigger "${triggerName}"`;
+  const conditions = Array.isArray(trigger.conditions) ? trigger.conditions : [];
+  for (let i = 0; i < conditions.length; i++) {
+    const c = conditions[i];
+    const field = typeof c.field === "string" ? c.field : null;
+    const value = c.value;
+    if (!field || value === void 0 || value === null) continue;
+    const valueAsArray = Array.isArray(value) ? value : [value];
+    for (const v of valueAsArray) {
+      if (typeof v !== "string") continue;
+      const childWhere = `${where} \u2192 conditions[${i}] (field=${field})`;
+      switch (field) {
+        case "opportunity.pipelineId":
+          refs.push({ kind: "pipeline", id: v, where: childWhere });
+          break;
+        case "opportunity.pipelineStageId":
+          refs.push({ kind: "stage", id: v, where: childWhere });
+          break;
+        case "opportunity.assignedTo":
+        case "contact.assignedTo":
+          refs.push({ kind: "user", id: v, where: childWhere });
+          break;
+        case "workflow.id":
+          refs.push({ kind: "workflow", id: v, where: childWhere });
+          break;
+      }
+    }
+  }
+  const triggerActions = Array.isArray(trigger.actions) ? trigger.actions : [];
+  for (let i = 0; i < triggerActions.length; i++) {
+    const a = triggerActions[i];
+    if (a.type === "add_to_workflow" && typeof a.workflow_id === "string") {
+      refs.push({
+        kind: "workflow",
+        id: a.workflow_id,
+        where: `${where} \u2192 actions[${i}] (add_to_workflow)`
+      });
+    }
+  }
+}
+function extractFromAction(action, refs) {
+  const type = typeof action.type === "string" ? action.type : "unknown";
+  const name = typeof action.name === "string" ? action.name : "unnamed action";
+  const where = `action "${name}" (${type})`;
+  const attr = action.attributes ?? {};
+  switch (type) {
+    case "update_contact_field": {
+      const fields = Array.isArray(attr.fields) ? attr.fields : [];
+      for (let i = 0; i < fields.length; i++) {
+        const f = fields[i];
+        if (typeof f.field === "string") {
+          refs.push({
+            kind: "custom_field",
+            id: f.field,
+            where: `${where} \u2192 fields[${i}]`
+          });
+        }
+      }
+      break;
+    }
+    case "internal_notification": {
+      const notif = attr.notification ?? {};
+      if (typeof notif.selectedUser === "string" && notif.selectedUser.trim() !== "") {
+        refs.push({
+          kind: "user",
+          id: notif.selectedUser,
+          where: `${where} \u2192 notification.selectedUser`
+        });
+      }
+      break;
+    }
+    case "task_notification": {
+      if (typeof attr.assignedTo === "string" && attr.assignedTo.trim() !== "") {
+        refs.push({
+          kind: "user",
+          id: attr.assignedTo,
+          where: `${where} \u2192 assignedTo`
+        });
+      }
+      break;
+    }
+    case "remove_from_workflow": {
+      if (typeof attr.workflowId === "string") {
+        refs.push({
+          kind: "workflow",
+          id: attr.workflowId,
+          where: `${where} \u2192 workflowId`
+        });
+      }
+      const workflowIdArr = Array.isArray(attr.workflow_id) ? attr.workflow_id : [];
+      for (let i = 0; i < workflowIdArr.length; i++) {
+        const v = workflowIdArr[i];
+        if (typeof v === "string") {
+          refs.push({
+            kind: "workflow",
+            id: v,
+            where: `${where} \u2192 workflow_id[${i}]`
+          });
+        }
+      }
+      break;
+    }
+    case "internal_update_opportunity": {
+      const customInputs = Array.isArray(attr.__customInputFields__) ? attr.__customInputFields__ : [];
+      for (let i = 0; i < customInputs.length; i++) {
+        const c = customInputs[i];
+        if (typeof c.value !== "string") continue;
+        if (c.filterField === "pipelineId") {
+          refs.push({ kind: "pipeline", id: c.value, where: `${where} \u2192 __customInputFields__[${i}].pipelineId` });
+        } else if (c.filterField === "pipelineStageId") {
+          refs.push({ kind: "stage", id: c.value, where: `${where} \u2192 __customInputFields__[${i}].pipelineStageId` });
+        }
+      }
+      break;
+    }
+  }
+}
+function registerValidatorTools(server2, client, builderClient) {
+  if (!builderClient) return;
+  server2.tool(
+    "validate_workflow",
+    "Pre-flight ID validation for a deployed GHL workflow. Scans every trigger and action for references to pipelines, pipeline stages, custom fields, users, and other workflows; verifies each ID exists in the current location. Use this BEFORE publish_workflow when a workflow has been edited, or whenever a published workflow stops behaving as expected. Catches the silent-failure bug where invalid IDs make GHL skip all subsequent actions without warning. Returns a structured report of valid + missing references.",
+    {
+      workflowId: import_zod40.z.string().describe("The workflow ID to validate.")
+    },
+    async ({ workflowId }) => {
+      try {
+        const workflow = await builderClient.getWorkflow(workflowId);
+        if (!workflow) return errorResponse(new Error(`Workflow ${workflowId} not found`));
+        const refs = [];
+        const triggers = Array.isArray(workflow.triggers) ? workflow.triggers : [];
+        for (const t of triggers) {
+          extractFromTrigger(t, refs);
+        }
+        const actions = workflow.workflowData?.templates ?? [];
+        for (const a of actions) {
+          extractFromAction(a, refs);
+        }
+        if (refs.length === 0) {
+          const empty = {
+            workflowId,
+            workflowName: workflow.name,
+            status: "ok",
+            references_scanned: 0,
+            issues_count: 0,
+            findings: []
+          };
+          return jsonResponse(empty);
+        }
+        const refCategories = new Set(refs.map((r) => r.kind));
+        const locationId2 = client.defaultLocationId;
+        const fetches = {};
+        if (refCategories.has("pipeline") || refCategories.has("stage")) {
+          fetches.pipelines = client.get("/opportunities/pipelines", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("custom_field")) {
+          fetches.customFields = client.get(`/locations/${locationId2}/customFields`);
+        }
+        if (refCategories.has("user")) {
+          fetches.users = client.get("/users/", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("workflow")) {
+          fetches.workflows = builderClient.listWorkflowsFull();
+        }
+        const results = await Promise.allSettled(Object.values(fetches));
+        const keys = Object.keys(fetches);
+        const data = {};
+        for (let i = 0; i < keys.length; i++) {
+          const r = results[i];
+          data[keys[i]] = r.status === "fulfilled" ? r.value : null;
+        }
+        const validPipelineIds = /* @__PURE__ */ new Set();
+        const validStageIds = /* @__PURE__ */ new Set();
+        const stageToPipeline = /* @__PURE__ */ new Map();
+        if (data.pipelines) {
+          try {
+            const parsed = PipelinesResponseSchema.parse(data.pipelines);
+            for (const p of parsed.pipelines) {
+              validPipelineIds.add(p.id);
+              for (const s of p.stages) {
+                validStageIds.add(s.id);
+                stageToPipeline.set(s.id, p.id);
+              }
+            }
+          } catch {
+          }
+        }
+        const validCustomFieldIds = /* @__PURE__ */ new Set();
+        if (data.customFields && typeof data.customFields === "object") {
+          const cf = data.customFields;
+          const arr = Array.isArray(cf.customFields) ? cf.customFields : Array.isArray(cf) ? cf : [];
+          for (const f of arr) {
+            if (typeof f === "object" && f !== null && typeof f.id === "string") {
+              validCustomFieldIds.add(f.id);
+            }
+          }
+        }
+        const validUserIds = /* @__PURE__ */ new Set();
+        if (data.users && typeof data.users === "object") {
+          const u = data.users;
+          const arr = Array.isArray(u.users) ? u.users : Array.isArray(u) ? u : [];
+          for (const user of arr) {
+            if (typeof user === "object" && user !== null && typeof user.id === "string") {
+              validUserIds.add(user.id);
+            }
+          }
+        }
+        const validWorkflowIds = /* @__PURE__ */ new Set();
+        if (data.workflows && typeof data.workflows === "object") {
+          const w = data.workflows;
+          const arr = Array.isArray(w.rows) ? w.rows : Array.isArray(w.workflows) ? w.workflows : Array.isArray(w) ? w : [];
+          for (const wf of arr) {
+            if (typeof wf === "object" && wf !== null) {
+              const o = wf;
+              const id = typeof o._id === "string" ? o._id : typeof o.id === "string" ? o.id : null;
+              if (id) validWorkflowIds.add(id);
+            }
+          }
+        }
+        const findings = [];
+        for (const ref of refs) {
+          let valid = false;
+          let extraMsg = "";
+          switch (ref.kind) {
+            case "pipeline":
+              valid = validPipelineIds.has(ref.id);
+              break;
+            case "stage":
+              valid = validStageIds.has(ref.id);
+              break;
+            case "custom_field":
+              valid = validCustomFieldIds.has(ref.id);
+              break;
+            case "user":
+              valid = validUserIds.has(ref.id);
+              break;
+            case "workflow":
+              valid = validWorkflowIds.has(ref.id);
+              if (valid && ref.id === workflowId) {
+                extraMsg = " (self-reference)";
+              }
+              break;
+          }
+          if (!valid) {
+            findings.push({
+              severity: "error",
+              category: ref.kind,
+              id: ref.id,
+              where: ref.where,
+              message: `${ref.kind} id "${ref.id}" does not exist in this location \u2014 GHL will silently skip this action and all subsequent actions when the workflow runs.`
+            });
+          } else if (extraMsg) {
+            findings.push({
+              severity: "warning",
+              category: ref.kind,
+              id: ref.id,
+              where: ref.where,
+              message: `${ref.kind} id "${ref.id}" is valid${extraMsg}.`
+            });
+          }
+        }
+        const report = {
+          workflowId,
+          workflowName: workflow.name,
+          status: findings.some((f) => f.severity === "error") ? "issues_found" : "ok",
+          references_scanned: refs.length,
+          issues_count: findings.filter((f) => f.severity === "error").length,
+          findings
+        };
+        return jsonResponse(report);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+}
+
 // src/tools/index.ts
 var publicApiTools = [
   [registerContactTools, "contacts"],
@@ -5770,6 +6254,7 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
   registerFormBuilderTools(server2, builderClient);
   registerPipelineBuilderTools(server2, builderClient);
   registerWorkflowClonerTools(server2, builderClient);
+  registerValidatorTools(server2, client, builderClient);
   registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion);
 }
 
@@ -5777,18 +6262,18 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var os = __toESM(require("os"));
-var import_zod40 = require("zod");
+var import_zod41 = require("zod");
 var APP_NAME = "elitedcs-ghl-mcp";
-var CredentialsSchema = import_zod40.z.object({
-  license_key: import_zod40.z.string().min(1),
-  email: import_zod40.z.string().email(),
-  verified_at: import_zod40.z.string().min(1),
-  ghl_api_key: import_zod40.z.string().min(1),
-  ghl_location_id: import_zod40.z.string().min(1),
-  ghl_company_id: import_zod40.z.string().optional(),
-  ghl_user_id: import_zod40.z.string().optional(),
-  ghl_firebase_api_key: import_zod40.z.string().optional(),
-  ghl_firebase_refresh_token: import_zod40.z.string().optional()
+var CredentialsSchema = import_zod41.z.object({
+  license_key: import_zod41.z.string().min(1),
+  email: import_zod41.z.string().email(),
+  verified_at: import_zod41.z.string().min(1),
+  ghl_api_key: import_zod41.z.string().min(1),
+  ghl_location_id: import_zod41.z.string().min(1),
+  ghl_company_id: import_zod41.z.string().optional(),
+  ghl_user_id: import_zod41.z.string().optional(),
+  ghl_firebase_api_key: import_zod41.z.string().optional(),
+  ghl_firebase_refresh_token: import_zod41.z.string().optional()
 });
 function appDataDir() {
   const home = os.homedir();
@@ -5838,7 +6323,7 @@ function writeCredentials(creds) {
 // src/setup-tool.ts
 var os2 = __toESM(require("os"));
 var crypto3 = __toESM(require("crypto"));
-var import_zod41 = require("zod");
+var import_zod42 = require("zod");
 var LICENSE_API = "https://elitedcs.com/api/validate-license";
 var GHL_API = "https://services.leadconnectorhq.com";
 var FIREBASE_TOKEN_API = "https://securetoken.googleapis.com/v1/token";
@@ -5909,14 +6394,14 @@ function registerSetupTool(server2) {
     "setup_ghl_mcp",
     "First-run setup for GHL Command MCP. Validates your license and GHL credentials, then writes them to a per-user credentials file. Restart Claude after this completes to load all 171 tools.",
     {
-      email: import_zod41.z.string().email().describe("Email used at purchase."),
-      license_key: import_zod41.z.string().min(20).describe("License key from your purchase email."),
-      ghl_api_key: import_zod41.z.string().min(10).describe("GHL Private Integration key (starts with 'pit-'). Created INSIDE the sub-account at Settings > Integrations > Private Integrations."),
-      ghl_location_id: import_zod41.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
-      ghl_company_id: import_zod41.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
-      ghl_user_id: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
-      ghl_firebase_api_key: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
-      ghl_firebase_refresh_token: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
+      email: import_zod42.z.string().email().describe("Email used at purchase."),
+      license_key: import_zod42.z.string().min(20).describe("License key from your purchase email."),
+      ghl_api_key: import_zod42.z.string().min(10).describe("GHL Private Integration key (starts with 'pit-'). Created INSIDE the sub-account at Settings > Integrations > Private Integrations."),
+      ghl_location_id: import_zod42.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
+      ghl_company_id: import_zod42.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
+      ghl_user_id: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
+      ghl_firebase_api_key: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
+      ghl_firebase_refresh_token: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
     },
     async (args) => {
       const lic = await validateLicense(args.email, args.license_key);