@elitedcs/ghl-mcp 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 3.1.1 — Auto-update visibility
+
+**173 tools across 36 modules. Bundle: 249.7 KB.**
+
+The v3.0 install email promises the MCP auto-updates on Claude restart, and it does. But the old `checkForUpdates()` only worked for local git-checkout dev installs — for buyers running `npx -y @elitedcs/ghl-mcp@latest` it silently returned. This release makes the upgrade visible and verifiable.
+
+### `checkForUpdates` rewritten for the npm install path
+- Queries `registry.npmjs.org/@elitedcs/ghl-mcp/latest` instead of running `git fetch`.
+- Writes a clear stderr line when a newer version is available: `Update available: vX → vY. Fully quit Claude (Cmd+Q on Mac) and reopen to upgrade.`
+- 5 s timeout, non-blocking.
+
+### `get_mcp_version` tool (NEW)
+- Returns installed version, latest published version on npm, and the one-line restart instruction if not current.
+- Registered in BOTH bootstrap and normal modes — buyers without configured GHL credentials can still verify their MCP version.
+- Use case: "Hey Claude, check your version" → instant confirmation an upgrade landed.
+
+### Version baked into `get_current_location`
+- Adds `MCP version: vX.Y.Z` line to the response so the version surfaces naturally on the first GHL tool call of a session, no separate query needed.
+
+### Files changed
+- `src/index.ts` — replaced git-based update check with npm registry check; registers meta tools in both modes; threads version into `registerAllTools`.
+- `src/version-check.ts` — NEW: shared `fetchLatestVersion()` + `getVersionStatus()` used by startup banner and the tool.
+- `src/tools/meta.ts` — NEW: `get_mcp_version` tool.
+- `src/tools/index.ts` — `registerAllTools` accepts optional `mcpVersion` and threads it to the location switcher.
+- `src/tools/location-switcher.ts` — appends `MCP version: vX.Y.Z` to `get_current_location` response.
+
+## 3.1.0 — Workflow trigger read-side coverage
+
+**172 tools across 35 modules.**
+
+GHL ships 57 native trigger types. The MCP previously typed only 4 (`customer_reply`, `appointment`, `contact_tag`, `pipeline_stage_updated`). Workflows using any of the other 53 — `form_submission`, `payment_received`, `opportunity_*`, `inbound_webhook`, etc. — threw Zod errors on `get_workflow_full`. This release unlocks all of them on the read side.
+
+### Permissive `WorkflowTriggerSchema`
+- `z.union` of the 4 typed variants plus an `UnknownTriggerSchema` fallback that accepts any string-keyed `type` and a `conditions` array of arbitrary records.
+- Write side is unchanged — typed triggers still get their typed conditions; unknown triggers pass through untouched on save.
+- Defined in BOTH `src/workflow-builder-client.ts` and `src/tools/workflow-builder.ts` (read path + tool input schema).
+
+### `get_trigger_registry` tool (NEW)
+- Calls GHL's marketplace endpoint `/marketplace/core/search/module?type=triggers` and returns ~85 third-party apps (Zoom, WooCommerce, Shopify, Monday, etc.) with their available triggers and `customVars`.
+- Use case: discovering which marketplace triggers a sub-account can wire into workflows.
+- `installedOnly` flag defaults to false (full catalogue).
+
+### `templates/trigger-schemas.json` reference (dev-side)
+- Full catalogue: 57 native trigger types + 85 marketplace apps + 434 marketplace trigger entries, captured from the workflow-builder JS bundle + the marketplace API.
+- Not shipped to npm consumers (excluded from `package.json` `files[]`) — kept in-repo as the source of truth for future typed-trigger work.
+
+### Coverage delta
+- Before: 4 / 57 native trigger types typed (7%).
+- After: 4 typed + 53 reachable via the permissive fallback (100% read coverage).
+
 ## 2.7.0 — Complete Type Safety (Boris Cherny A+)
 
 **171 tools across 35 modules. Bundle: 214KB.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 171 tools across 35 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.** 173 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.
 
 **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).
 
@@ -98,7 +98,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** — all 165 tools are now unlocked.
+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** — all 166 tools are now unlocked.
 
 ### 4. Try it
 
@@ -138,9 +138,19 @@ https://app.gohighlevel.com/v2/location/YOUR_LOCATION_ID/dashboard
 
 ## Enable Workflow Builder (Optional)
 
