@elitedcs/ghl-mcp 3.45.0 → 3.46.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 3.46.0 — `verify_funnel`: prove a funnel actually captures leads (+ external-funnel wiring bundle)
+
+The live-runtime companion to `audit_workflows`. `audit_workflows` finds dead workflow
+steps (static); **`verify_funnel`** proves a public funnel actually **captures** a lead AND
+the machine **acts** on it — because the UI is never proof. (Motivated by two real failures
+from the field: a funnel whose thank-you page showed while every lead silently evaporated,
+and a handler that wrote guessed field keys so values were dropped on save.)
+
+- **New tool `verify_funnel`.** Submits a clearly-marked sentinel lead to the live funnel
+  URL, then reads GHL back to verify what REALLY happened:
+  - **Backend truth** — the contact is actually created (`search_contacts`), with submit→appear latency.
+  - **Field-value fidelity** — each expected field PERSISTED with the exact submitted value
+    (a wrong field id makes upsert succeed while silently dropping the value).
+  - **Trigger tag landed**, else the speed-to-lead workflow can't fire.
+  - **SMS/A2P pre-check** — flags an account with no SMS-capable number (any SMS step would silently fail).
+  - **Workflow status** — flags a DRAFT workflow (never fires on real leads).
+  - **Outreach fired** — an outbound message was actually logged (proves enrollment + send, not a green log).
+  - **Consent recorded** when messaging fires (TCPA/CAN-SPAM).
+  - **Duplicate-contact dedup** + **concurrent double-submit race** (lag-stable polling, no false-pass).
+  - **Routing/opportunity/attribution** (optional) and **multi-surface** (extra URLs).
+  - Booking can't be faked server-side → surfaced as a manual "book one real appointment" step.
+  - Safety: creates a real (clearly-marked `blueprint-qa`) contact and may fire real automation;
+    cleans the sentinel(s) up afterward by default (cleanup runs even on error), with a verdict
+    that turns any failed assertion into an overall FAIL (no silent skips).
+- **`apply_build_plan` execute now returns an `externalWiring` bundle.** For each
+  `target:"external"` funnel: the location id, the **verified GHL custom-field ids** the
+  external form must send (never name-guessed keys), the booking URL, and the contact-tag
+  trigger to add — with an `unresolved` list for anything not yet built. This is what you
+  template into the self-hosted lead bridge (`templates/external-funnel/`).
+- External-funnel README hardened: the contactless-inbound-webhook rationale (why the bridge
+  uses `/contacts/upsert`, not a raw trigger) + a "verify after deploy" QA checklist.
+
 ## 3.35.0 — `create_social_post` is now draft-first (closes the silent "everything published at once" trap)
 
 **Behavior change.** `create_social_post` no longer defers go-live to GoHighLevel's

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 219 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.** 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.
 
 **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 (219 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 (220 tools total with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 
@@ -734,7 +734,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 219 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 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`:
 
 ```jsonc
 // Claude Desktop config — enable whole modules