@elitedcs/ghl-mcp 3.3.0 → 3.4.0

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.3.0",
-      description: "GoHighLevel MCP Server for Claude. 173 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.4.0",
+      description: "GoHighLevel MCP Server for Claude. 175 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -41,6 +41,7 @@ var require_package = __commonJS({
         "dist/index.js",
         "templates/action-schemas.json",
         "templates/clinic-medspa.json",
+        "templates/trigger-schemas.json",
         "README.md",
         "CHANGELOG.md"
       ],
@@ -868,6 +869,19 @@ var WorkflowBuilderClient = class _WorkflowBuilderClient {
   getApiKey() {
     return this.apiKey;
   }
+  /**
+   * Probe Firebase auth by refreshing the ID token. Used by the health_check
+   * diagnostic tool. Does not touch GHL backend — just exchanges the refresh
+   * token at securetoken.googleapis.com.
+   */
+  async checkAuth() {
+    try {
+      await this.getIdToken();
+      return { ok: true };
+    } catch (error) {
+      return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+  }
   /**
    * Create from environment variables, with optional token registry fallback
    */
@@ -5930,6 +5944,460 @@ ${errors.join("\n")}` : "\nNo errors!",
   );
 }
 
+// src/tools/validators.ts
+var import_zod40 = require("zod");
+function extractFromTrigger(trigger, refs) {
+  const triggerName = String(trigger.name ?? trigger.type ?? "unnamed trigger");
+  const where = `trigger "${triggerName}"`;
+  const conditions = Array.isArray(trigger.conditions) ? trigger.conditions : [];
+  for (let i = 0; i < conditions.length; i++) {
+    const c = conditions[i];
+    const field = typeof c.field === "string" ? c.field : null;
+    const value = c.value;
+    if (!field || value === void 0 || value === null) continue;
+    const valueAsArray = Array.isArray(value) ? value : [value];
+    for (const v of valueAsArray) {
+      if (typeof v !== "string") continue;
+      const childWhere = `${where} \u2192 conditions[${i}] (field=${field})`;
+      switch (field) {
+        case "opportunity.pipelineId":
+          refs.push({ kind: "pipeline", id: v, where: childWhere });
+          break;
+        case "opportunity.pipelineStageId":
+          refs.push({ kind: "stage", id: v, where: childWhere });
+          break;
+        case "opportunity.assignedTo":
+        case "contact.assignedTo":
+          refs.push({ kind: "user", id: v, where: childWhere });
+          break;
+        case "workflow.id":
+          refs.push({ kind: "workflow", id: v, where: childWhere });
+          break;
+        case "form.id":
+          refs.push({ kind: "form", id: v, where: childWhere });
+          break;
+        case "calendar.id":
+          refs.push({ kind: "calendar", id: v, where: childWhere });
+          break;
+        case "survey.id":
+          refs.push({ kind: "survey", id: v, where: childWhere });
+          break;
+      }
+    }
+  }
+  const triggerActions = Array.isArray(trigger.actions) ? trigger.actions : [];
+  for (let i = 0; i < triggerActions.length; i++) {
+    const a = triggerActions[i];
+    if (a.type === "add_to_workflow" && typeof a.workflow_id === "string") {
+      refs.push({
+        kind: "workflow",
+        id: a.workflow_id,
+        where: `${where} \u2192 actions[${i}] (add_to_workflow)`
+      });
+    }
+  }
+}
+function extractFromAction(action, refs) {
+  const type = typeof action.type === "string" ? action.type : "unknown";
+  const name = typeof action.name === "string" ? action.name : "unnamed action";
+  const where = `action "${name}" (${type})`;
+  const attr = action.attributes ?? {};
+  switch (type) {
+    case "update_contact_field": {
+      const fields = Array.isArray(attr.fields) ? attr.fields : [];
+      for (let i = 0; i < fields.length; i++) {
+        const f = fields[i];
+        if (typeof f.field === "string") {
+          refs.push({
+            kind: "custom_field",
+            id: f.field,
+            where: `${where} \u2192 fields[${i}]`
+          });
+        }
+      }
+      break;
+    }
+    case "internal_notification": {
+      const notif = attr.notification ?? {};
+      if (typeof notif.selectedUser === "string" && notif.selectedUser.trim() !== "") {
+        refs.push({
+          kind: "user",
+          id: notif.selectedUser,
+          where: `${where} \u2192 notification.selectedUser`
+        });
+      }
+      break;
+    }
+    case "task_notification": {
+      if (typeof attr.assignedTo === "string" && attr.assignedTo.trim() !== "") {
+        refs.push({
+          kind: "user",
+          id: attr.assignedTo,
+          where: `${where} \u2192 assignedTo`
+        });
+      }
+      break;
+    }
+    case "remove_from_workflow": {
+      if (typeof attr.workflowId === "string") {
+        refs.push({
+          kind: "workflow",
+          id: attr.workflowId,
+          where: `${where} \u2192 workflowId`
+        });
+      }
+      const workflowIdArr = Array.isArray(attr.workflow_id) ? attr.workflow_id : [];
+      for (let i = 0; i < workflowIdArr.length; i++) {
+        const v = workflowIdArr[i];
+        if (typeof v === "string") {
+          refs.push({
+            kind: "workflow",
+            id: v,
+            where: `${where} \u2192 workflow_id[${i}]`
+          });
+        }
+      }
+      break;
+    }
+    case "internal_update_opportunity": {
+      const customInputs = Array.isArray(attr.__customInputFields__) ? attr.__customInputFields__ : [];
+      for (let i = 0; i < customInputs.length; i++) {
+        const c = customInputs[i];
+        if (typeof c.value !== "string") continue;
+        if (c.filterField === "pipelineId") {
+          refs.push({ kind: "pipeline", id: c.value, where: `${where} \u2192 __customInputFields__[${i}].pipelineId` });
+        } else if (c.filterField === "pipelineStageId") {
+          refs.push({ kind: "stage", id: c.value, where: `${where} \u2192 __customInputFields__[${i}].pipelineStageId` });
+        }
+      }
+      break;
+    }
+  }
+}
+function registerValidatorTools(server2, client, builderClient) {
+  if (!builderClient) return;
+  server2.tool(
+    "validate_workflow",
+    "Pre-flight ID validation for a deployed GHL workflow. Scans every trigger and action for references to pipelines, pipeline stages, custom fields, users, workflows, forms, calendars, and surveys; verifies each ID exists in the current location. Use this BEFORE publish_workflow when a workflow has been edited, or whenever a published workflow stops behaving as expected. Catches the silent-failure bug where invalid IDs make GHL skip all subsequent actions without warning. Returns a structured report of valid + missing references.",
+    {
+      workflowId: import_zod40.z.string().describe("The workflow ID to validate.")
+    },
+    async ({ workflowId }) => {
+      try {
+        let collectIds2 = function(envelope, listKey) {
+          const ids = /* @__PURE__ */ new Set();
+          if (envelope && typeof envelope === "object") {
+            const e = envelope;
+            const arr = Array.isArray(e[listKey]) ? e[listKey] : Array.isArray(envelope) ? envelope : [];
+            for (const item of arr) {
+              if (typeof item === "object" && item !== null) {
+                const o = item;
+                const id = typeof o.id === "string" ? o.id : typeof o._id === "string" ? o._id : null;
+                if (id) ids.add(id);
+              }
+            }
+          }
+          return ids;
+        };
+        var collectIds = collectIds2;
+        const workflow = await builderClient.getWorkflow(workflowId);
+        if (!workflow) return errorResponse(new Error(`Workflow ${workflowId} not found`));
+        const refs = [];
+        const triggers = Array.isArray(workflow.triggers) ? workflow.triggers : [];
+        for (const t of triggers) {
+          extractFromTrigger(t, refs);
+        }
+        const actions = workflow.workflowData?.templates ?? [];
+        for (const a of actions) {
+          extractFromAction(a, refs);
+        }
+        if (refs.length === 0) {
+          const empty = {
+            workflowId,
+            workflowName: workflow.name,
+            status: "ok",
+            references_scanned: 0,
+            issues_count: 0,
+            findings: []
+          };
+          return jsonResponse(empty);
+        }
+        const refCategories = new Set(refs.map((r) => r.kind));
+        const locationId2 = client.defaultLocationId;
+        const fetches = {};
+        if (refCategories.has("pipeline") || refCategories.has("stage")) {
+          fetches.pipelines = client.get("/opportunities/pipelines", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("custom_field")) {
+          fetches.customFields = client.get(`/locations/${locationId2}/customFields`);
+        }
+        if (refCategories.has("user")) {
+          fetches.users = client.get("/users/", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("workflow")) {
+          fetches.workflows = builderClient.listWorkflowsFull();
+        }
+        if (refCategories.has("form")) {
+          fetches.forms = client.get("/forms/", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("calendar")) {
+          fetches.calendars = client.get("/calendars/", { params: { locationId: locationId2 } });
+        }
+        if (refCategories.has("survey")) {
+          fetches.surveys = client.get("/surveys/", { params: { locationId: locationId2 } });
+        }
+        const results = await Promise.allSettled(Object.values(fetches));
+        const keys = Object.keys(fetches);
+        const data = {};
+        for (let i = 0; i < keys.length; i++) {
+          const r = results[i];
+          data[keys[i]] = r.status === "fulfilled" ? r.value : null;
+        }
+        const validPipelineIds = /* @__PURE__ */ new Set();
+        const validStageIds = /* @__PURE__ */ new Set();
+        const stageToPipeline = /* @__PURE__ */ new Map();
+        if (data.pipelines) {
+          try {
+            const parsed = PipelinesResponseSchema.parse(data.pipelines);
+            for (const p of parsed.pipelines) {
+              validPipelineIds.add(p.id);
+              for (const s of p.stages) {
+                validStageIds.add(s.id);
+                stageToPipeline.set(s.id, p.id);
+              }
+            }
+          } catch {
+          }
+        }
+        const validCustomFieldIds = /* @__PURE__ */ new Set();
+        if (data.customFields && typeof data.customFields === "object") {
+          const cf = data.customFields;
+          const arr = Array.isArray(cf.customFields) ? cf.customFields : Array.isArray(cf) ? cf : [];
+          for (const f of arr) {
+            if (typeof f === "object" && f !== null && typeof f.id === "string") {
+              validCustomFieldIds.add(f.id);
+            }
+          }
+        }
+        const validUserIds = /* @__PURE__ */ new Set();
+        if (data.users && typeof data.users === "object") {
+          const u = data.users;
+          const arr = Array.isArray(u.users) ? u.users : Array.isArray(u) ? u : [];
+          for (const user of arr) {
+            if (typeof user === "object" && user !== null && typeof user.id === "string") {
+              validUserIds.add(user.id);
+            }
+          }
+        }
+        const validWorkflowIds = /* @__PURE__ */ new Set();
+        if (data.workflows && typeof data.workflows === "object") {
+          const w = data.workflows;
+          const arr = Array.isArray(w.rows) ? w.rows : Array.isArray(w.workflows) ? w.workflows : Array.isArray(w) ? w : [];
+          for (const wf of arr) {
+            if (typeof wf === "object" && wf !== null) {
+              const o = wf;
+              const id = typeof o._id === "string" ? o._id : typeof o.id === "string" ? o.id : null;
+              if (id) validWorkflowIds.add(id);
+            }
+          }
+        }
+        const validFormIds = collectIds2(data.forms, "forms");
+        const validCalendarIds = collectIds2(data.calendars, "calendars");
+        const validSurveyIds = collectIds2(data.surveys, "surveys");
+        const findings = [];
+        for (const ref of refs) {
+          let valid = false;
+          let extraMsg = "";
+          switch (ref.kind) {
+            case "pipeline":
+              valid = validPipelineIds.has(ref.id);
+              break;
+            case "stage":
+              valid = validStageIds.has(ref.id);
+              break;
+            case "custom_field":
+              valid = validCustomFieldIds.has(ref.id);
+              break;
+            case "user":
+              valid = validUserIds.has(ref.id);
+              break;
+            case "workflow":
+              valid = validWorkflowIds.has(ref.id);
+              if (valid && ref.id === workflowId) {
+                extraMsg = " (self-reference)";
+              }
+              break;
+            case "form":
+              valid = validFormIds.has(ref.id);
+              break;
+            case "calendar":
+              valid = validCalendarIds.has(ref.id);
+              break;
+            case "survey":
+              valid = validSurveyIds.has(ref.id);
+              break;
+          }
+          if (!valid) {
+            findings.push({
+              severity: "error",
+              category: ref.kind,
+              id: ref.id,
+              where: ref.where,
+              message: `${ref.kind} id "${ref.id}" does not exist in this location \u2014 GHL will silently skip this action and all subsequent actions when the workflow runs.`
+            });
+          } else if (extraMsg) {
+            findings.push({
+              severity: "warning",
+              category: ref.kind,
+              id: ref.id,
+              where: ref.where,
+              message: `${ref.kind} id "${ref.id}" is valid${extraMsg}.`
+            });
+          }
+        }
+        const report = {
+          workflowId,
+          workflowName: workflow.name,
+          status: findings.some((f) => f.severity === "error") ? "issues_found" : "ok",
+          references_scanned: refs.length,
+          issues_count: findings.filter((f) => f.severity === "error").length,
+          findings
+        };
+        return jsonResponse(report);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+}
+
+// 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/diagnostics.ts
+function registerDiagnosticTools(server2, installedVersion, client, builderClient, registry2) {
+  server2.tool(
+    "health_check",
+    "Run a full health check of the GHL Command MCP install. Reports on: npm registry + version status, GHL API key validity, default location reachability, Firebase auth status (workflow builder), and token registry. Returns a structured pass/fail/warn list with detail per check. Use this when something feels broken or after credentials change.",
+    {},
+    async () => {
+      const checks = [];
+      const versionPromise = getVersionStatus(installedVersion);
+      const apiKeyPromise = (async () => {
+        try {
+          const response = await fetch("https://services.leadconnectorhq.com/locations/search", {
+            method: "GET",
+            headers: {
+              Authorization: `Bearer ${client.getApiKey()}`,
+              "Content-Type": "application/json",
+              Accept: "application/json",
+              Version: "2021-07-28"
+            },
+            signal: AbortSignal.timeout(8e3)
+          });
+          if (response.status === 401) {
+            return { name: "GHL API key", status: "fail", detail: `401 Unauthorized \u2014 key ${client.getApiKeyPrefix()} is invalid or revoked. Run setup_ghl_mcp with a fresh key.` };
+          }
+          if (!response.ok) {
+            return { name: "GHL API key", status: "warn", detail: `HTTP ${response.status} from /locations/search \u2014 key may be limited or GHL is having issues.` };
+          }
+          return { name: "GHL API key", status: "pass", detail: `Valid (key ${client.getApiKeyPrefix()}).` };
+        } catch (error) {
+          return { name: "GHL API key", status: "warn", detail: `Network error: ${error instanceof Error ? error.message : String(error)}. Server starts anyway; tool calls will report errors when invoked.` };
+        }
+      })();
+      const locationPromise = (async () => {
+        const locId = client.defaultLocationId;
+        if (!locId) {
+          return { name: "Default location", status: "warn", detail: "No default location set. Tools that don't accept locationId arg will fail." };
+        }
+        try {
+          const result = await client.get(`/locations/${locId}`);
+          const loc = result.location ?? result;
+          return { name: "Default location", status: "pass", detail: `${loc?.name ?? "Unknown"} (${locId}) reachable.` };
+        } catch (error) {
+          return { name: "Default location", status: "fail", detail: `Could not read location ${locId}: ${error instanceof Error ? error.message : String(error)}` };
+        }
+      })();
+      const firebasePromise = (async () => {
+        if (!builderClient) {
+          return { name: "Firebase auth (workflow builder)", status: "skip", detail: "Not configured. Workflow builder tools (8 of 174) require ghl_user_id, ghl_firebase_api_key, ghl_firebase_refresh_token. Other 166 tools work fine without." };
+        }
+        const result = await builderClient.checkAuth();
+        if (result.ok) {
+          return { name: "Firebase auth (workflow builder)", status: "pass", detail: "ID token refresh succeeded. Workflow builder tools are usable." };
+        }
+        return { name: "Firebase auth (workflow builder)", status: "fail", detail: `Token refresh failed: ${result.error}. Re-capture Firebase values from GHL DevTools and re-run setup_ghl_mcp.` };
+      })();
+      const registryCheck = (() => {
+        if (!registry2) {
+          return { name: "Token registry", status: "skip", detail: "Not initialized \u2014 using env-var credentials only. switch_location won't auto-swap keys between sub-accounts." };
+        }
+        const locs = registry2.listLocations();
+        if (locs.length === 0) {
+          return { name: "Token registry", status: "warn", detail: "Initialized but empty \u2014 register sub-accounts via register_location for cross-account switching." };
+        }
+        return { name: "Token registry", status: "pass", detail: `${locs.length} sub-account(s) registered.` };
+      })();
+      const [versionStatus, apiKeyCheck, locationCheck, firebaseCheck] = await Promise.all([
+        versionPromise,
+        apiKeyPromise,
+        locationPromise,
+        firebasePromise
+      ]);
+      let versionCheck;
+      if (versionStatus.latest === null) {
+        versionCheck = { name: "npm registry + version", status: "warn", detail: `Installed v${versionStatus.installed}. Could not reach npm registry to check for updates: ${versionStatus.fetchError ?? "unknown"}.` };
+      } else if (versionStatus.upToDate) {
+        versionCheck = { name: "npm registry + version", status: "pass", detail: `Up to date at v${versionStatus.installed}.` };
+      } else {
+        versionCheck = { name: "npm registry + version", status: "warn", detail: `Installed v${versionStatus.installed} but latest is v${versionStatus.latest}. Quit Claude (Cmd+Q) and reopen to upgrade.` };
+      }
+      checks.push(versionCheck, apiKeyCheck, locationCheck, firebaseCheck, registryCheck);
+      const symbols = { pass: "\u2713", fail: "\u2717", warn: "!", skip: "\u2014" };
+      const lines = [];
+      lines.push("GHL Command \u2014 Health Check");
+      lines.push("\u2501".repeat(50));
+      for (const c of checks) {
+        lines.push(`${symbols[c.status]} ${c.name.padEnd(35)} ${c.status.toUpperCase()}`);
+        lines.push(`  ${c.detail}`);
+      }
+      lines.push("\u2501".repeat(50));
+      const fails = checks.filter((c) => c.status === "fail").length;
+      const warns = checks.filter((c) => c.status === "warn").length;
+      if (fails === 0 && warns === 0) {
+        lines.push("All systems go.");
+      } else {
+        const parts = [];
+        if (fails > 0) parts.push(`${fails} failure(s)`);
+        if (warns > 0) parts.push(`${warns} warning(s)`);
+        lines.push(parts.join(", ") + " \u2014 see details above.");
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+}
+
 // src/tools/index.ts
 var publicApiTools = [
   [registerContactTools, "contacts"],
@@ -5972,6 +6440,8 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
   registerFormBuilderTools(server2, builderClient);
   registerPipelineBuilderTools(server2, builderClient);
   registerWorkflowClonerTools(server2, builderClient);
+  registerValidatorTools(server2, client, builderClient);
+  registerDiagnosticTools(server2, mcpVersion ?? "unknown", client, builderClient, registry2 ?? null);
   registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion);
 }
 
@@ -5979,18 +6449,18 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var os = __toESM(require("os"));
-var import_zod40 = require("zod");
+var import_zod41 = require("zod");
 var APP_NAME = "elitedcs-ghl-mcp";
-var CredentialsSchema = import_zod40.z.object({
-  license_key: import_zod40.z.string().min(1),
-  email: import_zod40.z.string().email(),
-  verified_at: import_zod40.z.string().min(1),
-  ghl_api_key: import_zod40.z.string().min(1),
-  ghl_location_id: import_zod40.z.string().min(1),
-  ghl_company_id: import_zod40.z.string().optional(),
-  ghl_user_id: import_zod40.z.string().optional(),
-  ghl_firebase_api_key: import_zod40.z.string().optional(),
-  ghl_firebase_refresh_token: import_zod40.z.string().optional()
+var CredentialsSchema = import_zod41.z.object({
+  license_key: import_zod41.z.string().min(1),
+  email: import_zod41.z.string().email(),
+  verified_at: import_zod41.z.string().min(1),
+  ghl_api_key: import_zod41.z.string().min(1),
+  ghl_location_id: import_zod41.z.string().min(1),
+  ghl_company_id: import_zod41.z.string().optional(),
+  ghl_user_id: import_zod41.z.string().optional(),
+  ghl_firebase_api_key: import_zod41.z.string().optional(),
+  ghl_firebase_refresh_token: import_zod41.z.string().optional()
 });
 function appDataDir() {
   const home = os.homedir();
@@ -6040,7 +6510,7 @@ function writeCredentials(creds) {
 // src/setup-tool.ts
 var os2 = __toESM(require("os"));
 var crypto3 = __toESM(require("crypto"));
-var import_zod41 = require("zod");
+var import_zod42 = require("zod");
 var LICENSE_API = "https://elitedcs.com/api/validate-license";
 var GHL_API = "https://services.leadconnectorhq.com";
 var FIREBASE_TOKEN_API = "https://securetoken.googleapis.com/v1/token";
@@ -6109,16 +6579,16 @@ async function validateFirebase(firebaseKey, refreshToken) {
 function registerSetupTool(server2) {
   server2.tool(
     "setup_ghl_mcp",
-    "First-run setup for GHL Command MCP. Validates your license and GHL credentials, then writes them to a per-user credentials file. Restart Claude after this completes to load all 171 tools.",
+    "First-run setup for GHL Command MCP. Validates your license and GHL credentials, then writes them to a per-user credentials file. Restart Claude after this completes to load all 175 tools.",
     {
-      email: import_zod41.z.string().email().describe("Email used at purchase."),
-      license_key: import_zod41.z.string().min(20).describe("License key from your purchase email."),
-      ghl_api_key: import_zod41.z.string().min(10).describe("GHL Private Integration key (starts with 'pit-'). Created INSIDE the sub-account at Settings > Integrations > Private Integrations."),
-      ghl_location_id: import_zod41.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
-      ghl_company_id: import_zod41.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
-      ghl_user_id: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
-      ghl_firebase_api_key: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
-      ghl_firebase_refresh_token: import_zod41.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
+      email: import_zod42.z.string().email().describe("Email used at purchase."),
+      license_key: import_zod42.z.string().min(20).describe("License key from your purchase email."),
+      ghl_api_key: import_zod42.z.string().min(10).describe("GHL Private Integration key (starts with 'pit-'). Created INSIDE the sub-account at Settings > Integrations > Private Integrations."),
+      ghl_location_id: import_zod42.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
+      ghl_company_id: import_zod42.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
+      ghl_user_id: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
+      ghl_firebase_api_key: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
+      ghl_firebase_refresh_token: import_zod42.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
     },
     async (args) => {
       const lic = await validateLicense(args.email, args.license_key);
@@ -6164,7 +6634,7 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
         ghl_firebase_api_key: workflowBuilderEnabled ? args.ghl_firebase_api_key?.trim() : void 0,
         ghl_firebase_refresh_token: workflowBuilderEnabled ? args.ghl_firebase_refresh_token?.trim() : void 0
       });
-      const toolCount = workflowBuilderEnabled ? "171" : "165";
+      const toolCount = workflowBuilderEnabled ? "175" : "167";
       const wfLine = workflowBuilderEnabled ? "Workflow Builder: enabled." : "Workflow Builder: not configured (optional).";
       return {
         content: [{
@@ -6189,29 +6659,6 @@ 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(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.3.0",
-  "description": "GoHighLevel MCP Server for Claude. 173 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+  "version": "3.4.0",
+  "description": "GoHighLevel MCP Server for Claude. 175 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
   "main": "dist/index.js",
   "bin": {
     "ghl-mcp": "dist/index.js"
@@ -10,6 +10,7 @@
     "dist/index.js",
     "templates/action-schemas.json",
     "templates/clinic-medspa.json",
+    "templates/trigger-schemas.json",
     "README.md",
     "CHANGELOG.md"
   ],