-The 6 workflow builder tools use GHL'''s internal API and require Firebase credentials. Without them, the other 165 tools work fine — you just won'''t have workflow editing.
+The 7 workflow builder tools use GHL'''s internal API and require Firebase credentials. Without them, the other 166 tools work fine — you just won'''t have workflow editing.
 
-**The easy way:** [elitedcs.com/ghl-mcp-firebase](https://elitedcs.com/ghl-mcp-firebase) — drag the bookmarklet, click it inside GHL, your three values appear automatically. Then re-run `setup_ghl_mcp` with the extra fields:
+Grab the three values from your GHL browser session, then re-run `setup_ghl_mcp` with them:
+
+1. Open `app.gohighlevel.com` in Chrome (or any Chromium browser), log in.
+2. Open DevTools (Cmd+Opt+I on Mac, F12 on Windows) → **Application** tab → **IndexedDB** in the left panel.
+3. Expand: `firebaseLocalStorageDb` → `firebaseLocalStorage`.
+4. Find the row whose key starts with `firebase:authUser:`.
+5. The part between `authUser:` and `:[DEFAULT]` is your **ghl_firebase_api_key** (starts with `AIza`).
+6. Inside that row's value object: `uid` is your **ghl_user_id**.
+7. Inside `value.stsTokenManager.refreshToken` is your **ghl_firebase_refresh_token**.
+
+Then in Claude:
 
 ```
 Re-run setup_ghl_mcp with workflow builder:
@@ -148,16 +158,16 @@ Re-run setup_ghl_mcp with workflow builder:
   license_key: YOUR_LICENSE_KEY
   ghl_api_key: YOUR_GHL_API_KEY
   ghl_location_id: YOUR_LOCATION_ID
-  ghl_user_id: FROM_FIREBASE_CAPTURE
-  ghl_firebase_api_key: FROM_FIREBASE_CAPTURE
-  ghl_firebase_refresh_token: FROM_FIREBASE_CAPTURE
+  ghl_user_id: FROM_STEP_6
+  ghl_firebase_api_key: FROM_STEP_5
+  ghl_firebase_refresh_token: FROM_STEP_7
 ```
 
-> Firebase refresh tokens can rotate. If workflow tools stop working after a few weeks, run the capture again and re-run setup_ghl_mcp with the fresh values.
+> Firebase refresh tokens can rotate. If workflow tools stop working after a few weeks, repeat steps 1–7 and re-run setup_ghl_mcp with fresh values.
 
 ---
 
-## Tools (171)
+## Tools (173)
 
 ### CRM & Contacts (15 tools)
 
@@ -322,7 +332,7 @@ Re-run setup_ghl_mcp with workflow builder:
 | `get_subscriptions` | List active subscriptions |
 | `get_transactions` | View transaction history |
 
-### Workflow Builder (6 tools) — Internal API
+### Workflow Builder (7 tools) — Internal API
 
 > **This is the flagship feature.** GHL's public API has **zero** workflow write endpoints. These tools use GHL's internal backend API — the same API their own UI calls — reverse-engineered to give Claude full workflow CRUD. No other GHL integration, Zapier connector, or third-party tool can create or edit workflows programmatically. Requires additional Firebase auth setup (see "Enable Workflow Builder" in Quick Start above).
 
@@ -334,12 +344,13 @@ Re-run setup_ghl_mcp with workflow builder:
 | `update_workflow_actions` | Add, edit, or remove actions, triggers, and branches in an existing workflow |
 | `delete_workflow_full` | Permanently delete a workflow |
 | `publish_workflow` | Publish a draft workflow to make it active |
+| `get_trigger_registry` | Discover GHL's marketplace trigger apps (Zoom, WooCommerce, Shopify, etc.) and their available trigger templates |
 
 **What you can build:** Complete automation sequences — lead nurture drip campaigns, appointment reminder sequences, onboarding flows, re-engagement workflows, internal notification chains. Tell Claude what you want and it builds the workflow action by action.
 
 **Supported action types:** `sms`, `email`, `add_contact_tag`, `remove_contact_tag`, `update_contact_field`, `wait`, `if_else`, `webhook`, `create_opportunity`, `custom_code`, `add_notes`, `internal_notification`, `task-notification`, `remove_from_workflow`, and more.
 
-**Supported trigger types:** `contact_tag`, `contact_created`, `form_submission`, `customer_reply`, `appointment`, `inbound_webhook`, `payment_received`, and more.
+**Supported trigger types:** All 57 native GHL trigger types read cleanly (form_submission, payment_received, opportunity_created/changed/status_changed, inbound_webhook, contact_tag, appointment, customer_reply, and 50 more). 4 are deeply typed; the rest pass through a permissive schema so workflows never fail to read regardless of trigger type. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
 
 ### Pipeline Builder (5 tools) — Internal API
 
@@ -399,6 +410,12 @@ Re-run setup_ghl_mcp with workflow builder:
 | `get_template_questionnaire` | Get the questionnaire for a template — present to user conversationally |
 | `deploy_template` | Deploy a complete sub-account setup from a template (tags, fields, pipelines, workflows, forms). Supports dry-run mode. |
 
+### Meta (1 tool)
+
+| Tool | What It Does |
+|---|---|
+| `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. |
+
 ### Other Modules
 
 | Module | Tools | What It Does |

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.1.0",
-      description: "GoHighLevel MCP Server for Claude. 171 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.1.1",
+      description: "GoHighLevel MCP Server for Claude. 173 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -96,7 +96,6 @@ var require_package = __commonJS({
 var dotenv2 = __toESM(require("dotenv"));
 var path5 = __toESM(require("path"));
 var fs5 = __toESM(require("fs"));
-var import_child_process = require("child_process");
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
@@ -4651,10 +4650,12 @@ function withSwitchLock(fn) {
   switchChain = next.catch(() => void 0);
   return next;
 }
-function registerLocationSwitcherTools(server2, client, builderClient, registry2) {
+function registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion) {
+  const versionLine = mcpVersion ? `
+MCP version: v${mcpVersion}` : "";
   server2.tool(
     "get_current_location",
-    "Show which GHL sub-account (location) is currently active, including API key status. All tools use this location by default unless you specify a different one.",
+    "Show which GHL sub-account (location) is currently active, including API key status and installed MCP version. All tools use this location by default unless you specify a different one.",
     {},
     async () => {
       const locId = client.defaultLocationId || "NOT SET";
@@ -4672,17 +4673,17 @@ ID: ${client.defaultLocationId}
 API Key: ${client.getApiKeyPrefix()}
 Address: ${loc?.address || "N/A"}
 Email: ${loc?.email || "N/A"}
-Token registry: ${registeredCount} location(s) registered`
+Token registry: ${registeredCount} location(s) registered${versionLine}`
               }
             ]
           };
         }
         return {
-          content: [{ type: "text", text: `No default location set. Pass locationId to tools or use switch_location.` }]
+          content: [{ type: "text", text: `No default location set. Pass locationId to tools or use switch_location.${versionLine}` }]
         };
       } catch (error) {
         return {
-          content: [{ type: "text", text: `Current location ID: ${locId} (could not fetch details \u2014 API key may not have access)` }]
+          content: [{ type: "text", text: `Current location ID: ${locId} (could not fetch details \u2014 API key may not have access)${versionLine}` }]
         };
       }
     }
@@ -5771,7 +5772,7 @@ var publicApiTools = [
   [registerAccountExportTools, "account-export"],
   [registerTemplateDeployerTools, "template-deployer"]
 ];
-function registerAllTools(server2, client, registry2) {
+function registerAllTools(server2, client, registry2, mcpVersion) {
   for (const [register] of publicApiTools) {
     register(server2, client);
   }
@@ -5781,7 +5782,7 @@ function registerAllTools(server2, client, registry2) {
   registerFormBuilderTools(server2, builderClient);
   registerPipelineBuilderTools(server2, builderClient);
   registerWorkflowClonerTools(server2, builderClient);
-  registerLocationSwitcherTools(server2, client, builderClient, registry2);
+  registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion);
 }
 
 // src/credentials-store.ts
@@ -5998,6 +5999,58 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
   );
 }
 
+// src/version-check.ts
+var REGISTRY_URL = "https://registry.npmjs.org/@elitedcs/ghl-mcp/latest";
+async function fetchLatestVersion(timeoutMs = 5e3) {
+  try {
+    const response = await fetch(REGISTRY_URL, {
+      headers: { Accept: "application/json" },
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+    if (!response.ok) return null;
+    const body = await response.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  }
+}
+async function getVersionStatus(installed) {
+  const latest = await fetchLatestVersion();
+  if (latest === null) {
+    return { installed, latest: null, upToDate: null, fetchError: "Could not reach npm registry" };
+  }
+  return { installed, latest, upToDate: installed === latest };
+}
+
+// src/tools/meta.ts
+function registerMetaTools(server2, installedVersion) {
+  server2.tool(
+    "get_mcp_version",
+    "Check the installed version of GHL Command (the GoHighLevel MCP server) against the latest version published to npm. Use this to confirm an upgrade landed after restarting Claude. Returns installed version, latest version, whether up-to-date, and the one-line restart instruction if not.",
+    {},
+    async () => {
+      const status = await getVersionStatus(installedVersion);
+      const lines = [`Installed: v${status.installed}`];
+      if (status.latest === null) {
+        lines.push(`Latest: unknown (${status.fetchError ?? "npm registry unreachable"})`);
+        lines.push(`Cannot confirm whether an update is available.`);
+      } else if (status.upToDate) {
+        lines.push(`Latest:    v${status.latest}`);
+        lines.push(`Status:    Up to date.`);
+      } else {
+        lines.push(`Latest:    v${status.latest}`);
+        lines.push(`Status:    UPDATE AVAILABLE.`);
+        lines.push(``);
+        lines.push(`To upgrade: fully quit Claude Desktop (Cmd+Q on Mac, fully exit on Windows) and reopen it.`);
+        lines.push(`The @latest tag in your config fetches the new version on next launch \u2014 no reinstall, no config edit.`);
+        lines.push(``);
+        lines.push(`If a restart doesn't pick up the new version, run this in a terminal once: npx clear-npx-cache`);
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+}
+
 // src/index.ts
 var pkg = require_package();
 dotenv2.config();
