@elitedcs/ghl-mcp 3.59.0 → 3.61.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## 3.61.0 — Verified counts: get_contact_count + the GHL Reports skill
+
+A customer asked for "new contacts in the last 7 days" and watched Claude burn
+97,000 tokens across 15 minutes, cap out at one page of a 39,776-contact book,
+and finally offer a number it admitted it never verified. The gap was
+structural: `search_contacts` rides the legacy list endpoint (no date filters),
+so counting forced client-side pagination and improvisation.
+
+- **New tool `get_contact_count`** (free tier included): one call to GHL's own
+  index answers any "how many contacts in this window" question. Date-only
+  bounds resolve in the LOCATION's timezone (from = start of day, to = end of
+  day, both inclusive) and the response echoes the exact resolved window next
+  to the total. When the count can't be verified it answers
+  `status: "unavailable"` with the reason — never an estimate, never a silent 0.
+- **One counting code path product-wide:** the windowed-count logic is shared
+  with `get_account_health_summary` (extracted to `src/contact-window.ts`), so
+  two parts of the product can never report two different "new contacts"
+  numbers for the same window.
+- **Anti-guessing rules now live in the tool descriptions** (always loaded, no
+  restart needed): `search_contacts` points count questions at
+  `get_contact_count`; the counter's description mandates reporting the number
+  with its window echo.
+- **New bundled skill: GHL Reports** — count/list/report recipes (one-call
+  counts, CSV list pagination with count reconciliation, composed account
+  summaries), auto-installed like Blueprint and Clone Site.
+- Tool count: 233 → 234 (free tier 107 → 108). Sites listing free-tier counts
+  (ghlcommand.com/free) need the 108 figure.
+
+## 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

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 233 tools across 49 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.** 234 tools across 49 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).
 
@@ -8,11 +8,11 @@ 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) — 108 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.
 
-**Bundled skills (install automatically).** The package ships guided skills that teach Claude complete multi-step workflows on top of the raw tools. On every start the server installs/updates them into your `~/.claude/skills/` (never overwriting files you've edited — your version wins and is reported). Current skills: **Blueprint** — turn one client intake into a complete reviewed GHL account build; **Clone Site** — point at a live URL and get a rebranded, deploy-ready copy for a client, with a recorded rights declaration, a style-only lane when you have no rights, and a mandatory pre-launch report of every lead/booking/payment destination, borrowed testimonial and inherited claim still belonging to the original owner. Verify or repair any time by asking Claude to `run install_skills`, then fully restart Claude so new skills load.
+**Bundled skills (install automatically).** The package ships guided skills that teach Claude complete multi-step workflows on top of the raw tools. On every start the server installs/updates them into your `~/.claude/skills/` (never overwriting files you've edited — your version wins and is reported). Current skills: **Blueprint** — turn one client intake into a complete reviewed GHL account build; **Clone Site** — point at a live URL and get a rebranded, deploy-ready copy for a client, with a recorded rights declaration, a style-only lane when you have no rights, and a mandatory pre-launch report of every lead/booking/payment destination, borrowed testimonial and inherited claim still belonging to the original owner; **GHL Reports** — counts, lists, and weekly reports that come back fast and verified (one-call windowed contact counts via `get_contact_count`, clean CSV list recipes, composed account summaries — never a guessed number, works on the free tier). Verify or repair any time by asking Claude to `run install_skills`, then fully restart Claude so new skills load.
 
 Built by [Elite DCs, LLC](https://elitedcs.com).
 
@@ -135,7 +135,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 (233 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 (234 tools total with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 
@@ -175,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 182 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):**
 
@@ -518,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
 
@@ -798,7 +798,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 233 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 234 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