@elitedcs/ghl-mcp 3.58.0 → 3.60.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 3.60.0 — One install for every tier, and upgrading is just the license key
+
+A real free-tier user installed, was told "Setup complete!", asked for the
+account audit every email promises — and got "Tool not found." The audit
+needs a one-time browser login that was framed as optional and buried after
+the success message. Worse: a free user who completed that login and then
+upgraded had it silently ERASED by the upgrade itself. This release makes
+the install one thing, for everyone:
+
+- **"Complete" now means complete.** When the browser login hasn't happened
+  yet, setup says "Step 1 of 2 done" and names the next command
+  (`capture_firebase_interactive`, now available before the restart) — one
+  restart total, not two. The word "optional" is gone.
+- **The auditor never vanishes.** Before the unlock, `audit_workflows` and
+  `validate_workflow` answer with 60-second finish-your-install directions
+  instead of not existing.
+- **Upgrading is one paste.** `setup_ghl_mcp` now accepts just your email and
+  the new license key: the GHL credentials and Workflow Builder unlock saved
+  on your machine are reused and kept. (Previously, re-running setup wiped
+  the unlock — fixed, with tests that keep it fixed.) Supply the GHL key and
+  location ID only on a first-time setup, always as a pair.
+- **A rejected credential update can no longer destroy a working one** — if
+  you re-run setup with bad Firebase values, the good saved ones stay.
+- `health_check` now points at the one-click unlock and current URLs.
+
+The free and paid tiers install identically; the license key alone decides
+what unlocks. Free stays read-only; paid unlocks everything, on the same
+install, with the same key-swap.
+
+## 3.59.0 — One-command install: `npx -y @elitedcs/ghl-mcp cli install`
+
+The old install step said "Edit Config, paste this block." Edit Config opens a
+folder, not a text box — and the block was a complete config object, so anyone
+who already had other MCP servers and followed the instruction literally wiped
+them. A real buyer hit exactly that this week.
+
+This release replaces the hand-edit with one command:
+
+    npx -y @elitedcs/ghl-mcp cli install
+
+It finds Claude Desktop's settings file (including the Microsoft Store build's
+relocated path on Windows), adds GHL Command **alongside** whatever servers are
+already there, and saves a verified backup before touching anything. If the
+file has a formatting problem — often caused by our own old instructions — it
+repairs what it can and preserves the original in the backup. If the file can't
+be read at all, it writes a fresh working config and keeps the original so
+nothing is ever lost.
+
+Safety properties, all tested (33 new tests):
+
+- **Never writes without a verified backup** of an existing file, and aborts if
+  the backup can't be confirmed byte-for-byte.
+- **Never fights Claude for the file**: writes are atomic, lock errors retry
+  briefly then stop with plain instructions, and if anything else modifies the
+  file mid-run it stops rather than overwrite the newer change.
+- **Never guesses between multiple config files** — it stops and asks.
+- **Never touches** symlinked configs pointing somewhere unexpected, UTF-16
+  files, or files whose content it can read but not safely restructure.
+- `--dry-run` previews every decision without writing; `--print-only` emits the
+  merged JSON for locked-down machines.
+
+Also in this release: the license-failure message now points at ghlcommand.com
+(and mentions the free tier) instead of a retired page, and `setup_ghl_mcp`'s
+description finally includes a URL for people who reach it without a license.
+
 ## 3.58.0 — Anonymous install stats, so we can find out where installs get stuck
 
 Most people who install GHL Command never get it working, and until now there

package/README.md

