@elitedcs/ghl-mcp 3.48.0 → 3.48.2

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 3.48.2 — Docs patch: tool-count claims corrected (the real number is 228)
+
+No behavior changes; text only, plus one new test.
+
+- **Tool counts reconciled everywhere.** The claims had drifted three ways (setup tool
+  said 212/163, README and package.json said 220, ghlcommand.com said 219). The real
+  numbers, enumerated from the registry itself: **228 tools across 48 modules** on a
+  fully configured install, **176** without the Firebase add-on, **+52** unlocked by
+  `enable_workflow_builder`. All copy in `setup_ghl_mcp`, `enable_workflow_builder`,
+  README, and package.json now states these.
+- **Drift guard added.** `src/tools/tool-count.test.ts` computes the real count from
+  `registerAllTools` and fails the suite if package.json, README, or setup-tool copy
+  ever disagrees again.
+
+
+## 3.48.1 — Docs patch: Firebase capture friction + live pricing copy
+
+No behavior changes; text only.
+
+- **Chrome "allow pasting" gotcha documented.** `auto_capture_firebase_script`'s steps now
+  tell buyers that when Chrome blocks the console paste, typing `allow pasting` in the
+  Console unblocks it. This was the single most common silent failure in the capture flow.
+- **`request_license` copy corrected to the live offer.** Was "$97 one-time, no
+  subscription" pointing at the old elitedcs.com page; now "$97/mo, every sub-account you
+  manage" pointing at ghlcommand.com. The old copy misquoted the price to prospects
+  installing from npm.
+- **README: one-paste capture is now the primary Workflow Builder path.** The manual
+  7-step IndexedDB walk is demoted to a collapsed fallback for locked-down browsers;
+  multi-tenant instructions reference the script instead of the manual steps.
+
+
 ## 3.48.0 — Blueprint: complete workflow-building (opportunities, branching, appointment timers, opt-in publish)
 
 Completes the `apply_build_plan` executor so a Blueprint build produces workflows that

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 220 tools across 43 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. **Multi-tenant:** one install can run the workflow builder across multiple clients' GHL accounts.
+**Full GoHighLevel API access for Claude.** 228 tools across 48 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. **Multi-tenant:** one install can run the workflow builder across multiple clients' GHL accounts.
 
 **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).
 
