@elitedcs/ghl-mcp 3.8.1 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # Changelog
 
+## 3.10.0 — Email Templates (gap-closure round 2)
+
+**190 tools across 39 modules. Bundle: 304.6 KB.**
+
+Closes another buyer-visible gap from the v3.8.1 analysis. Email templates power both standalone marketing emails and workflow email actions — agencies have been asking for programmatic management since day one.
+
+### How GHL's API is structured
+GHL calls these "builders" in the public API (the term comes from the drag-and-drop email-builder UI). One template is one builder. Each template has metadata (id, title, type, version, lastUpdated) plus HTML content stored separately in Firebase storage.
+
+### 3 new tools
+- **`list_email_templates`** — paginated list of all email templates in a location
+- **`create_email_template`** — create a template shell. Required: `title`, `type` (one of `html`, `folder`, `import`, `builder`, `blank`, `ai_template`, `vibe-editor`). Response includes the new template `id`.
+- **`update_email_template`** — save HTML content into an existing template. Takes `templateId`, `html`, `editorType` (one of `html`, `builder`), and optional `updatedBy` (defaults to "mcp"). Response includes the Firebase storage preview URL.
+
+### Endpoint discovery transparency
+Probed extensively. **Three endpoints work on the public API:**
+- `GET /emails/builder?locationId=X` — list ✅
+- `POST /emails/builder` with `{locationId, title, type}` — create ✅
+- `POST /emails/builder/data` with `{locationId, templateId, html, editorType, updatedBy}` — save content ✅
+
+**Three operations are NOT on the public API:**
+- `GET /emails/builder/{id}` returns 404 — single-get doesn't exist
+- `PUT /emails/builder/{id}` returns 404 — renaming after create is not exposed
+- `DELETE /emails/builder/{id}` returns 404 — deletion is not exposed (also tried on the internal backend.leadconnectorhq.com host with the same auth — still 404)
+
+These three likely live on GHL's internal API behind Firebase auth. Reaching them would need the same DevTools-capture work that unlocked workflow-builder and funnel-builder. Buyers can delete/rename via the GHL UI for now.
+
+### Round-trip verified against MCP Testing
+- 3/3 new tools registered (190 total)
+- Created template → saved HTML content with merge-field syntax → listed and confirmed the template appeared with the new `templateType: html` flag and a Firebase storage preview URL.
+
+### Tool count impact
+- Total: 187 → 190 (+3)
+- Without Firebase: 157 → 160 (all new tools are public API)
+
+### Field-name quirk worth knowing
+On WRITE, the title field is called `title`. On READ in the list response, it shows up as `name`. The `create_email_template` tool's parameter is `title` (matching write); the list response gives buyers `name` (matching GHL's read shape). Not something Claude needs to worry about — the tools handle the conversion implicitly.
+
+### Files changed
+- `src/tools/emails.ts` — added 3 template tools alongside the existing `get_email_campaigns`
+
+## 3.9.0 — Products + Trigger Links CRUD (gap-closure round 1)
+
+**187 tools across 39 modules. Bundle: 300.9 KB.**
+
+Closes two known buyer-visible write gaps surfaced in the v3.8.1 gap analysis. Both use the public GHL API (no Firebase required) so they unlock for every install, not just buyers who've completed Firebase setup.
+
+### Products (6 new tools)
+New module `src/tools/products.ts`. Products underlie invoices, memberships, courses, and e-commerce — previously invisible to MCP write tools.
+
+- `list_products` — paginated list with optional name+description search
+- `get_product` — full details (media, variants, taxes, status)
+- `create_product` — name + productType (DIGITAL / PHYSICAL / SERVICE / PHYSICAL_DIGITAL), optional description, image, statement descriptor
+- `update_product` — partial updates work (fetch-then-merge: only the fields you pass change)
+- `delete_product` — confirm:"DELETE" gated
+- `list_product_prices` — read prices on a single product
+
+**Honest scope note:** Price writes (POST/PUT/DELETE on `/products/{id}/price`) return 403 with sub-account Private Integration scopes. Probably need agency-level auth. Not exposed.
+
+### Trigger Links (3 new tools, on top of existing `get_trigger_links`)
+Agencies use trigger links heavily for campaign tracking. The list endpoint was already there but write tools were missing.
+
+- `create_trigger_link` — name + redirectTo (URL or merge-field like `{{contact.website}}`)
+- `update_trigger_link` — rename or change destination; tracking key + short URL stay the same
+- `delete_trigger_link` — confirm:"DELETE" gated
+
+**Verified end-to-end** against MCP Testing: created → updated → listed → deleted, both modules.
+
+### Gap analysis findings (what we DIDN'T ship and why)
+
+Probed GHL's public API for every Tier 1+2 item from the v3.8.1 gap analysis. Results:
+
+| Area | Public API status | Action |
+|---|---|---|
+| Products CRUD | ✅ 200 | **Shipped in v3.9.0** |
+| Trigger Links CRUD | ✅ 200 / 201 | **Shipped in v3.9.0** |
+| Email templates | ❌ 404 (no endpoint) | Would need internal-API reverse-engineering |
+| SMS templates / snippets | ❌ 404 | Same |
+| Email campaigns create/send | ❌ 404 (only list works) | Same |
+| Reviews / reputation | ❌ 404 | Same |
+| Smart Lists / saved searches | ❌ 404 / 400 | Same |
+| Memberships sub-features (offers, lessons) | ❌ 404 | Same |
+| Product price writes | ❌ 403 with sub-account scope | Likely agency-only |
+
+For the 404 items, the same DevTools-capture methodology we used for workflow-builder and funnel-builder would work, but each one is a Phase-2-style investment.
+
+### Tool count impact
+- Total: 178 → 187 (+9)
+- Without Firebase: 148 → 157 (all new tools use public API, no Firebase required)
+- With Firebase: 178 → 187
+- Modules: 38 → 39 (new products module)
+
+### Files changed
+- `src/tools/products.ts` (NEW)
+- `src/tools/trigger-links.ts` — added 3 write tools
+- `src/tools/index.ts` — registered new products module
+- `src/setup-tool.ts` — refreshed tool counts (148 → 157, 178 → 187)
+
 ## 3.8.1 — Vitest test suite + pre-publish gate
 
 **178 tools across 38 modules. Bundle: 291.3 KB (unchanged).**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 178 tools across 36 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.
+**Full GoHighLevel API access for Claude.** 190 tools across 39 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.
 
 **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).
 
@@ -138,7 +138,7 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-The 30 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 148 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
+The 30 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 160 tools work fine — you just won'''t have workflow/funnel/form/pipeline editing.
 
 Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
 
@@ -167,9 +167,9 @@ Re-run setup_ghl_mcp with workflow builder:
 
 ---
 
-## Tools (178)
+## Tools (190)
 
-> **v3.7.0 fixes Don Harris's 2026-05-14 funnel-builder audit.** All six previously-broken funnel write tools (`update_funnel`, `create_funnel_page`, `delete_funnel_page`, `delete_funnel`, `update_page_content`, plus `create_funnel` which 401'd) now hit the correct GHL endpoints. New: `update_funnel_step` for per-step renames / slugs / domains. Origin + Referer headers added to all funnel writes — required by GHL's IAM, missing before.
+> **v3.10.0 adds Email Templates** (`list_email_templates`, `create_email_template`, `update_email_template`) — Claude can now create new HTML email templates and save content into them via the public API. Templates power both standalone marketing emails and workflow email actions. Delete + rename remain UI-only (no public-API endpoint exists).
 
 ### CRM & Contacts (15 tools)