@@ -6059,17 +6112,18 @@ var server = new import_mcp.McpServer({
   version: pkg.version
 });
 var inBootstrapMode = !apiKey || !locationId;
+registerMetaTools(server, pkg.version);
 if (inBootstrapMode) {
   process.stderr.write(
     `[ghl-mcp] Bootstrap mode: no credentials found.
 [ghl-mcp] Looked for env vars (GHL_API_KEY, GHL_LOCATION_ID) and credentials file (${credentialsPath()}).
-[ghl-mcp] Only the setup_ghl_mcp tool is available. Run it from Claude with your license + GHL credentials.
+[ghl-mcp] Only setup_ghl_mcp and get_mcp_version are available. Run setup_ghl_mcp from Claude with your license + GHL credentials.
 `
   );
   registerSetupTool(server);
 } else {
   const client = new GHLClient({ apiKey, locationId });
-  registerAllTools(server, client, registry);
+  registerAllTools(server, client, registry, pkg.version);
   if (fileCreds && !process.env.GHL_API_KEY) {
     process.stderr.write(`[ghl-mcp] Loaded credentials from ${credentialsPath()}
 `);
@@ -6096,24 +6150,14 @@ async function validateApiKey() {
   } catch {
   }
 }
-function checkForUpdates() {
-  const repoDir = path5.resolve(__dirname, "..");
-  (0, import_child_process.execFile)("git", ["-C", repoDir, "fetch", "--quiet"], { timeout: 1e4 }, (fetchErr) => {
-    if (fetchErr) return;
-    (0, import_child_process.execFile)("git", ["-C", repoDir, "rev-parse", "HEAD"], (_, localOut) => {
-      (0, import_child_process.execFile)("git", ["-C", repoDir, "rev-parse", "@{u}"], (__, remoteOut) => {
-        if (!localOut || !remoteOut) return;
-        const local = localOut.toString().trim();
-        const remote = remoteOut.toString().trim();
-        if (local !== remote) {
-          process.stderr.write(
-            `[ghl-mcp] Update available! Run: cd ${repoDir} && git pull && npm run build
+async function checkForUpdates() {
+  const latest = await fetchLatestVersion();
+  if (latest && latest !== pkg.version) {
+    process.stderr.write(
+      `[ghl-mcp] Update available: v${pkg.version} \u2192 v${latest}. Fully quit Claude (Cmd+Q on Mac) and reopen to upgrade.
 `
-          );
-        }
-      });
-    });
-  });
+    );
+  }
 }
 async function main() {
   const transport = new import_stdio.StdioServerTransport();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.1.0",
-  "description": "GoHighLevel MCP Server for Claude. 171 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+  "version": "3.1.1",
+  "description": "GoHighLevel MCP Server for Claude. 173 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"