@@ -8,7 +8,7 @@ Works with **both the Claude Desktop App and Claude Code terminal** — your cho
 
 **License required.** Get it at [ghlcommand.com](https://ghlcommand.com?utm_source=npm&utm_medium=readme) — $97/mo, covering UNLIMITED GoHighLevel sub-accounts on up to 3 machines (never billed per account). **30-day time-back guarantee**: save 5+ hours on one client build or your first month back.
 
-**Try it FREE (read-only tier).** Grab an instant free key at [ghlcommand.com/free](https://ghlcommand.com/free?utm_source=npm&utm_medium=readme) — 107 read-only tools on your own GHL account (89 before the one-login auditor unlock): the account-wide workflow audit (`audit_workflows` finds the silently broken references GHL never warns you about), account health, and every read across contacts, pipelines, funnels, and workflows. Write tools stay visible and answer with upgrade info. Buying later with the same email upgrades your key in place — 1 machine on free, 3 when you upgrade.
+**Try it FREE (read-only tier).** Grab an instant free key at [ghlcommand.com/free](https://ghlcommand.com/free?utm_source=npm&utm_medium=readme) — 107 read-only tools on your own GHL account once the two-step install is finished (the same install as the paid tier — upgrading later is just a license swap): the account-wide workflow audit (`audit_workflows` finds the silently broken references GHL never warns you about), account health, and every read across contacts, pipelines, funnels, and workflows. Write tools stay visible and answer with upgrade info. Buying later with the same email upgrades your key in place — 1 machine on free, 3 when you upgrade.
 
 **How this differs from HighLevel's official MCP.** HighLevel ships an official Anthropic MCP that reads and writes your CRM (contacts, conversations, calendars, opportunities, payments, social) over the public API — it's free and it's good; use it for that. What it *cannot* do, because the public API doesn't expose it: **build or edit workflows, build funnels/landing pages, or build forms.** That's exactly what GHL Command does — the programmatic Workflow Builder, funnel/page builder, form builder, deep workflow cloning, the silent-failure `audit_workflows`, and Blueprint (build a whole client account from one intake — ships as a guided skill that **installs itself automatically** with this package; nothing to download), all on GHL's internal APIs. **Official MCP = read/write your CRM. GHL Command = build and fix it.** They stack fine together.
 
@@ -89,7 +89,24 @@ This MCP (Model Context Protocol) server connects Claude directly to GoHighLevel
 
 ### 2. Install in Claude Desktop App
 
-Open Claude Desktop. Click **Claude** menu (top-left) → **Settings...** → **Developer** → **Edit Config**. Paste this block (or merge into your existing `mcpServers` if you have other MCP servers):
+One command in any terminal (Terminal on Mac, PowerShell on Windows):
+
+```
+npx -y @elitedcs/ghl-mcp cli install
+```
+
+It finds Claude Desktop's settings file, adds GHL Command **alongside any MCP servers you already have** (nothing gets overwritten), and saves a backup first. If the file has a formatting problem, it repairs it. Then **quit Claude completely** — Cmd+Q on Mac; on Windows right-click the Claude icon by the clock and choose Quit — and reopen.
+
+> **Claude Code (terminal) instead?** One command:
+> ```
+> claude mcp add --scope user -t stdio ghl -- npx -y @elitedcs/ghl-mcp@latest
+> ```
+> Then restart Claude Code.
+
+<details>
+<summary>Prefer to edit the config by hand?</summary>
+
+Open Claude Desktop → **Settings...** → **Developer** → **Edit Config**. That opens a **folder**, not a text box — open `claude_desktop_config.json` from it in a text editor. If the file is empty, paste this whole block:
 
 ```json
 {
@@ -102,13 +119,9 @@ Open Claude Desktop. Click **Claude** menu (top-left) → **Settings...** → **
 }
 ```
 
-Save the file. **Quit Claude completely** (Cmd+Q on Mac) and reopen.
+If it already has other tools in it, do **not** paste over them — add only the `"ghl": { ... }` entry inside your existing `"mcpServers"` object. Save, then fully quit and reopen Claude. (Unsure? Run `npx -y @elitedcs/ghl-mcp cli install --dry-run` to preview exactly what would change, or `--print-only` to get the merged file printed for you.)
 
-> **Claude Code (terminal) instead?** One command:
-> ```
-> claude mcp add --scope user -t stdio ghl -- npx -y @elitedcs/ghl-mcp@latest
-> ```
-> Then restart Claude Code.
+</details>
 
 ### 3. Activate
 
@@ -162,7 +175,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## 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 179 tools work fine — you just won't have workflow/funnel/form/pipeline editing. This is the flagship feature: do this step.
+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 181 tools work fine — you just won't have workflow/funnel/form/pipeline editing. This is the flagship feature: do this step.
 
 **One-click capture (v3.49.0+, the supported path):**
 
@@ -505,7 +518,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 54 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