@@ -116,7 +116,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** — the full core toolset is now unlocked (220 tools total with the optional Workflow Builder Firebase add-on).
+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** — the full core toolset is now unlocked (228 tools total with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 
@@ -154,11 +154,24 @@ Your Location ID (sub-account ID) is in the GHL URL when you'''re inside a sub-a
 https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 ```
 
-## Enable Workflow Builder (Optional)
+## Enable the Workflow Builder
 
-The 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 163 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
+The 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 176 tools work fine — you just won't have workflow/funnel/form/pipeline editing. This is the flagship feature: do this step.
 
-Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
+**One-paste capture (the supported path):**
+
+1. In Claude, ask: `Run auto_capture_firebase_script`. It returns a small browser-console script.
+2. In Chrome, open a tab logged into your GHL account. Press **F12** (Windows) or **Cmd+Option+I** (Mac), click the **Console** tab, paste the script, press Enter. If Chrome blocks the paste, type `allow pasting` in the Console first, then paste again.
+3. The script extracts the three Firebase values and copies them to your clipboard as JSON.
+4. Back in Claude: `Run enable_workflow_builder` and paste the JSON into the `firebase_paste` field. (First-time setup? You can instead add `firebase_paste` as a fifth field on `setup_ghl_mcp`.)
+5. Restart Claude. The Firebase-gated tools are live.
+
+Screenshots and the same script behind a copy button: [elitedcs.com/ghl-mcp-firebase](https://elitedcs.com/ghl-mcp-firebase)
+
+> Firebase refresh tokens can rotate. If workflow tools stop working after a few weeks (`health_check` shows Firebase auth: FAIL), re-run `auto_capture_firebase_script` for fresh values and pass them to `enable_workflow_builder` again.
+
+<details>
+<summary><strong>Manual fallback</strong> (locked-down browsers that block console pasting or clipboard access)</summary>
 
 1. Open `app.gohighlevel.com` in Chrome (or any Chromium browser), log in.
 2. Open DevTools (Cmd+Opt+I on Mac, F12 on Windows) → **Application** tab → **IndexedDB** in the left panel.
@@ -168,20 +181,9 @@ Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp`
 6. Inside that row's value object: `uid` is your **ghl_user_id**.
 7. Inside `value.stsTokenManager.refreshToken` is your **ghl_firebase_refresh_token**.
 
-Then in Claude:
-
-```
-Re-run setup_ghl_mcp with workflow builder:
-  email: YOUR_PURCHASE_EMAIL
-  license_key: YOUR_LICENSE_KEY
-  ghl_api_key: YOUR_GHL_API_KEY
-  ghl_location_id: YOUR_LOCATION_ID
-  ghl_user_id: FROM_STEP_6
-  ghl_firebase_api_key: FROM_STEP_5
-  ghl_firebase_refresh_token: FROM_STEP_7
-```
+Then in Claude, run `enable_workflow_builder` (or re-run `setup_ghl_mcp` with your license fields) passing the three values individually as `ghl_user_id`, `ghl_firebase_api_key`, and `ghl_firebase_refresh_token`.
 
-> Firebase refresh tokens can rotate. If workflow tools stop working after a few weeks, repeat steps 1–7 and re-run setup_ghl_mcp with fresh values.
+</details>
 
 ## Working in Clients' Accounts (Multi-Tenant)
 
@@ -198,7 +200,7 @@ To unlock full builder access across multiple clients from one install:
    ```
    This auto-detects and stores the owning **companyId**.
 
-2. **Capture the client's Firebase values** from a browser session logged into *their* account (same DevTools steps 1–7 above, but while viewing the client's GHL).
+2. **Capture the client's Firebase values** from a browser session logged into *their* account (run `auto_capture_firebase_script` the same way as above, but paste it into a tab logged into the client's GHL).
 
 3. **Register the client's company Firebase:**
    ```
@@ -488,7 +490,7 @@ Highlights (full guide: [`docs/HEADLESS.md`](docs/HEADLESS.md)):
 |---|---|
 | `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 49 additional Firebase-gated tools (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, memberships, 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. |
+| `enable_workflow_builder` | Add Firebase credentials to an existing install to unlock 52 additional Firebase-gated tools (workflow builder, funnel builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, memberships, 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
 
@@ -734,7 +736,7 @@ Source repo is private. Contributors need an invitation from `drjerryrelth`. The
 
 ### Reducing context / token usage
 
-Every registered MCP tool's schema is shipped to the model on every message. With 220 tools that's a meaningful per-message context cost even in chats that never touch GHL. If you only use a slice of GHL Command, restrict the tool surface with `GHL_ENABLED_MODULES` and/or `GHL_ENABLED_TOOLS`:
+Every registered MCP tool's schema is shipped to the model on every message. With 228 tools that's a meaningful per-message context cost even in chats that never touch GHL. If you only use a slice of GHL Command, restrict the tool surface with `GHL_ENABLED_MODULES` and/or `GHL_ENABLED_TOOLS`:
 
 ```jsonc
 // Claude Desktop config — enable whole modules

package/dist/index.js

@@ -31,9 +31,9 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.48.0",
+      version: "3.48.2",
       mcpName: "io.github.drjerryrelth/ghl-command",
-      description: "GoHighLevel MCP Server for Claude. 220 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+      description: "GoHighLevel MCP Server for Claude. 228 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -7055,7 +7055,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 212 tools (163 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 228 tools (176 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
       email: import_zod38.z.string().email().describe("Email used at purchase."),
       license_key: import_zod38.z.string().min(20).describe("License key from your purchase email."),
@@ -7136,7 +7136,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
         // verified on every MCP startup. Closes the hand-crafted creds bypass.
         signed_attestation: lic.signedAttestation
       });
-      const toolCount = workflowBuilderEnabled ? "212" : "163";
+      const toolCount = workflowBuilderEnabled ? "228" : "176";
       const wfLine = workflowBuilderEnabled ? "Workflow Builder: enabled." : "Workflow Builder: not configured (optional).";
       const wfTip = workflowBuilderEnabled ? "" : "\nTo enable Workflow Builder later (49 extra Firebase-gated tools): run enable_workflow_builder with your three Firebase values. No need to re-enter license/API key/location ID.";
       return {
@@ -7164,7 +7164,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 49 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. Requires you've already run setup_ghl_mcp. EASIEST PATH: run `auto_capture_firebase_script` first, paste the JSON output into `firebase_paste` here. MANUAL PATH: capture the three Firebase fields via DevTools and pass them individually. Tool count goes from 163 to 212 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 52 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. Requires you've already run setup_ghl_mcp. EASIEST PATH: run `auto_capture_firebase_script` first, paste the JSON output into `firebase_paste` here. MANUAL PATH: capture the three Firebase fields via DevTools and pass them individually. Tool count goes from 176 to 228 after the next Claude restart.",
     {
       // v3.25.0: one-paste path. Tool runs `auto_capture_firebase_script` to
       // get the console script; the script returns a JSON object that pastes
@@ -7245,7 +7245,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "**You MUST restart Claude before using any workflow-builder tool.** Quit Claude completely (Cmd+Q on Mac, full exit on Windows) and reopen. Without a restart, the workflow builder tools will keep using the OLD Firebase auth from before this call and fail with 401 errors \u2014 even though this tool reported success.",
             "",
-            'After restart, all 212 tools load. Try: "List my workflows in full detail" or "Validate workflow <id>".',
+            'After restart, all 228 tools load. Try: "List my workflows in full detail" or "Validate workflow <id>".',
             "",
             "Note: Firebase refresh tokens rotate every few weeks. If workflow tools stop working in a few weeks (run `health_check` to confirm Firebase auth: FAIL), run `auto_capture_firebase_script` for fresh values and re-run this tool with the new firebase_paste."
           ].join("\n")
@@ -7267,7 +7267,7 @@ function registerFirebaseCaptureScriptTool(server2) {
         "",
         "**Step 2.** Open DevTools \u2014 press `F12` on Windows / Linux, or `Cmd+Option+I` on Mac. Click the **Console** tab.",
         "",
-        "**Step 3.** Copy the script below, paste it into the Console, and press Enter:",
+        "**Step 3.** Copy the script below, paste it into the Console, and press Enter. If Chrome blocks the paste with a warning, type `allow pasting` in the Console first, then paste again:",
         "",
         "```javascript",
         FIREBASE_CAPTURE_SCRIPT,
@@ -7294,13 +7294,13 @@ function registerFirebaseCaptureScriptTool(server2) {
 function registerLeadCaptureTool(server2) {
   server2.tool(
     "request_license",
-    "Get a GHL Command license. Use this if you installed from npm but don't have a license yet (or setup_ghl_mcp says your license is missing/invalid). GHL Command is $97 one-time \u2014 212 tools across 43 modules, 3-machine activation, no subscription. Leave your email and we'll send the purchase link + setup help; the tool also returns where to buy right now.",
+    "Get a GHL Command license. Use this if you installed from npm but don't have a license yet (or setup_ghl_mcp says your license is missing/invalid). GHL Command is $97/mo \u2014 every sub-account you manage, 3-machine activation, includes the only programmatic GHL workflow builder. Leave your email and we'll send the purchase link + setup help; the tool also returns where to buy right now.",
     {
       email: import_zod38.z.string().email().describe("Your email \u2014 where to send the purchase link and setup help."),
       name: import_zod38.z.string().optional().describe("Your name (optional).")
     },
     async (args) => {
-      const buyUrl = "https://elitedcs.com/ghl-mcp-server";
+      const buyUrl = "https://ghlcommand.com";
       try {
         const res = await fetch(CAPTURE_API, {
           method: "POST",
@@ -7315,7 +7315,7 @@ function registerLeadCaptureTool(server2) {
             text: [
               data.message || "You're on the list.",
               "",
-              "GHL Command is $97 one-time: 212 tools across 43 modules, including the only programmatic GHL workflow builder. 3 machines, no subscription.",
+              "GHL Command is $97/mo: every sub-account you manage, 3 machines, including the only programmatic GHL workflow builder. Cancel anytime.",
               "",
               `Buy now: ${url}`,
               "Your license key arrives by email within a couple minutes. Then run setup_ghl_mcp with your email + key."
@@ -7326,7 +7326,7 @@ function registerLeadCaptureTool(server2) {
         return {
           content: [{
             type: "text",
-            text: `Buy your GHL Command license ($97 one-time) at ${buyUrl} \u2014 your key arrives by email within a couple minutes, then run setup_ghl_mcp with your email + key.`
+            text: `Buy your GHL Command license ($97/mo) at ${buyUrl} \u2014 your key arrives by email within a couple minutes, then run setup_ghl_mcp with your email + key.`
           }]
         };
       }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.48.0",
+  "version": "3.48.2",
   "mcpName": "io.github.drjerryrelth/ghl-command",
-  "description": "GoHighLevel MCP Server for Claude. 220 tools — full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+  "description": "GoHighLevel MCP Server for Claude. 228 tools — full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"