@elitedcs/ghl-mcp 3.7.0 → 3.8.0

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## 3.8.0 — Bundle re-extraction wins (triggers + goal events) + correctness fixes
+
+**178 tools across 38 modules. Bundle: 291.3 KB.**
+
+Three improvements that all flow from one bundle dive into `client-app-automation-workflows.leadconnectorhq.com`:
+
+### Goal-event catalogue — all 10 conditions documented (was 1)
+v3.6.0 shipped `build_goal_event` with one verified `goal_condition` (`review_request_clicked`) and a permissive string for everything else. The bundle's `GoalCondition` enum reveals the full set:
+
+- `email_event` — extras: `{ stepIds: [] }`
+- `link_click` — extras: `{ linkIds: [] }`
+- `add_contact_tag` — extras: `{ tags: [] }` (inferred)
+- `remove_contact_tag` — extras: `{ tags: [] }` (inferred)
+- `appointment_status` — extras: `{ calendarId }`
+- `payment_received` — extras: `{ globalProductIds: [] }`
+- `form_submission` — extras: `{ formIds: [] }`
+- `document_status` — extras: `{ templateId }`
+- `invoice_paid` — extras: `{ invoiceStepId }`
+- `review_request_clicked` — extras: `{ reviewTypes, reviewLinkId }`
+
+`build_goal_event`'s `goal_condition` is now a `z.enum` of these 10 values (was permissive `z.string()`). The per-condition extras shapes are documented in the tool description.
+
+### Goal-event action enum fixed
+v3.6.0's tool advertised `action: "exit" | "continue" | "goto"`. The actual `GoalAction` enum in the bundle is `continue | wait | exit` — **no `goto`**. Fixed. Also removed the `target_node_id` parameter that paired with the bogus goto. `WorkflowGoalAttributes` type updated to match.
+
+### 7 of 9 previously-uncaptured triggers now documented
+Trigger field paths extracted from per-trigger validator functions in the bundle:
+
+- `affiliate_created` → `affiliate.id, contact.tags`
+- `scheduler_trigger` → `scheduler.interval, scheduler.cron, scheduler.frequency`
+- `user_log_in` → `product.id, category.id, lesson.id, offer.id, contact.tags` (shares membership-course validator)
+- `order_submission` → `order.funnel_id, order.line_item_global_product_ids, order.line_item_funnel_product_ids, payment.calendar.id, payment.global_product_ids, payment.form.id`
+- `facebook_lead_gen` → `facebook.formId, facebook.pageId, contact.tags`
+
+Plus 2 more handled explicitly:
+- `conv_ai_trigger`, `conv_ai_autonomous_trigger` — confirmed fieldless (no specific validator in the bundle)
+- `custom_object_created`, `custom_object_changed` — fields are user-defined per object using the `customObject.<field>` prefix; schema now documents this dynamic shape
+
+Coverage: **57/57 native triggers, 0 type-only-pending** (was 9 type-only-pending).
+
+### Bug fix: `remove_from_workflow` read/write asymmetry
+Don Harris flagged at the end of his 2026-05-14 funnel audit that some GHL workflows return only the `workflow_id` array on read, while writes require both that AND the `workflowId` string. Couldn't reproduce in MCP Testing — both reads I checked returned both fields — but added defensive symmetric normalization to both paths in `workflow-builder-client.ts`. If only one form is present in either direction, the other is synthesized. No-op when both are already present.
+
+### Bug fix: accurate "without Firebase" tool count
+Empirical audit: basic-creds mode (no Firebase) actually exposes **148 tools**, not 168 as the v3.5.1 messaging claimed. Firebase adds **30 tools** across 6 modules (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, validate_workflow). `setup_ghl_mcp`, `enable_workflow_builder`, README, and CLAUDE.md all corrected.
+
+### Bundle re-extraction methodology (for future audits)
+1. Fetch `https://client-app-automation-workflows.leadconnectorhq.com/` → find current `index-*.js` bundle URL
+2. Pull the bundle (~9.5 MB minified)
+3. Search for `var GoalCondition=(...)` and `var GoalAction=(...)` for enum extraction
+4. Search for `<triggerName>Validator=n=>` patterns for per-trigger field paths
+5. Watch for i18n translation pollution — filter out windows containing non-ASCII Danish/German/Swedish characters
+
+### Files changed
+- `src/trigger-schemas.ts` — 7 uncaptured triggers now documented; 2 confirmed fieldless; 2 use dynamic `customObject.*` schema
+- `src/tools/workflow-builder.ts` — `build_goal_event` enum tightened; goto removed; description lists all 10 goal_condition values + extras shapes
+- `src/workflow-action-types.ts` — `WorkflowGoalAttributes.action` corrected to `continue | wait | exit`
+- `src/workflow-builder-client.ts` — `normalizeRemoveFromWorkflowAction()` helper applied symmetrically on read + write
+- `src/setup-tool.ts` — 168 → 148; "9 workflow builder tools" → "30 tools across 6 modules"
+- `README.md`, `CLAUDE.md` — synced
+
 ## 3.7.0 — Funnel-builder fixes (Don Harris audit)
 
 **178 tools across 38 modules. Bundle: 288.4 KB.**

