@elitedcs/ghl-mcp 3.53.2 → 3.55.0

package/CHANGELOG.md

@@ -1,37 +1,67 @@
 # Changelog
 
-## 3.53.2 — Fixes a serious 3.53.1 regression: upgrade immediately
-
-3.53.1 resolved the machine identity randomly when nothing was passed in, and
-that is exactly how attestation verification asks for it. Cached attestations
-failed to verify, the tool dropped to bootstrap, and each restart would have
-claimed another install slot until the member hit their cap.
-
-- No-argument identity resolution is deterministic again: stored `device_id`
-  first, then the fingerprint inside an existing attestation (so an upgrade
-  keeps the slot it already holds), then the legacy scheme as a last resort.
-- Two tests pin the determinism so this cannot ship again.
-
-If you ran 3.53.1, upgrade. If your install count looks inflated, write to
-support@ghlcommand.com and we will reset it.
-
-## 3.53.1 — Laptops stop eating install slots; "cancelled" stops lying
-
-Reported by Carlos Boyd, who hit his install cap with two physical machines.
-
-- **Device identity is stable now.** The fingerprint was derived from the
-  machine hostname, and a Mac's `.local` hostname changes with the network
-  (new Wi-Fi, DHCP, a name collision) — so the same laptop could present a new
-  identity and claim another install slot. Identity is now a random id
-  persisted in the config dir, so it survives reinstalls and renames. On
-  upgrade it ADOPTS the fingerprint from the existing cached attestation, so no
-  current install loses the slot it already holds. `legacyDeviceFingerprint()`
-  is kept for reference.
-- **Install-limit is no longer reported as "cancelled".** Both conditions come
-  back from the gate as 403, and the client labelled both `cancelled`, so a
-  full machine list read as a billing failure — two contradictory lines in the
-  same block. `install_limit` is its own reason, and the gate prints the
-  server's own sentence instead of a reason code beside it.
+## 3.55.0 — Skills ship inside the package: Blueprint installs itself
+
+The gap between "the tools exist" and "the guided experience exists" is
+closed. The npm package now bundles guided skills and installs them into
+your `~/.claude/skills/` automatically on every start — nothing to download,
+no separate zip.
+
+- **Blueprint is now actually delivered**: the full guided skill (intake →
+  brief → build plan → approval → staged build) that orchestrates the six
+  Blueprint tools ships in the package. Previously the README sold it but
+  only the raw tools shipped.
+- Installer is idempotent and never clobbers your edits: files you've
+  modified are kept and reported, updates only touch files the installer
+  itself wrote (tracked by content hash in `.ghl-command-skills.json`).
+- New `install_skills` tool (every tier — it only writes to your machine)
+  to verify what's installed or repair a deleted skill.
+- Restart Claude fully after an update so new skills load.
+
+## 3.54.0 — Page Studio: `compose_page` + `compose_website` build designer-grade pages
+
+The gap between "GHL Command creates funnels/websites" and "the pages look
+professionally designed" is closed. A section library cloned field-for-field
+from a professionally designed GHL template (topbar, nav, image hero, icon
+value cards, feature blocks, CTA banners, FAQ, map, calendar booking, inline
+form with A2P disclosures, compliant footer) composes complete pages that
+GHL's renderer verifiably renders.
+
+- `compose_page`: a complete opt-in funnel page in one call — hero, quotable
+  value cards, inline form (embeds your real form), FAQ, footer with legal
+  name/address/privacy/terms. Refuses to build an opt-in page without the
+  A2P-required business facts.
+- `compose_website`: a complete multi-page website in one call (home, about,
+  services, booking, contact) — nav wired to the real pages, booking page
+  embeds a real calendar, every page carries the compliant footer.
+- Brand-themeable: pass brand colors + Google fonts; copy can use
+  `{{location.*}}` merge fields and localizes per account automatically.
+- Safe by contract: `dry_run` writes nothing; `create` refuses any page that
+  already has content, any page it cannot read, and any page belonging to a
+  different funnel — existing pages can never be damaged. All saves are drafts
+  and verified after writing. (There is deliberately no overwrite mode: GHL
+  only honors the first save onto a page; to redo a page, delete its step and
+  compose onto a fresh one.)
+- Includes the 3.53.2 licensing fixes (stable device identity, honest
+  install-limit message, deterministic identity resolution).
+
+## 3.53.2 — Licensing: fix the 3.53.1 identity regression
+
+3.53.1's device fingerprint could return a random id in the no-argument path,
+so cached attestations failed to verify and every restart could claim a fresh
+install slot. 3.53.2 makes identity resolution deterministic. If you are on
+3.53.1, update. (No members were affected — verified against the license DB.)
+
+## 3.53.1 — Licensing: stable device identity + honest install-limit message
+
+Superseded by 3.53.2 (see above) — do not install this version.
+
+## 3.53.0 — `create_funnel` can now create websites
+
+Subscriber report: the tool description said "funnel/website" but the handler
+hardcoded `type:"funnel"`. New optional `type` parameter (`funnel` | `website`,
+default `funnel`). Live-verified: websites persist and appear under
+Sites → Websites; omitting the parameter behaves exactly as before.
 
 ## 3.52.1 — Docs: positioning vs. HighLevel's official Anthropic MCP
 

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 232 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.
+**Full GoHighLevel API access for Claude.** 235 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,9 +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) — 106 read-only tools on your own GHL account (88 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 (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.
 
-**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 sentence), all on GHL's internal APIs. **Official MCP = read/write your CRM. GHL Command = build and fix it.** They stack fine together.
+**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. 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).
 
@@ -120,7 +122,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 (232 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 (235 tools total with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 
@@ -160,7 +162,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 180 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):**
 
@@ -503,7 +505,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 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. |
+| `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. |
 
 ### Other Modules
 
@@ -749,7 +751,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 232 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 235 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