@elitedcs/ghl-mcp 3.10.0 → 3.11.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## 3.11.0 — Smart Lists CRUD (gap-closure round 3)
+
+**196 tools across 40 modules. Bundle: 315.1 KB.**
+
+Closes the Smart Lists gap with full CRUD. Smart Lists are saved searches over contacts or opportunities — agencies use them heavily for segmentation, campaign targeting, and workflow trigger filters.
+
+### 5 new tools (Firebase-gated)
+
+- **`list_smart_lists`** — paginated by `objectKey` (`contacts` or `opportunity`). Supports free-text name search.
+- **`get_smart_list`** — single list with full filter spec, columns, permissions.
+- **`create_smart_list`** — required: name + objectKey. Optional: filters, columns, pipelineIds, defaultInPipelines.
+- **`update_smart_list`** — partial updates work. objectKey can't be changed after creation.
+- **`delete_smart_list`** — confirm-gated.
+
+### Discovery story
+
+The workflow-builder bundle declares `smartListBackendURL` as config but doesn't actually use it. Real path was in the same bundle under `SmartListService extends BaseService`:
+
+```js
+new SmartListService(`${config.marketPlaceBackendURL}/lists/dynamic/`, ...)
+```
+
+That resolves to `backend.leadconnectorhq.com/lists/dynamic/{locationId}` — verified all 5 CRUD endpoints (list / get / create / update / delete) end-to-end.
+
+### Why Firebase-gated, not public
+
+Tried bearer-token auth on the same endpoints — returns 400 `"Cannot list smartlists"`. Smart Lists require the internal-API auth path (Firebase ID token via the `token-id` header), same gate as workflow-builder, funnel-builder, form-builder, and pipeline-builder.
+
+### Tool count impact
+
+- Total: 191 → 196 (+5)
+- With Firebase: 191 → 196 (+5 unlocked when enable_workflow_builder runs)
+- Without Firebase: 161 (unchanged — these are internal-API tools)
+- Modules: 39 → 40 (new smart-lists module)
+
+### Verified end-to-end against MCP Testing
+
+Round-trip on `objectKey: "contacts"`: create → get → list (search) → update (rename) → delete. 5/5 success, no probe pollution left in the sub-account.
+
+### Files changed
+
+- `src/tools/smart-lists.ts` — NEW
+- `src/tools/index.ts` — registered `registerSmartListTools` alongside other internal-API builders
+- `src/setup-tool.ts` — bumped Firebase-mode tool count (191 → 196)
+
+## 3.10.1 — `list_message_templates` (SMS / email-snippet / WhatsApp read)
+
+**191 tools across 39 modules. Bundle: ~304.7 KB.**
+
+Small patch closing the SMS template read gap.
+
+### New tool
+
+- `list_message_templates(type?, limit?, skip?, locationId?)` — list snippet-style message templates. `type` filters by `sms` / `email` / `whatsapp`; omit to list all types.
+
+### What this is (and isn't)
+
+GHL has **two separate template systems**:
+1. **Email builders** (drag-and-drop) at `/emails/builder` — already covered by `list_email_templates` + `create_email_template` + `update_email_template` from v3.10.0
+2. **Snippet templates** (simpler, multi-type) at `/locations/{locationId}/templates` — covered by this new tool
+
+This patch closes the **read** side of system #2. The write side is a real wall: `POST /locations/{locationId}/templates` returns 401 *"The token is not authorized for this scope"* with a Private Integration token, regardless of body shape. GHL gates template creation behind a scope (`templates.write` or similar) that PITs don't have. Creating message templates either happens in the GHL UI or requires an OAuth integration. Honest scope documented in the tool description.
+
+### Endpoint discovery story
+
+Found in the workflow-builder JS bundle (`templateEndpoint = /locations/${locationId}/templates`). Endpoint accepts `type=sms|email|whatsapp` to filter; without `type` returns all template kinds. Same endpoint serves single-template GET at `/locations/{locationId}/templates/{id}` (`get_message_template_by_id` could be added if a use case emerges; for now, the list returns enough detail).
+
+### Tool count impact
+
+- Total: 190 → 191 (+1)
+- Without Firebase: 160 → 161 (public API)
+
+### Files changed
+
+- `src/tools/emails.ts` — added `list_message_templates`
+
 ## 3.10.0 — Email Templates (gap-closure round 2)
 
 **190 tools across 39 modules. Bundle: 304.6 KB.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 190 tools across 39 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.** 196 tools across 40 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).
 
