@elitedcs/ghl-mcp 3.5.1 → 3.7.0

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # Changelog
 
+## 3.7.0 — Funnel-builder fixes (Don Harris audit)
+
+**178 tools across 38 modules. Bundle: 288.4 KB.**
+
+Implements all 7 fixes from Don Harris's 2026-05-14 audit. Don captured the correct endpoints via Chrome DevTools against `page-builder.leadconnectorhq.com` and `app.gohighlevel.com`, then verified each fix with curl round-trips against two live sub-accounts. Full credit to Don for the diagnostic work.
+
+### The root cause
+All funnel write tools were hitting endpoints that don't exist on `backend.leadconnectorhq.com/funnels/...`. The real save paths live on the same host but with different verbs, methods, and body shapes. Plus, mutating endpoints require `Origin` + `Referer` headers that `funnelRequest()` wasn't sending, causing 401 `{"message":"Error calling IAM service"}` on every write.
+
+### Header fix (unblocks every funnel write)
+Added `Origin: https://app.gohighlevel.com` and `Referer: https://app.gohighlevel.com/` to `funnelRequest()`. Without these, GHL's IAM rejects writes regardless of bearer token validity.
+
+### Endpoint fixes
+| Tool | Was | Now |
+|---|---|---|
+| `update_page_content` | `PUT /page/{pageId}` | `POST /builder/prebuilt-section/sync/changes` with `{ locationId, pageId, pageData, write: true, isPublished }` |
+| `update_funnel` | `PUT /funnel/{funnelId}` | `POST /funnel/update-settings` with full settings body. Rewritten with fetch-then-merge so you can change one field without blowing away the others. |
+| `create_funnel_page` | `POST /page` | `POST /funnel/create-step` with client-generated step UUID + nested `step` object. Now also returns the generated `stepId` so the caller can use it with `update_funnel_step` / `delete_funnel_page` without a separate lookup. |
+| `delete_funnel_page` | `DELETE /page/{pageId}` | `POST /funnel/delete-step` with `{ funnelId, stepId }`. **SIGNATURE CHANGED**: now takes `funnelId + stepId` instead of `pageId`. |
+| `delete_funnel` | `DELETE /funnel/{id}` | `POST /funnel/delete` with `{ funnelId, locationId, userId }` |
+
+### `update_funnel_step` (NEW)
+Per-step renames, URL slugs, and domain attachments. `PUT /funnel/step/{funnelId}` with `{ stepId, name, url, domainName }`. Use this when you want to rename a single page entry inside a funnel without touching funnel-level settings.
+
+### `WorkflowBuilderClient.getUserId()` (NEW, internal)
+Public getter on the builder client. Required because `delete_funnel` needs `userId` in the request body. Not exposed via MCP.
+
+### Round-trip verified in MCP Testing
+- 6/6 tested funnel writes return success against real GHL backend (the 7th, `update_page_content`, was already verified by Don's 112KB real-page round-trip in his audit email).
+- Created → renamed → added step → renamed step → deleted step → deleted funnel, all in one test pass.
+
+### Honest scoping
+- The 168/178 "without Firebase / with Firebase" split documented in `setup_ghl_mcp` and `enable_workflow_builder` is carried forward from v3.5.1 and hasn't been audited empirically. It's likely off in absolute terms (funnel/form/pipeline builders all gate on Firebase too). TODO to do a real audit.
+- The bonus `update_workflow_actions` / `remove_from_workflow` read/write asymmetry Don flagged at the end of his email is not addressed in this release — separate concern, separate fix when prioritized.
+
+### Files changed
+- `src/tools/funnel-builder.ts` — full rewrite of all 6 broken endpoints + `update_funnel_step` added
+- `src/workflow-builder-client.ts` — `getUserId()` public getter
+- `src/setup-tool.ts` — tool counts refreshed
+
+## 3.6.0 — `build_goal_event` (closes Don-e's last open complaint)
+
+**177 tools across 38 modules. Bundle: 281.9 KB.**
+
+Goal-event support, end-to-end. Don-e flagged on May 4 that the MCP couldn't read or edit goal events. v3.1.0's permissive schema fixed the read side. v3.6.0 fixes the build side.
+
+### `build_goal_event` tool (NEW)
+A high-level helper that emits a correctly-shaped `workflow_goal` node — same pattern as `build_if_else_branch`. Takes a goal condition, optional extras, and an action mode (exit / continue / goto). Returns a single node JSON ready to insert into your actions array.
+
+Example:
+```
+build_goal_event(
+  goal_condition: "review_request_clicked",
+  extras: { reviewTypes: ["sms", "email"], reviewLinkId: "" },
+  action: "exit",
+)
+```
+
+### Goal events explained
+Goal events sit inline in the workflow's action chain — they're NOT branching nodes. The previous action's `next` points to the goal node, and the goal node itself has no `next`. When the goal condition fires during workflow execution (e.g., a contact clicks a review request link), the configured action runs:
+- `exit` — terminates this workflow path (verified)
+- `continue` — passes through to a downstream node (schema accepts but not yet captured from UI)
+- `goto` — jumps to a specific action node (requires `target_node_id`)
+
+### Verified end-to-end
+- Built a goal-event node via `build_goal_event` matching Jerry's UI-built sample. **13 of 13 structural checks passed.**
+- Saved it to a fresh workflow in MCP Testing, read back via `get_workflow_full`. **5 of 5 persistence checks passed** — GHL accepted the shape and round-tripped it cleanly.
+- Test workflow cleaned up via `delete_workflow_full`.
+
+### Schema updates
+- `src/workflow-action-types.ts` — added `WorkflowGoalAttributes` interface + `workflow_goal` variant in the discriminated union (was previously caught by the catch-all fallback)
+- `templates/action-schemas.json` — added a `workflow_goal` entry with the canonical shape, notes, and a pointer to the builder
+- `update_workflow_actions` description updated to mention `workflow_goal` + `build_goal_event`
+
+### Honest scoping
+Only one `goal_condition` value is currently verified end-to-end: `review_request_clicked`. GHL's UI exposes others (tag-based, appointment-based, etc.) — those pass through the builder via the permissive `goal_condition: string` parameter but haven't been captured as specific cases. A future patch can add named helpers / enum values per goal_condition type when more samples are captured.
+
+### Files changed
+- `src/tools/workflow-builder.ts` — `build_goal_event` tool; `update_workflow_actions` description refresh
+- `src/workflow-action-types.ts` — new `WorkflowGoalAttributes` + union variant
+- `templates/action-schemas.json` — `workflow_goal` reference entry
+
 ## 3.5.1 — doc-string accuracy
 
 **176 tools across 38 modules. Bundle: 278.7 KB.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 176 tools across 36 modules — manage contacts, conversations, pipelines, calendars, funnels, workflows, invoices, custom objects, webhooks, and more. **Includes full workflow builder, funnel/page editor, form builder, pipeline builder, bulk operations, account export, and workflow cloning** — capabilities no other GHL tool offers.
+**Full GoHighLevel API access for Claude.** 178 tools across 36 modules — manage contacts, conversations, pipelines, calendars, funnels, workflows, invoices, custom objects, webhooks, and more. **Includes full workflow builder, funnel/page editor, form builder, pipeline builder, bulk operations, account export, and workflow cloning** — capabilities no other GHL tool offers.
 
 **Distributed via npm as [`@elitedcs/ghl-mcp`](https://www.npmjs.com/package/@elitedcs/ghl-mcp).** Buyers install with one config block — no git, no Node.js setup, no terminal commands. Updates flow automatically (`npx @latest` re-resolves on every Claude restart).
 
@@ -98,7 +98,7 @@ Run setup_ghl_mcp to activate GHL Command:
   ghl_location_id: YOUR_LOCATION_ID
 ```
 
-Approve the tool call. Server validates your license, verifies your GHL credentials, writes them to a per-user config file. **Quit Claude one more time and reopen** — all 168 tools are now unlocked.
+Approve the tool call. Server validates your license, verifies your GHL credentials, writes them to a per-user config file. **Quit Claude one more time and reopen** — all 169 tools are now unlocked.
 
 ### 4. Try it
 
@@ -138,7 +138,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-The 8 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 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.
 
 Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
 
@@ -167,9 +167,9 @@ Re-run setup_ghl_mcp with workflow builder:
 
 ---
 
-## Tools (176)
+## Tools (178)
 
-> **v3.5.0 adds `enable_workflow_builder`** — a one-call upgrade path for adding Firebase credentials to an existing install. Buyers who skip Firebase on day one can now add it later without re-entering license / API key / location ID. Reads existing credentials, validates Firebase, merges, writes back.
+> **v3.7.0 fixes Don Harris's 2026-05-14 funnel-builder audit.** All six previously-broken funnel write tools (`update_funnel`, `create_funnel_page`, `delete_funnel_page`, `delete_funnel`, `update_page_content`, plus `create_funnel` which 401'd) now hit the correct GHL endpoints. New: `update_funnel_step` for per-step renames / slugs / domains. Origin + Referer headers added to all funnel writes — required by GHL's IAM, missing before.
 
 ### CRM & Contacts (15 tools)
 
@@ -334,7 +334,7 @@ Re-run setup_ghl_mcp with workflow builder:
 | `get_subscriptions` | List active subscriptions |
 | `get_transactions` | View transaction history |
 
-### Workflow Builder (8 tools) — Internal API
+### Workflow Builder (9 tools) — Internal API
 
 > **This is the flagship feature.** GHL's public API has **zero** workflow write endpoints. These tools use GHL's internal backend API — the same API their own UI calls — reverse-engineered to give Claude full workflow CRUD. No other GHL integration, Zapier connector, or third-party tool can create or edit workflows programmatically. Requires additional Firebase auth setup (see "Enable Workflow Builder" in Quick Start above).
 
@@ -348,10 +348,11 @@ Re-run setup_ghl_mcp with workflow builder:
 | `publish_workflow` | Publish a draft workflow to make it active |
 | `get_trigger_registry` | Discover GHL's marketplace trigger apps (Zoom, WooCommerce, Shopify, etc.) and their available trigger templates |
 | `validate_workflow` | Pre-flight validation: scans every action and trigger for references to pipelines, stages, custom fields, users, and other workflows; verifies each ID exists. Catches the silent-failure bug where invalid IDs make GHL skip subsequent actions |
+| `build_goal_event` | Build a correctly-shaped goal-event node. Goals sit inline in the action chain — when the goal condition fires (e.g., review_request_clicked), the configured action runs (default: exit the workflow). Returns a `workflow_goal` node ready to wire into your actions array |
 
-**What you can build:** Complete automation sequences — lead nurture drip campaigns, appointment reminder sequences, onboarding flows, re-engagement workflows, internal notification chains. Tell Claude what you want and it builds the workflow action by action.
+**What you can build:** Complete automation sequences — lead nurture drip campaigns, appointment reminder sequences, onboarding flows, re-engagement workflows, internal notification chains, **conditional exit workflows with goal events**. Tell Claude what you want and it builds the workflow action by action.
 
-**Supported action types:** `sms`, `email`, `add_contact_tag`, `remove_contact_tag`, `update_contact_field`, `wait`, `if_else`, `webhook`, `create_opportunity`, `custom_code`, `add_notes`, `internal_notification`, `task-notification`, `remove_from_workflow`, and more.
+**Supported action types:** `sms`, `email`, `add_contact_tag`, `remove_contact_tag`, `update_contact_field`, `wait`, `if_else`, `webhook`, `create_opportunity`, `custom_code`, `add_notes`, `internal_notification`, `task_notification`, `remove_from_workflow`, **`workflow_goal`**, and more.
 
 **Supported trigger types:** **All 57 native GHL trigger types are deeply typed** with their own Zod variant. 42 have full field-path documentation (`opportunity_*`, `form_submission`, `contact_changed`, `survey_submission`, `birthday_reminder`, `mailgun_email_event`, and 36 others). 4 have partial docs, 2 are fieldless by design, 9 have type-only discrimination pending field-path capture. A permissive fallback handles any future trigger types GHL ships, so reads never crash. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
 
@@ -419,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 8 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 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. |
 
 ### Other Modules
 
@@ -541,7 +542,7 @@ ghl-command-mcp/
 │       ├── emails.ts              # 1 tool  — email campaign listing
 │       ├── trigger-links.ts       # 1 tool  — trigger link listing
 │       ├── workflow-builder.ts    # 6 tools — full workflow CRUD (internal API)
-│       ├── funnel-builder.ts      # 9 tools — funnel/page builder (internal API)
+│       ├── funnel-builder.ts      # 10 tools — funnel/page builder (internal API)
 │       ├── form-builder.ts        # 5 tools — form builder (internal API)
 │       ├── pipeline-builder.ts    # 5 tools — pipeline/stage builder (internal API)
 │       ├── bulk-operations.ts     # 5 tools — batch contact operations

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.5.1",
-      description: "GoHighLevel MCP Server for Claude. 176 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.7.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: {
         "ghl-mcp": "dist/index.js"
@@ -869,6 +869,14 @@ var WorkflowBuilderClient = class _WorkflowBuilderClient {
   getApiKey() {
     return this.apiKey;
   }
+  /**
+   * Return the current Firebase user ID. Required by the funnel-builder's
+   * delete_funnel endpoint which needs `userId` in the request body. Not
+   * exposed via MCP.
+   */
+  getUserId() {
+    return this.userId;
+  }
   /**
    * Probe Firebase auth by refreshing the ID token. Used by the health_check
    * diagnostic tool. Does not touch GHL backend — just exchanges the refresh
@@ -4137,7 +4145,7 @@ function registerWorkflowBuilderTools(server2, client) {
   );
   server2.tool(
     "update_workflow_actions",
-    "Update a workflow's actions (steps), triggers, name, or status. IMPORTANT: Call get_workflow_full first to see the current state before updating. Handles version tracking automatically. Uses the internal builder API (requires Firebase auth). Action types: sms, email, add_contact_tag, remove_contact_tag, wait, webhook, internal_update_opportunity, custom_code, update_contact_field, add_notes, internal_notification, task_notification, remove_from_workflow, add_to_workflow, goto, transition. For if/else, call build_if_else_branch and include its returned nodes; if_else is a node discriminator, not a standalone action. Trigger types: customer_reply, appointment, contact_tag, and pipeline_stage_updated have typed validation. Any other GHL trigger type (form_submitted, opportunity_created, payment_received, inbound_webhook, etc.) passes through with a permissive schema \u2014 the payload reaches GHL untouched.",
+    "Update a workflow's actions (steps), triggers, name, or status. IMPORTANT: Call get_workflow_full first to see the current state before updating. Handles version tracking automatically. Uses the internal builder API (requires Firebase auth). Action types: sms, email, add_contact_tag, remove_contact_tag, wait, webhook, internal_update_opportunity, custom_code, update_contact_field, add_notes, internal_notification, task_notification, remove_from_workflow, add_to_workflow, goto, transition, workflow_goal. For if/else, call build_if_else_branch and include its returned nodes; if_else is a node discriminator, not a standalone action. For goal events (exit-on-condition nodes), call build_goal_event to get a correctly-shaped workflow_goal node \u2014 wire it in by setting the prior action's `next` to the goal node's id. Trigger types: all 57 native GHL trigger types have typed validation; any unknown trigger type passes through via a permissive fallback so reads never crash.",
     {
       workflowId: import_zod31.z.string().describe("The workflow ID to update."),
       name: import_zod31.z.string().optional().describe("New workflow name."),
@@ -4298,6 +4306,53 @@ 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."),
+      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 }) => {
+      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 = {
+          op,
+          segments: [{
+            op: inner_op,
+            conditions: [{
+              goal_condition,
+              extras: extras ?? {},
+              id: conditionId
+            }]
+          }],
+          type: "workflow_goal",
+          action
+        };
+        if (action === "goto" && target_node_id) {
+          attributes.targetNodeId = target_node_id;
+        }
+        const goalNode = {
+          id: nodeId,
+          name,
+          type: "workflow_goal",
+          attributes
+        };
+        return jsonResponse(goalNode);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
   server2.tool(
     "delete_workflow_full",
     "Permanently delete a workflow. IRREVERSIBLE.",
@@ -4350,6 +4405,8 @@ function registerFunnelBuilderTools(server2, builderClient) {
   }
   async function funnelRequest(method, path6, body) {
     const headers = await client.buildHeaders();
+    headers.Origin = "https://app.gohighlevel.com";
+    headers.Referer = "https://app.gohighlevel.com/";
     const url = `https://backend.leadconnectorhq.com/funnels${path6}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT")) {
@@ -4455,21 +4512,92 @@ ${text2}`);
   );
   server2.tool(
     "update_funnel",
-    "Update a funnel's name, domain, or steps configuration.",
+    "Update a funnel's settings: name, path/slug, tracking codes, GDPR + payment + chat widget flags, etc. This is the 'save settings panel' endpoint \u2014 it sends the entire settings object, so the tool fetches current settings first, merges your overrides on top, then POSTs back. To rename a single step (page) inside a funnel, use update_funnel_step instead.",
     {
       funnelId: import_zod32.z.string().describe("The funnel ID to update."),
-      name: import_zod32.z.string().optional().describe("New funnel name."),
-      steps: import_zod32.z.array(import_zod32.z.record(import_zod32.z.unknown())).optional().describe("Updated steps array with page references.")
+      name: import_zod32.z.string().optional().describe("New funnel display name."),
+      path: import_zod32.z.string().optional().describe("URL slug for the funnel (e.g., '/my-funnel'). Mapped to funnelPath."),
+      bodyTrackingCode: import_zod32.z.string().optional().describe("Custom tracking script injected before </body>."),
+      headTrackingCode: import_zod32.z.string().optional().describe("Custom tracking script injected before </head>."),
+      chatWidgetId: import_zod32.z.string().optional().describe("Chat widget to embed on every page in this funnel."),
+      domainId: import_zod32.z.string().optional().describe("Custom domain ID for the funnel."),
+      faviconUrl: import_zod32.z.string().optional().describe("Favicon URL for funnel pages."),
+      paymentMode: import_zod32.z.boolean().optional().describe("Whether to require a payment mode for the funnel."),
+      requireCreditCard: import_zod32.z.boolean().optional().describe("Whether to require a credit card on opt-in steps."),
+      isGdprCompliant: import_zod32.z.boolean().optional().describe("Toggle GDPR compliance mode."),
+      isOptimisePageLoad: import_zod32.z.boolean().optional().describe("Enable GHL's page-load optimization."),
+      imageOptimization: import_zod32.z.boolean().optional().describe("Enable automatic image optimization."),
+      allowPaymentModeOption: import_zod32.z.boolean().optional().describe("Allow buyers to choose payment mode on checkout."),
+      storeCurrencyFormatting: import_zod32.z.boolean().optional().describe("Use store-wide currency formatting.")
     },
-    async ({ funnelId, name, steps }) => {
+    async (args) => {
       try {
-        const body = { locationId: client.locationId };
-        if (name !== void 0) body.name = name;
-        if (steps !== void 0) body.steps = steps;
-        const result = await funnelRequest("PUT", `/funnel/${funnelId}`, body);
-        return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        const current = await funnelRequest("GET", `/funnel/list?locationId=${client.locationId}&limit=200`);
+        const funnels = Array.isArray(current.funnels) ? current.funnels : [];
+        const found = funnels.find((f) => f._id === args.funnelId || f.id === args.funnelId);
+        if (!found) {
+          throw new Error(`Funnel ${args.funnelId} not found in this location.`);
+        }
+        const overrides = {};
+        if (args.name !== void 0) overrides.funnelName = args.name;
+        if (args.path !== void 0) overrides.funnelPath = args.path;
+        if (args.bodyTrackingCode !== void 0) overrides.bodyTrackingCode = args.bodyTrackingCode;
+        if (args.headTrackingCode !== void 0) overrides.headTrackingCode = args.headTrackingCode;
+        if (args.chatWidgetId !== void 0) overrides.chatWidgetId = args.chatWidgetId;
+        if (args.domainId !== void 0) overrides.domainId = args.domainId;
+        if (args.faviconUrl !== void 0) overrides.faviconUrl = args.faviconUrl;
+        if (args.paymentMode !== void 0) overrides.paymentMode = args.paymentMode;
+        if (args.requireCreditCard !== void 0) overrides.requireCreditCard = args.requireCreditCard;
+        if (args.isGdprCompliant !== void 0) overrides.isGdprCompliant = args.isGdprCompliant;
+        if (args.isOptimisePageLoad !== void 0) overrides.isOptimisePageLoad = args.isOptimisePageLoad;
+        if (args.imageOptimization !== void 0) overrides.imageOptimization = args.imageOptimization;
+        if (args.allowPaymentModeOption !== void 0) overrides.allowPaymentModeOption = args.allowPaymentModeOption;
+        if (args.storeCurrencyFormatting !== void 0) overrides.storeCurrencyFormatting = args.storeCurrencyFormatting;
+        const body = {
+          locationId: client.locationId,
+          funnelId: args.funnelId,
+          funnelName: found.name ?? "",
+          funnelPath: found.url ?? "/",
+          allowPaymentModeOption: found.allowPaymentModeOption ?? true,
+          bodyTrackingCode: found.bodyTrackingCode ?? "",
+          chatWidgetId: found.chatWidgetId ?? "",
+          domainId: found.domainId ?? "",
+          faviconUrl: found.faviconUrl ?? "",
+          headTrackingCode: found.headTrackingCode ?? "",
+          imageOptimization: found.imageOptimization ?? true,
+          isGdprCompliant: found.isGdprCompliant ?? false,
+          isOptimisePageLoad: found.isOptimisePageLoad ?? true,
+          paymentMode: found.paymentMode ?? true,
+          requireCreditCard: found.requireCreditCard ?? true,
+          stopAllSplitTestsAndReset: null,
+          storeCurrencyFormatting: found.storeCurrencyFormatting ?? false,
+          ...overrides
         };
+        const result = await funnelRequest("POST", `/funnel/update-settings`, body);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "update_funnel_step",
+    "Update a single step (page entry) inside a funnel \u2014 display name, URL slug, or attached domain. A step is GHL's container for one or more pages (multiple pages exist when split-testing). Use update_funnel for funnel-level settings instead.",
+    {
+      funnelId: import_zod32.z.string().describe("The funnel ID containing the step."),
+      stepId: import_zod32.z.string().describe("The step ID to update (from get_funnel_pages / list_funnels_full)."),
+      name: import_zod32.z.string().optional().describe("New step display name."),
+      url: import_zod32.z.string().optional().describe("URL slug for the step (e.g., '/thank-you')."),
+      domainName: import_zod32.z.string().optional().describe("Custom domain to attach to this step.")
+    },
+    async ({ funnelId, stepId, name, url, domainName }) => {
+      try {
+        const body = { stepId };
+        if (name !== void 0) body.name = name;
+        if (url !== void 0) body.url = url;
+        if (domainName !== void 0) body.domainName = domainName;
+        const result = await funnelRequest("PUT", `/funnel/step/${funnelId}`, body);
+        return jsonResponse(result);
       } catch (error) {
         return errorResponse(error);
       }
@@ -4477,17 +4605,19 @@ ${text2}`);
   );
   server2.tool(
     "delete_funnel",
-    "Permanently delete a funnel and all its pages. IRREVERSIBLE.",
+    "Permanently delete a funnel and all its steps/pages. IRREVERSIBLE.",
     {
       funnelId: import_zod32.z.string().describe("The funnel ID to delete."),
       confirm: import_zod32.z.literal("DELETE").describe("Must pass 'DELETE' to confirm this destructive action.")
     },
     async ({ funnelId }) => {
       try {
-        const result = await funnelRequest("DELETE", `/funnel/${funnelId}?locationId=${client.locationId}`);
-        return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-        };
+        const result = await funnelRequest("POST", `/funnel/delete`, {
+          funnelId,
+          locationId: client.locationId,
+          userId: client.getUserId()
+        });
+        return jsonResponse(result);
       } catch (error) {
         return errorResponse(error);
       }
@@ -4495,23 +4625,30 @@ ${text2}`);
   );
   server2.tool(
     "create_funnel_page",
-    "Create a new page in a funnel. Returns the page ID which you can then update with content.",
+    "Create a new step (page entry) in a funnel. The client generates a step UUID locally and sends it in the request; GHL auto-creates a blank page inside the step on the server side. The response includes the new step's id and the page's Firestore reference, which you can then update via update_page_content.",
     {
-      funnelId: import_zod32.z.string().describe("The funnel ID to add the page to."),
-      name: import_zod32.z.string().describe("Page name."),
-      url: import_zod32.z.string().optional().describe("URL slug for the page (e.g. '/thank-you').")
+      funnelId: import_zod32.z.string().describe("The funnel ID to add the step to."),
+      name: import_zod32.z.string().describe("Step display name."),
+      url: import_zod32.z.string().optional().describe("URL slug for the step. Defaults to '' (blank) like the GHL UI."),
+      type: import_zod32.z.string().optional().describe("Step type. Defaults to 'optin_funnel_page'.")
     },
-    async ({ funnelId, name, url }) => {
+    async ({ funnelId, name, url, type }) => {
       try {
-        const result = await funnelRequest("POST", `/page?locationId=${client.locationId}`, {
+        const stepId = crypto.randomUUID();
+        const result = await funnelRequest("POST", `/funnel/create-step`, {
           funnelId,
-          name,
-          url: url || `/${name.toLowerCase().replace(/\s+/g, "-")}`,
-          locationId: client.locationId
+          step: {
+            id: stepId,
+            name,
+            url: url ?? "",
+            pages: [],
+            control_traffic: 100,
+            split: false,
+            type: type ?? "optin_funnel_page"
+          }
         });
-        return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-        };
+        const merged = typeof result === "object" && result !== null ? { stepId, ...result } : { stepId, result };
+        return jsonResponse(merged);
       } catch (error) {
         return errorResponse(error);
       }
@@ -4519,20 +4656,22 @@ ${text2}`);
   );
   server2.tool(
     "update_page_content",
-    "Update a page's builder content \u2014 sections, elements, styles, tracking codes, popups. Use get_page_content first to see the current structure, modify it, and pass the updated JSON here.",
+    "Update a page's builder content \u2014 sections, elements, settings, pageStyles, trackingCode, popups, popupsList, fontsForPreview. Use get_page_content first to see the current structure, modify it, then pass the full 8-field envelope here. GHL's UI fires three POSTs to this endpoint per save (one collaborative-edit broadcast + two commits); for MCP use, one POST with write=true is enough.",
     {
       pageId: import_zod32.z.string().describe("The page ID to update."),
-      content: import_zod32.z.record(import_zod32.z.unknown()).describe("The full page content JSON (sections, settings, general, pageStyles, trackingCode, popups, popupsList).")
+      content: import_zod32.z.record(import_zod32.z.unknown()).describe("The full page content JSON. Expected fields: sections, settings, general, pageStyles, trackingCode, popups, popupsList, fontsForPreview."),
+      isPublished: import_zod32.z.boolean().optional().describe("Whether the page should be marked published after the save. Defaults to false (draft).")
     },
-    async ({ pageId, content }) => {
+    async ({ pageId, content, isPublished }) => {
       try {
-        const result = await funnelRequest("PUT", `/page/${pageId}?locationId=${client.locationId}`, {
-          ...content,
-          locationId: client.locationId
+        const result = await funnelRequest("POST", `/builder/prebuilt-section/sync/changes`, {
+          locationId: client.locationId,
+          pageId,
+          pageData: content,
+          write: true,
+          isPublished: isPublished ?? false
         });
-        return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-        };
+        return jsonResponse(result);
       } catch (error) {
         return errorResponse(error);
       }
@@ -4540,17 +4679,16 @@ ${text2}`);
   );
   server2.tool(
     "delete_funnel_page",
-    "Permanently delete a page from a funnel. IRREVERSIBLE.",
+    "Permanently delete a step (and all its pages) from a funnel. IRREVERSIBLE. SIGNATURE CHANGED in v3.7.0: was pageId, now requires funnelId + stepId to match GHL's actual delete-step endpoint.",
     {
-      pageId: import_zod32.z.string().describe("The page ID to delete."),
+      funnelId: import_zod32.z.string().describe("The funnel ID containing the step."),
+      stepId: import_zod32.z.string().describe("The step ID to delete (from get_funnel_pages / list_funnels_full)."),
       confirm: import_zod32.z.literal("DELETE").describe("Must pass 'DELETE' to confirm this destructive action.")
     },
-    async ({ pageId }) => {
+    async ({ funnelId, stepId }) => {
       try {
-        const result = await funnelRequest("DELETE", `/page/${pageId}?locationId=${client.locationId}`);
-        return {
-          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-        };
+        const result = await funnelRequest("POST", `/funnel/delete-step`, { funnelId, stepId });
+        return jsonResponse(result);
       } catch (error) {
         return errorResponse(error);
       }
@@ -6586,7 +6724,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 176 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 (168 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."),
@@ -6641,7 +6779,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 ? "176" : "168";
+      const toolCount = workflowBuilderEnabled ? "178" : "168";
       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 {
@@ -6669,7 +6807,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 8 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 176 after the next Claude restart.",
+    "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.",
     {
       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."),
@@ -6716,7 +6854,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "Firebase credentials verified and saved.",
             "",
-            "**Restart Claude (quit fully and reopen) to load the 8 additional workflow builder tools (176 total).**",
+            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (178 total).**",
             "",
             'After restart, try: "List my workflows in full detail" or "Validate workflow <id>".',
             "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.5.1",
-  "description": "GoHighLevel MCP Server for Claude. 176 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+  "version": "3.7.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": {
     "ghl-mcp": "dist/index.js"

package/templates/action-schemas.json

@@ -247,6 +247,33 @@
     "branch_notes": "Branch nodes need BOTH parentKey AND parent (same value). Sibling arrays cross-reference the other branch. Condition node next points to [YES, NO]. Branch node next is a string to the first child when non-empty. CAUTION: Complex branching (>2 if/else in one workflow) can freeze GHL's UI renderer. Use separate exit workflows for nurture sequences instead."
   },
 
+  "workflow_goal": {
+    "example": {
+      "id": "<UUID>",
+      "name": "Goal",
+      "type": "workflow_goal",
+      "attributes": {
+        "op": "or",
+        "segments": [
+          {
+            "op": "or",
+            "conditions": [
+              {
+                "goal_condition": "review_request_clicked",
+                "extras": { "reviewTypes": ["sms", "email"], "reviewLinkId": "" },
+                "id": "<UUID>"
+              }
+            ]
+          }
+        ],
+        "type": "workflow_goal",
+        "action": "exit"
+      }
+    },
+    "notes": "Goal-event nodes sit inline in the action chain — when the goal condition fires during workflow execution, the configured action runs (default: 'exit' terminates the workflow path). The previous action's `next` should point to the goal node's id; the goal node itself does NOT have a `next` field. Use build_goal_event to construct the node — it handles UUID generation and the nested op/segments/conditions shape. Verified goal_condition value: 'review_request_clicked' (with extras { reviewTypes: ['sms', 'email'], reviewLinkId: '' }). Other goal_condition strings from GHL's UI pass through verbatim; the full catalogue of goal conditions has not been captured yet.",
+    "build_helper": "build_goal_event(goal_condition, extras?, action='exit', target_node_id?, name='Goal', op='or', inner_op='or')"
+  },
+
   "_trigger_patterns": {
     "real_shape": {
       "id": "<UUID>",