package/README.md

@@ -138,7 +138,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-The 9 workflow builder tools use GHL'''s internal API and require Firebase credentials. Without them, the other 168 tools work fine — you just won'''t have workflow editing.
+The 30 builder + cloner + validator tools (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, validate_workflow) use GHL'''s internal API and require Firebase credentials. Without them, the other 148 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
 
 Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
 
@@ -420,7 +420,7 @@ Re-run setup_ghl_mcp with workflow builder:
 |---|---|
 | `get_mcp_version` | Check installed version against the latest published to npm. Confirms an upgrade landed after restarting Claude. Available even before GHL credentials are configured. |
 | `health_check` | Run a full health check: npm registry + version status, GHL API key validity, default location reachability, Firebase auth status, token registry presence. Use when something feels broken. |
-| `enable_workflow_builder` | Add Firebase credentials to an existing install to unlock the 9 workflow builder tools. No need to re-enter license / API key / location ID. Run this any time after the basic setup, on the buyer's schedule. |
+| `enable_workflow_builder` | Add Firebase credentials to an existing install to unlock 30 additional tools across 6 modules (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, validate_workflow). No need to re-enter license / API key / location ID. Run this any time after the basic setup, on the buyer's schedule. |
 
 ### Other Modules
 

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.7.0",
+      version: "3.8.0",
       description: "GoHighLevel MCP Server for Claude. 178 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
@@ -651,15 +651,60 @@ var FacebookCommentOnPostTriggerSchema = typedTrigger("facebook_comment_on_post"
 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 AffiliateCreatedTriggerSchema = typedTrigger("affiliate_created", [
+  "affiliate.id",
+  "contact.tags"
+]);
+var SchedulerTriggerTriggerSchema = typedTrigger("scheduler_trigger", [
+  "scheduler.interval",
+  "scheduler.cron",
+  "scheduler.frequency"
+]);
+var UserLogInTriggerSchema = typedTrigger("user_log_in", [
+  // Shares membershipCourseValidator with course/lesson/category triggers.
+  "product.id",
+  "category.id",
+  "lesson.id",
+  "offer.id",
+  "contact.tags"
+]);
+var OrderSubmissionTriggerSchema = typedTrigger("order_submission", [
+  "order.funnel_id",
+  "order.line_item_global_product_ids",
+  "order.line_item_funnel_product_ids",
+  "payment.calendar.id",
+  "payment.global_product_ids",
+  "payment.form.id"
+]);
+var FacebookLeadGenTriggerSchema = typedTrigger("facebook_lead_gen", [
+  "facebook.formId",
+  "facebook.pageId",
+  "contact.tags"
+]);
+var CustomObjectCreatedTriggerSchema = TriggerCommonSchema.extend({
+  type: import_zod2.z.literal("custom_object_created"),
+  conditions: import_zod2.z.array(import_zod2.z.object({
+    operator: import_zod2.z.string(),
+    field: import_zod2.z.string().describe("Custom-object field paths use the `customObject.<your_field_name>` prefix. Field names are user-defined per custom object \u2014 query the location's custom objects to discover valid field paths."),
+    value: import_zod2.z.unknown().optional(),
+    title: import_zod2.z.string().optional(),
+    type: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional()
+  }).passthrough()).optional()
+});
+var CustomObjectChangedTriggerSchema = TriggerCommonSchema.extend({
+  type: import_zod2.z.literal("custom_object_changed"),
+  conditions: import_zod2.z.array(import_zod2.z.object({
+    operator: import_zod2.z.string(),
+    field: import_zod2.z.string().describe("Custom-object field paths use the `customObject.<your_field_name>` prefix. Field names are user-defined per custom object \u2014 query the location's custom objects to discover valid field paths."),
+    value: import_zod2.z.unknown().optional(),
+    title: import_zod2.z.string().optional(),
+    type: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional()
+  }).passthrough()).optional()
+});
+var ConvAiTriggerTriggerSchema = typedTrigger("conv_ai_trigger", [], "fieldless");
+var ConvAiAutonomousTriggerTriggerSchema = typedTrigger("conv_ai_autonomous_trigger", [], "fieldless");
 var UnknownTriggerSchema = TriggerCommonSchema.extend({
   type: import_zod2.z.string(),
   conditions: import_zod2.z.array(import_zod2.z.record(import_zod2.z.unknown())).optional()
@@ -770,6 +815,23 @@ var CreateWorkflowResponseSchema = import_zod3.z.union([
     version: typeof data.version === "number" ? data.version : 1
   });
 });
+function normalizeRemoveFromWorkflowAction(action) {
+  if (action.type !== "remove_from_workflow") return action;
+  const attrs = action.attributes;
+  if (!attrs || typeof attrs !== "object") return action;
+  const a = attrs;
+  const hasArr = Array.isArray(a.workflow_id) && a.workflow_id.length > 0;
+  const hasStr = typeof a.workflowId === "string" && a.workflowId.length > 0;
+  if (hasArr && hasStr) return action;
+  if (!hasArr && !hasStr) return action;
+  const next = { ...a };
+  if (hasArr && !hasStr) {
+    next.workflowId = a.workflow_id[0];
+  } else if (hasStr && !hasArr) {
+    next.workflow_id = [a.workflowId];
+  }
+  return { ...action, attributes: next };
+}
 function hasId(action) {
   return typeof action.id === "string" && action.id.length > 0;
 }
@@ -1074,7 +1136,11 @@ ${errorBody}`
       workflowData: isRecord(raw.workflowData.workflowData) ? raw.workflowData.workflowData : { templates: [] },
       triggers: raw.triggers
     } : raw;
-    return WorkflowFullSchema.parse(flat);
+    const parsed = WorkflowFullSchema.parse(flat);
+    if (parsed.workflowData?.templates) {
+      parsed.workflowData.templates = parsed.workflowData.templates.map(normalizeRemoveFromWorkflowAction);
+    }
+    return parsed;
   }
   /**
    * Create a new empty workflow
@@ -1235,7 +1301,7 @@ ${errorBody}`
    */
   buildActionChain(actions) {
     validateActionChain(actions);
-    const linked = actions.map((action, i) => {
+    const linked = actions.map(normalizeRemoveFromWorkflowAction).map((action, i) => {
       const copy = { ...action };
       if (!copy.id) {
         copy.id = crypto.randomUUID();
@@ -4308,21 +4374,28 @@ function registerWorkflowBuilderTools(server2, client) {
   );
   server2.tool(
     "build_goal_event",
-    "Build a correctly-shaped GHL workflow goal-event node. Goal events sit inline in the action chain \u2014 when the goal condition fires during workflow execution, the configured action runs (default: exit the workflow). The previous action's `next` should point to the goal node's id; the goal node itself does not have a `next`. Verified goal_condition value (Jerry's UI sample): 'review_request_clicked' with extras { reviewTypes: ['sms', 'email'], reviewLinkId: '' }. Other goal_condition values that GHL ships are passed through verbatim \u2014 the catalogue of all goal conditions has not been fully captured yet, but the schema accepts any string value.",
-    {
-      goal_condition: import_zod31.z.string().describe("The goal-condition identifier \u2014 what the goal is watching for. Verified value: 'review_request_clicked'. Other goal_condition strings that GHL's UI exposes (e.g., tag-related, appointment-related) pass through unchanged."),
-      extras: import_zod31.z.record(import_zod31.z.unknown()).optional().describe("Goal-condition-specific config. Example for review_request_clicked: { reviewTypes: ['sms', 'email'], reviewLinkId: '' }. Pass an empty object {} or omit if the goal_condition has no extras."),
-      action: import_zod31.z.enum(["exit", "continue", "goto"]).default("exit").describe("What happens when the goal fires. 'exit' terminates the workflow path (verified). 'continue' and 'goto' are GHL UI options; 'goto' likely needs an extra targetNodeId field, not yet captured."),
-      target_node_id: import_zod31.z.string().optional().describe("Required when action === 'goto'. The action node id to jump to."),
+    "Build a correctly-shaped GHL workflow goal-event node. Goal events sit inline in the action chain \u2014 when the goal condition fires during workflow execution, the configured action runs (default: exit the workflow). The previous action's `next` should point to the goal node's id; the goal node itself does not have a `next`. All 10 goal_condition values are catalogued (from GHL's workflow-builder JS bundle, extracted 2026-05-18): email_event, link_click, add_contact_tag, remove_contact_tag, appointment_status, payment_received, form_submission, document_status, invoice_paid, review_request_clicked. Each one has a different `extras` shape (see the `goal_condition` field's description for details).",
+    {
+      goal_condition: import_zod31.z.enum([
+        "email_event",
+        "link_click",
+        "add_contact_tag",
+        "remove_contact_tag",
+        "appointment_status",
+        "payment_received",
+        "form_submission",
+        "document_status",
+        "invoice_paid",
+        "review_request_clicked"
+      ]).describe("The goal-condition identifier. Extras shape per condition: email_event \u2192 {stepIds:[]}; link_click \u2192 {linkIds:[]}; appointment_status \u2192 {calendarId}; payment_received \u2192 {globalProductIds:[]}; form_submission \u2192 {formIds:[]}; document_status \u2192 {templateId}; invoice_paid \u2192 {invoiceStepId}; review_request_clicked \u2192 {reviewTypes:['sms'|'email'], reviewLinkId}; add_contact_tag/remove_contact_tag \u2192 {tags:[]} (uncaptured but inferred)."),
+      extras: import_zod31.z.record(import_zod31.z.unknown()).optional().describe("Goal-condition-specific config. See goal_condition description for the expected shape per value. Pass {} or omit for goal_conditions without extras."),
+      action: import_zod31.z.enum(["exit", "continue", "wait"]).default("exit").describe("What happens when the goal fires (per GHL's GoalAction enum). 'exit' terminates the workflow path (verified). 'continue' lets it proceed to a downstream node. 'wait' pauses on the goal."),
       name: import_zod31.z.string().default("Goal").describe("Display name in the GHL UI."),
       op: import_zod31.z.enum(["or", "and"]).default("or").describe("Top-level boolean operator across segments. Default 'or'."),
       inner_op: import_zod31.z.enum(["or", "and"]).default("or").describe("Boolean operator across conditions within a single segment. Default 'or'.")
     },
-    async ({ goal_condition, extras, action, target_node_id, name, op, inner_op }) => {
+    async ({ goal_condition, extras, action, name, op, inner_op }) => {
       try {
-        if (action === "goto" && !target_node_id) {
-          throw new Error("action='goto' requires target_node_id to identify which workflow action to jump to.");
-        }
         const nodeId = crypto.randomUUID();
         const conditionId = crypto.randomUUID();
         const attributes = {
@@ -4338,9 +4411,6 @@ function registerWorkflowBuilderTools(server2, client) {
           type: "workflow_goal",
           action
         };
-        if (action === "goto" && target_node_id) {
-          attributes.targetNodeId = target_node_id;
-        }
         const goalNode = {
           id: nodeId,
           name,
@@ -6724,7 +6794,7 @@ async function validateFirebase(firebaseKey, refreshToken) {
 function registerSetupTool(server2) {
   server2.tool(
     "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 178 tools (168 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
+    "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 178 tools (148 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
       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."),
@@ -6779,7 +6849,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
         ghl_firebase_api_key: workflowBuilderEnabled ? args.ghl_firebase_api_key?.trim() : void 0,
         ghl_firebase_refresh_token: workflowBuilderEnabled ? args.ghl_firebase_refresh_token?.trim() : void 0
       });
-      const toolCount = workflowBuilderEnabled ? "178" : "168";
+      const toolCount = workflowBuilderEnabled ? "178" : "148";
       const wfLine = workflowBuilderEnabled ? "Workflow Builder: enabled." : "Workflow Builder: not configured (optional).";
       const wfTip = workflowBuilderEnabled ? "" : "\nTo enable Workflow Builder later (8 extra tools): run enable_workflow_builder with your three Firebase values. No need to re-enter license/API key/location ID.";
       return {
@@ -6807,7 +6877,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
 function registerEnableWorkflowBuilderTool(server2) {
   server2.tool(
     "enable_workflow_builder",
-    "Add Firebase credentials to an existing GHL Command install to unlock the 9 workflow builder tools (create/edit/clone/delete/publish workflows, validate_workflow, get_trigger_registry). Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 168 to 178 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 30 additional tools across 6 modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder (10 tools), form builder (5 tools), pipeline builder (5 tools), and workflow cloning. Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 148 to 178 after the next Claude restart.",
     {
       ghl_user_id: import_zod42.z.string().min(10).describe("Firebase User ID (uid). DevTools \u2192 Application \u2192 IndexedDB \u2192 firebaseLocalStorageDb \u2192 firebaseLocalStorage \u2192 the value.uid field of the firebase:authUser row."),
       ghl_firebase_api_key: import_zod42.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "description": "GoHighLevel MCP Server for Claude. 178 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
   "main": "dist/index.js",
   "bin": {