@@ -138,7 +138,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-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 160 tools work fine — you just won'''t have workflow/funnel/form/pipeline 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 161 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:
 

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.10.0",
-      description: "GoHighLevel MCP Server for Claude. 190 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.11.0",
+      description: "GoHighLevel MCP Server for Claude. 196 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -3624,6 +3624,25 @@ function registerEmailTools(server2, client) {
       });
     }
   );
+  safeTool(
+    server2,
+    "list_message_templates",
+    "List snippet-style message templates in a location. Covers SMS, email snippets, and WhatsApp templates \u2014 pass the `type` param to filter. Different from `list_email_templates` (which returns drag-and-drop email-builder templates from a separate system). NOTE: This tool is READ-ONLY by design. Creating/updating/deleting templates at this endpoint requires a scope (`templates.write`) that GHL doesn't grant to Private Integration tokens. Buyers create message templates via the GHL UI (Conversations \u2192 Templates) or via an OAuth integration. This list endpoint works on a standard sub-account Private Integration key.",
+    {
+      type: import_zod24.z.enum(["sms", "email", "whatsapp"]).optional().describe("Filter by template type. Omit to list all template types in one response. SMS templates are quick-reply text snippets used in the conversations composer. Email here means HTML-snippet templates (NOT email-builder drag-and-drop templates \u2014 those are listed via `list_email_templates`). WhatsApp templates are pre-approved message templates registered with Meta."),
+      limit: import_zod24.z.number().optional().describe("Max templates to return. Defaults to 1000."),
+      skip: import_zod24.z.number().optional().describe("Skip this many for pagination."),
+      locationId: import_zod24.z.string().optional().describe("Location ID. Falls back to GHL_LOCATION_ID env var.")
+    },
+    async ({ type, limit, skip, locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      const params = {};
+      if (type) params.type = type;
+      if (limit !== void 0) params.limit = limit;
+      if (skip !== void 0) params.skip = skip;
+      return client.get(`/locations/${resolvedLocationId}/templates`, { params });
+    }
+  );
   safeTool(
     server2,
     "update_email_template",
@@ -5991,42 +6010,185 @@ function registerWorkflowClonerTools(server2, builderClient) {
   );
 }
 
-// src/tools/template-deployer.ts
+// src/tools/smart-lists.ts
 var import_zod40 = require("zod");
+var SMARTLIST_BASE = "https://backend.leadconnectorhq.com/lists/dynamic";
+var OBJECT_KEYS = ["contacts", "opportunity"];
+function registerSmartListTools(server2, builderClient) {
+  const client = builderClient;
+  if (!client) return;
+  async function smartListRequest(method, path6, body) {
+    const headers = await client.buildHeaders();
+    const url = `${SMARTLIST_BASE}${path6}`;
+    const options = { method, headers };
+    if (body && (method === "POST" || method === "PUT")) {
+      options.body = JSON.stringify(body);
+    }
+    const response = await fetch(url, options);
+    if (!response.ok) {
+      const text2 = await response.text();
+      throw new Error(`Smart Lists API Error ${response.status}: ${method} ${path6}
+${text2}`);
+    }
+    const text = await response.text();
+    if (!text) return {};
+    return JSON.parse(text);
+  }
+  server2.tool(
+    "list_smart_lists",
+    "List smart lists (dynamic / saved-filter lists) in a location. Smart Lists are saved searches over contacts or opportunities \u2014 agencies use them to segment by complex criteria. Filters and columns aren't returned in the list view; use get_smart_list for the full filter spec.",
+    {
+      objectKey: import_zod40.z.enum(OBJECT_KEYS).describe("The object type the lists segment over. 'contacts' for contact-segments, 'opportunity' for opportunity-segments. Required \u2014 GHL rejects requests without it."),
+      query: import_zod40.z.string().optional().describe("Free-text search across smart list names."),
+      limit: import_zod40.z.number().optional().describe("Max smart lists per page. Defaults to 20 on GHL's side."),
+      startAfter: import_zod40.z.string().optional().describe("Cursor for pagination \u2014 pass the last list's id from the previous page."),
+      locationId: import_zod40.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ objectKey, query, limit, startAfter, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const params = new URLSearchParams({ objectKey });
+        if (query) params.set("query", query);
+        if (limit !== void 0) params.set("limit", String(limit));
+        if (startAfter) params.set("startAfter", startAfter);
+        const result = await smartListRequest("GET", `/${loc}?${params.toString()}`);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "get_smart_list",
+    "Get a single smart list by ID with its full configuration: filters, columns, permissions, and metadata. The filters array is what defines who/what is in the list.",
+    {
+      listId: import_zod40.z.string().describe("The smart list ID (from list_smart_lists or a previous create_smart_list response)."),
+      locationId: import_zod40.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ listId, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await smartListRequest("GET", `/${loc}/${listId}`);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "create_smart_list",
+    "Create a new smart list (dynamic filter list). Required: name + objectKey. Filters define the saved-search criteria \u2014 pass an empty array to create an empty list and add filters later via update_smart_list. The shape of filters/columns is opaque here; query an existing smart list with get_smart_list to see the format GHL expects.",
+    {
+      name: import_zod40.z.string().describe("Display name for the smart list."),
+      objectKey: import_zod40.z.enum(OBJECT_KEYS).describe("Object type the list segments over. 'contacts' or 'opportunity'."),
+      filters: import_zod40.z.array(import_zod40.z.record(import_zod40.z.unknown())).optional().describe("Array of filter objects. Each object has fields like {field, operator, value} \u2014 exact shape varies by filter type. See get_smart_list on an existing list to learn the format."),
+      columns: import_zod40.z.array(import_zod40.z.record(import_zod40.z.unknown())).optional().describe("Array of column definitions for the smart list view in GHL UI. Each defines which contact/opportunity field shows as a column. Defaults to GHL's standard columns if omitted."),
+      pipelineIds: import_zod40.z.array(import_zod40.z.string()).optional().describe("(opportunity objectKey only) Pipeline IDs to restrict this smart list to. Empty array = all pipelines."),
+      defaultInPipelines: import_zod40.z.array(import_zod40.z.string()).optional().describe("(opportunity objectKey only) Pipeline IDs where this list is the default view."),
+      locationId: import_zod40.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ name, objectKey, filters, columns, pipelineIds, defaultInPipelines, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const body = { name, objectKey };
+        if (filters !== void 0) body.filters = filters;
+        if (columns !== void 0) body.columns = columns;
+        if (pipelineIds !== void 0) body.pipelineIds = pipelineIds;
+        if (defaultInPipelines !== void 0) body.defaultInPipelines = defaultInPipelines;
+        const result = await smartListRequest("POST", `/${loc}`, body);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "update_smart_list",
+    "Update an existing smart list's name, filters, or columns. The objectKey CANNOT be changed after creation (GHL rejects with 422 if you try). Use get_smart_list first to inspect the current filters; partial updates work \u2014 pass only the fields you want to change.",
+    {
+      listId: import_zod40.z.string().describe("The smart list ID to update."),
+      name: import_zod40.z.string().optional().describe("New display name."),
+      filters: import_zod40.z.array(import_zod40.z.record(import_zod40.z.unknown())).optional().describe("Replace the filter array entirely. To add a filter, fetch the current list, append, and pass the new array."),
+      columns: import_zod40.z.array(import_zod40.z.record(import_zod40.z.unknown())).optional().describe("Replace the column array entirely."),
+      pipelineIds: import_zod40.z.array(import_zod40.z.string()).optional().describe("(opportunity only) Update the pipeline scope."),
+      defaultInPipelines: import_zod40.z.array(import_zod40.z.string()).optional().describe("(opportunity only) Update the default-in-pipelines list."),
+      locationId: import_zod40.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ listId, name, filters, columns, pipelineIds, defaultInPipelines, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const body = {};
+        if (name !== void 0) body.name = name;
+        if (filters !== void 0) body.filters = filters;
+        if (columns !== void 0) body.columns = columns;
+        if (pipelineIds !== void 0) body.pipelineIds = pipelineIds;
+        if (defaultInPipelines !== void 0) body.defaultInPipelines = defaultInPipelines;
+        if (Object.keys(body).length === 0) {
+          throw new Error("Pass at least one of: name, filters, columns, pipelineIds, defaultInPipelines. Nothing to update.");
+        }
+        const result = await smartListRequest("PUT", `/${loc}/${listId}`, body);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+  server2.tool(
+    "delete_smart_list",
+    "Permanently delete a smart list. IRREVERSIBLE. The list configuration is removed but the contacts/opportunities themselves are NOT touched \u2014 smart lists are just saved filters. Any workflow trigger / dashboard / report that referenced this list by ID will stop working.",
+    {
+      listId: import_zod40.z.string().describe("The smart list ID to delete."),
+      confirm: import_zod40.z.literal("DELETE").describe("Must pass 'DELETE' to confirm this destructive action."),
+      locationId: import_zod40.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ listId, locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await smartListRequest("DELETE", `/${loc}/${listId}`);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+}
+
+// src/tools/template-deployer.ts
+var import_zod41 = require("zod");
 var fs3 = __toESM(require("fs"));
 var path3 = __toESM(require("path"));
 function delay3(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
-var TemplateSchema = import_zod40.z.object({
-  templateName: import_zod40.z.string(),
-  templateVersion: import_zod40.z.string().optional(),
-  description: import_zod40.z.string().optional().default(""),
-  questionnaire: import_zod40.z.array(import_zod40.z.object({
-    id: import_zod40.z.string(),
-    question: import_zod40.z.string(),
-    type: import_zod40.z.string(),
-    required: import_zod40.z.boolean().optional(),
-    placeholder: import_zod40.z.string().optional()
+var TemplateSchema = import_zod41.z.object({
+  templateName: import_zod41.z.string(),
+  templateVersion: import_zod41.z.string().optional(),
+  description: import_zod41.z.string().optional().default(""),
+  questionnaire: import_zod41.z.array(import_zod41.z.object({
+    id: import_zod41.z.string(),
+    question: import_zod41.z.string(),
+    type: import_zod41.z.string(),
+    required: import_zod41.z.boolean().optional(),
+    placeholder: import_zod41.z.string().optional()
   })).optional().default([]),
-  location: import_zod40.z.record(import_zod40.z.unknown()).optional(),
-  tags: import_zod40.z.array(import_zod40.z.string()).optional(),
-  customFields: import_zod40.z.array(import_zod40.z.object({
-    name: import_zod40.z.string(),
-    dataType: import_zod40.z.string()
+  location: import_zod41.z.record(import_zod41.z.unknown()).optional(),
+  tags: import_zod41.z.array(import_zod41.z.string()).optional(),
+  customFields: import_zod41.z.array(import_zod41.z.object({
+    name: import_zod41.z.string(),
+    dataType: import_zod41.z.string()
   })).optional(),
-  pipelines: import_zod40.z.array(import_zod40.z.object({
-    name: import_zod40.z.string(),
-    stages: import_zod40.z.array(import_zod40.z.object({ position: import_zod40.z.number(), name: import_zod40.z.string() }))
+  pipelines: import_zod41.z.array(import_zod41.z.object({
+    name: import_zod41.z.string(),
+    stages: import_zod41.z.array(import_zod41.z.object({ position: import_zod41.z.number(), name: import_zod41.z.string() }))
   })).optional(),
-  workflows: import_zod40.z.array(import_zod40.z.object({
-    name: import_zod40.z.string(),
-    condition: import_zod40.z.string().optional(),
-    actions: import_zod40.z.array(import_zod40.z.record(import_zod40.z.unknown())).optional().default([])
+  workflows: import_zod41.z.array(import_zod41.z.object({
+    name: import_zod41.z.string(),
+    condition: import_zod41.z.string().optional(),
+    actions: import_zod41.z.array(import_zod41.z.record(import_zod41.z.unknown())).optional().default([])
   })).optional(),
-  calendars: import_zod40.z.array(import_zod40.z.object({
-    name: import_zod40.z.string(),
-    description: import_zod40.z.string().optional()
+  calendars: import_zod41.z.array(import_zod41.z.object({
+    name: import_zod41.z.string(),
+    description: import_zod41.z.string().optional()
   })).optional()
 });
 function registerTemplateDeployerTools(server2, client) {
@@ -6097,7 +6259,7 @@ function registerTemplateDeployerTools(server2, client) {
     "get_template_questionnaire",
     "Get the questionnaire for a specific template. Returns all the questions that need to be answered before deploying. Present these to the user one at a time in a conversational style.",
     {
-      templateFile: import_zod40.z.string().describe("Path to the template JSON file (from list_templates).")
+      templateFile: import_zod41.z.string().describe("Path to the template JSON file (from list_templates).")
     },
     async ({ templateFile }) => {
       try {
@@ -6130,10 +6292,10 @@ function registerTemplateDeployerTools(server2, client) {
     "deploy_template",
     "Deploy a template to set up a GHL sub-account. Creates tags, custom fields, pipelines with stages, calendars, workflows, and forms based on the template and the user's questionnaire answers. This is the main setup automation tool.",
     {
-      templateFile: import_zod40.z.string().describe("Path to the template JSON file."),
-      answers: import_zod40.z.record(import_zod40.z.unknown()).describe("Questionnaire answers keyed by question ID (e.g. {business_name: 'My Clinic', business_phone: '+15551234567', ...})."),
-      locationId: import_zod40.z.string().optional().describe("Location ID to deploy to. Uses default if not specified."),
-      dryRun: import_zod40.z.boolean().optional().describe("If true, shows what would be created without actually creating anything. Defaults to false.")
+      templateFile: import_zod41.z.string().describe("Path to the template JSON file."),
+      answers: import_zod41.z.record(import_zod41.z.unknown()).describe("Questionnaire answers keyed by question ID (e.g. {business_name: 'My Clinic', business_phone: '+15551234567', ...})."),
+      locationId: import_zod41.z.string().optional().describe("Location ID to deploy to. Uses default if not specified."),
+      dryRun: import_zod41.z.boolean().optional().describe("If true, shows what would be created without actually creating anything. Defaults to false.")
     },
     async ({ templateFile, answers, locationId: locationId2, dryRun }) => {
       try {
@@ -6379,7 +6541,7 @@ ${errors.join("\n")}` : "\nNo errors!",
 }
 
 // src/tools/validators.ts
-var import_zod41 = require("zod");
+var import_zod42 = require("zod");
 function extractFromTrigger(trigger, refs) {
   const triggerName = String(trigger.name ?? trigger.type ?? "unnamed trigger");
   const where = `trigger "${triggerName}"`;
@@ -6514,7 +6676,7 @@ function registerValidatorTools(server2, client, builderClient) {
     "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, workflows, forms, calendars, and surveys; 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_zod41.z.string().describe("The workflow ID to validate.")
+      workflowId: import_zod42.z.string().describe("The workflow ID to validate.")
     },
     async ({ workflowId }) => {
       try {
@@ -6882,6 +7044,7 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
   registerFormBuilderTools(server2, builderClient);
   registerPipelineBuilderTools(server2, builderClient);
   registerWorkflowClonerTools(server2, builderClient);
+  registerSmartListTools(server2, builderClient);
   registerValidatorTools(server2, client, builderClient);
   registerDiagnosticTools(server2, mcpVersion ?? "unknown", client, builderClient, registry2 ?? null);
   registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion);
@@ -6891,18 +7054,18 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var os = __toESM(require("os"));
-var import_zod42 = require("zod");
+var import_zod43 = require("zod");
 var APP_NAME = "elitedcs-ghl-mcp";
-var CredentialsSchema = import_zod42.z.object({
-  license_key: import_zod42.z.string().min(1),
-  email: import_zod42.z.string().email(),
-  verified_at: import_zod42.z.string().min(1),
-  ghl_api_key: import_zod42.z.string().min(1),
-  ghl_location_id: import_zod42.z.string().min(1),
-  ghl_company_id: import_zod42.z.string().optional(),
-  ghl_user_id: import_zod42.z.string().optional(),
-  ghl_firebase_api_key: import_zod42.z.string().optional(),
-  ghl_firebase_refresh_token: import_zod42.z.string().optional()
+var CredentialsSchema = import_zod43.z.object({
+  license_key: import_zod43.z.string().min(1),
+  email: import_zod43.z.string().email(),
+  verified_at: import_zod43.z.string().min(1),
+  ghl_api_key: import_zod43.z.string().min(1),
+  ghl_location_id: import_zod43.z.string().min(1),
+  ghl_company_id: import_zod43.z.string().optional(),
+  ghl_user_id: import_zod43.z.string().optional(),
+  ghl_firebase_api_key: import_zod43.z.string().optional(),
+  ghl_firebase_refresh_token: import_zod43.z.string().optional()
 });
 function appDataDir() {
   const home = os.homedir();
@@ -6952,7 +7115,7 @@ function writeCredentials(creds) {
 // src/setup-tool.ts
 var os2 = __toESM(require("os"));
 var crypto3 = __toESM(require("crypto"));
-var import_zod43 = require("zod");
+var import_zod44 = 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";
@@ -7021,16 +7184,16 @@ 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 190 tools (160 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 196 tools (161 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
-      email: import_zod43.z.string().email().describe("Email used at purchase."),
-      license_key: import_zod43.z.string().min(20).describe("License key from your purchase email."),
-      ghl_api_key: import_zod43.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_zod43.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
-      ghl_company_id: import_zod43.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
-      ghl_user_id: import_zod43.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
-      ghl_firebase_api_key: import_zod43.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
-      ghl_firebase_refresh_token: import_zod43.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
+      email: import_zod44.z.string().email().describe("Email used at purchase."),
+      license_key: import_zod44.z.string().min(20).describe("License key from your purchase email."),
+      ghl_api_key: import_zod44.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_zod44.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
+      ghl_company_id: import_zod44.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
+      ghl_user_id: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
+      ghl_firebase_api_key: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
+      ghl_firebase_refresh_token: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
     },
     async (args) => {
       const lic = await validateLicense(args.email, args.license_key);
@@ -7076,7 +7239,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 ? "190" : "160";
+      const toolCount = workflowBuilderEnabled ? "196" : "161";
       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 {
@@ -7104,11 +7267,11 @@ 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 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 160 to 190 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 161 to 196 after the next Claude restart.",
     {
-      ghl_user_id: import_zod43.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_zod43.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),
-      ghl_firebase_refresh_token: import_zod43.z.string().min(10).describe("Firebase refresh token. value.stsTokenManager.refreshToken in the firebase:authUser row.")
+      ghl_user_id: import_zod44.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_zod44.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),
+      ghl_firebase_refresh_token: import_zod44.z.string().min(10).describe("Firebase refresh token. value.stsTokenManager.refreshToken in the firebase:authUser row.")
     },
     async (args) => {
       const existing = readCredentials();
@@ -7151,7 +7314,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "Firebase credentials verified and saved.",
             "",
-            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (190 total).**",
+            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (196 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.10.0",
-  "description": "GoHighLevel MCP Server for Claude. 190 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+  "version": "3.11.0",
+  "description": "GoHighLevel MCP Server for Claude. 196 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"