@elitedcs/ghl-mcp 3.11.0 → 3.11.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 3.11.1 — Reputation: review-link list (partial gap-closure round 4)
+
+**197 tools across 41 modules. Bundle: ~315 KB.**
+
+Partial close on the reputation gap. One verified tool shipped; the bigger reviews surface needs a DevTools capture against a live account.
+
+### New tool (Firebase-gated)
+
+- **`get_review_link_list`** — lists the review-link destinations (Google, Facebook, etc.) configured for a location. Each entry has a label + the public review URL. Useful for building review-request workflows: the workflow goal condition `review_request_clicked` (shipped in v3.8.0) references these review-link ids.
+
+Endpoint: `GET backend.leadconnectorhq.com/reputation/integrations/review-link-list?locationId=X` via Firebase auth. Verified 2026-05-22.
+
+### What's NOT shipped + why
+
+The core reputation surface — listing the reviews that come BACK from Google/Facebook, responding to them, review-request campaigns — sits behind `/reputation/reviews`. That endpoint returns `401 "Unauthorized Access: undefined - No Location Found"` regardless of:
+- bearer (PIT) vs Firebase auth
+- which location header/param is sent (`location-id`, `locationid`, `location`, query param, path segment)
+
+The `undefined` in the error means the endpoint reads a location field from the request that comes back empty — the GHL reputation UI sends something specific that black-box probing can't reproduce. **This needs a DevTools capture** of the exact request the reputation UI makes, against a live account that has connected review platforms (MCP Testing has none, so there'd be nothing to verify against anyway).
+
+Documented as capture-pending in the tool's own description so the LLM gives buyers an honest answer.
+
+### Tool count impact
+
+- Total: 196 → 197 (+1)
+- Firebase-gated (the new tool uses internal-API auth)
+- Modules: 40 → 41 (new reputation module)
+
+### Files changed
+
+- `src/tools/reputation.ts` — NEW
+- `src/tools/index.ts` — registered `registerReputationTools`
+- `src/setup-tool.ts` — Firebase-mode count 196 → 197
+
 ## 3.11.0 — Smart Lists CRUD (gap-closure round 3)
 
 **196 tools across 40 modules. Bundle: 315.1 KB.**

package/README.md

@@ -1,6 +1,6 @@
 # GHL Command — GoHighLevel MCP Server
 
-**Full GoHighLevel API access for Claude.** 196 tools across 40 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.** 197 tools across 41 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).
 

package/dist/index.js

@@ -31,8 +31,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.11.0",
-      description: "GoHighLevel MCP Server for Claude. 196 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
+      version: "3.11.1",
+      description: "GoHighLevel MCP Server for Claude. 197 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -6153,42 +6153,78 @@ ${text2}`);
   );
 }
 
-// src/tools/template-deployer.ts
+// src/tools/reputation.ts
 var import_zod41 = require("zod");
+var REPUTATION_BASE = "https://backend.leadconnectorhq.com/reputation";
+function registerReputationTools(server2, builderClient) {
+  const client = builderClient;
+  if (!client) return;
+  async function reputationRequest(method, path6) {
+    const headers = await client.buildHeaders();
+    const response = await fetch(`${REPUTATION_BASE}${path6}`, { method, headers });
+    if (!response.ok) {
+      const text2 = await response.text();
+      throw new Error(`Reputation API Error ${response.status}: ${method} ${path6}
+${text2}`);
+    }
+    const text = await response.text();
+    if (!text) return {};
+    return JSON.parse(text);
+  }
+  server2.tool(
+    "get_review_link_list",
+    "List the review-link destinations configured for a location \u2014 the platforms (Google, Facebook, etc.) where review requests send contacts. Each entry has a label and the public review URL. Useful for: building review-request workflows (the workflow goal condition `review_request_clicked` references these review-link ids), and auditing which review platforms a sub-account has connected. NOTE: listing the actual reviews that come BACK (and responding to them) is not yet available \u2014 that endpoint needs a DevTools capture against a live account with connected review platforms.",
+    {
+      locationId: import_zod41.z.string().optional().describe("Location ID. Falls back to the active builder client's location.")
+    },
+    async ({ locationId: locationId2 }) => {
+      try {
+        const loc = locationId2 ?? client.locationId;
+        const result = await reputationRequest("GET", `/integrations/review-link-list?locationId=${loc}`);
+        return jsonResponse(result);
+      } catch (error) {
+        return errorResponse(error);
+      }
+    }
+  );
+}
+
+// src/tools/template-deployer.ts
+var import_zod42 = require("zod");
 var fs3 = __toESM(require("fs"));
 var path3 = __toESM(require("path"));
 function delay3(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
-var TemplateSchema = import_zod41.z.object({
-  templateName: import_zod41.z.string(),
-  templateVersion: import_zod41.z.string().optional(),
-  description: import_zod41.z.string().optional().default(""),
-  questionnaire: import_zod41.z.array(import_zod41.z.object({
-    id: import_zod41.z.string(),
-    question: import_zod41.z.string(),
-    type: import_zod41.z.string(),
-    required: import_zod41.z.boolean().optional(),
-    placeholder: import_zod41.z.string().optional()
+var TemplateSchema = import_zod42.z.object({
+  templateName: import_zod42.z.string(),
+  templateVersion: import_zod42.z.string().optional(),
+  description: import_zod42.z.string().optional().default(""),
+  questionnaire: import_zod42.z.array(import_zod42.z.object({
+    id: import_zod42.z.string(),
+    question: import_zod42.z.string(),
+    type: import_zod42.z.string(),
+    required: import_zod42.z.boolean().optional(),
+    placeholder: import_zod42.z.string().optional()
   })).optional().default([]),
-  location: import_zod41.z.record(import_zod41.z.unknown()).optional(),
-  tags: import_zod41.z.array(import_zod41.z.string()).optional(),
-  customFields: import_zod41.z.array(import_zod41.z.object({
-    name: import_zod41.z.string(),
-    dataType: import_zod41.z.string()
+  location: import_zod42.z.record(import_zod42.z.unknown()).optional(),
+  tags: import_zod42.z.array(import_zod42.z.string()).optional(),
+  customFields: import_zod42.z.array(import_zod42.z.object({
+    name: import_zod42.z.string(),
+    dataType: import_zod42.z.string()
   })).optional(),
-  pipelines: import_zod41.z.array(import_zod41.z.object({
-    name: import_zod41.z.string(),
-    stages: import_zod41.z.array(import_zod41.z.object({ position: import_zod41.z.number(), name: import_zod41.z.string() }))
+  pipelines: import_zod42.z.array(import_zod42.z.object({
+    name: import_zod42.z.string(),
+    stages: import_zod42.z.array(import_zod42.z.object({ position: import_zod42.z.number(), name: import_zod42.z.string() }))
   })).optional(),
-  workflows: import_zod41.z.array(import_zod41.z.object({
-    name: import_zod41.z.string(),
-    condition: import_zod41.z.string().optional(),
-    actions: import_zod41.z.array(import_zod41.z.record(import_zod41.z.unknown())).optional().default([])
+  workflows: import_zod42.z.array(import_zod42.z.object({
+    name: import_zod42.z.string(),
+    condition: import_zod42.z.string().optional(),
+    actions: import_zod42.z.array(import_zod42.z.record(import_zod42.z.unknown())).optional().default([])
   })).optional(),
-  calendars: import_zod41.z.array(import_zod41.z.object({
-    name: import_zod41.z.string(),
-    description: import_zod41.z.string().optional()
+  calendars: import_zod42.z.array(import_zod42.z.object({
+    name: import_zod42.z.string(),
+    description: import_zod42.z.string().optional()
   })).optional()
 });
 function registerTemplateDeployerTools(server2, client) {
@@ -6259,7 +6295,7 @@ function registerTemplateDeployerTools(server2, client) {
     "get_template_questionnaire",
     "Get the questionnaire for a specific template. Returns all the questions that need to be answered before deploying. Present these to the user one at a time in a conversational style.",
     {
-      templateFile: import_zod41.z.string().describe("Path to the template JSON file (from list_templates).")
+      templateFile: import_zod42.z.string().describe("Path to the template JSON file (from list_templates).")
     },
     async ({ templateFile }) => {
       try {
@@ -6292,10 +6328,10 @@ function registerTemplateDeployerTools(server2, client) {
     "deploy_template",
     "Deploy a template to set up a GHL sub-account. Creates tags, custom fields, pipelines with stages, calendars, workflows, and forms based on the template and the user's questionnaire answers. This is the main setup automation tool.",
     {
-      templateFile: import_zod41.z.string().describe("Path to the template JSON file."),
-      answers: import_zod41.z.record(import_zod41.z.unknown()).describe("Questionnaire answers keyed by question ID (e.g. {business_name: 'My Clinic', business_phone: '+15551234567', ...})."),
-      locationId: import_zod41.z.string().optional().describe("Location ID to deploy to. Uses default if not specified."),
-      dryRun: import_zod41.z.boolean().optional().describe("If true, shows what would be created without actually creating anything. Defaults to false.")
+      templateFile: import_zod42.z.string().describe("Path to the template JSON file."),
+      answers: import_zod42.z.record(import_zod42.z.unknown()).describe("Questionnaire answers keyed by question ID (e.g. {business_name: 'My Clinic', business_phone: '+15551234567', ...})."),
+      locationId: import_zod42.z.string().optional().describe("Location ID to deploy to. Uses default if not specified."),
+      dryRun: import_zod42.z.boolean().optional().describe("If true, shows what would be created without actually creating anything. Defaults to false.")
     },
     async ({ templateFile, answers, locationId: locationId2, dryRun }) => {
       try {
@@ -6541,7 +6577,7 @@ ${errors.join("\n")}` : "\nNo errors!",
 }
 
 // src/tools/validators.ts
-var import_zod42 = require("zod");
+var import_zod43 = require("zod");
 function extractFromTrigger(trigger, refs) {
   const triggerName = String(trigger.name ?? trigger.type ?? "unnamed trigger");
   const where = `trigger "${triggerName}"`;
@@ -6676,7 +6712,7 @@ function registerValidatorTools(server2, client, builderClient) {
     "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_zod42.z.string().describe("The workflow ID to validate.")
+      workflowId: import_zod43.z.string().describe("The workflow ID to validate.")
     },
     async ({ workflowId }) => {
       try {
@@ -7045,6 +7081,7 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
   registerPipelineBuilderTools(server2, builderClient);
   registerWorkflowClonerTools(server2, builderClient);
   registerSmartListTools(server2, builderClient);
+  registerReputationTools(server2, builderClient);
   registerValidatorTools(server2, client, builderClient);
   registerDiagnosticTools(server2, mcpVersion ?? "unknown", client, builderClient, registry2 ?? null);
   registerLocationSwitcherTools(server2, client, builderClient, registry2, mcpVersion);
@@ -7054,18 +7091,18 @@ function registerAllTools(server2, client, registry2, mcpVersion) {
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var os = __toESM(require("os"));
-var import_zod43 = require("zod");
+var import_zod44 = require("zod");
 var APP_NAME = "elitedcs-ghl-mcp";
-var CredentialsSchema = import_zod43.z.object({
-  license_key: import_zod43.z.string().min(1),
-  email: import_zod43.z.string().email(),
-  verified_at: import_zod43.z.string().min(1),
-  ghl_api_key: import_zod43.z.string().min(1),
-  ghl_location_id: import_zod43.z.string().min(1),
-  ghl_company_id: import_zod43.z.string().optional(),
-  ghl_user_id: import_zod43.z.string().optional(),
-  ghl_firebase_api_key: import_zod43.z.string().optional(),
-  ghl_firebase_refresh_token: import_zod43.z.string().optional()
+var CredentialsSchema = import_zod44.z.object({
+  license_key: import_zod44.z.string().min(1),
+  email: import_zod44.z.string().email(),
+  verified_at: import_zod44.z.string().min(1),
+  ghl_api_key: import_zod44.z.string().min(1),
+  ghl_location_id: import_zod44.z.string().min(1),
+  ghl_company_id: import_zod44.z.string().optional(),
+  ghl_user_id: import_zod44.z.string().optional(),
+  ghl_firebase_api_key: import_zod44.z.string().optional(),
+  ghl_firebase_refresh_token: import_zod44.z.string().optional()
 });
 function appDataDir() {
   const home = os.homedir();
@@ -7115,7 +7152,7 @@ function writeCredentials(creds) {
 // src/setup-tool.ts
 var os2 = __toESM(require("os"));
 var crypto3 = __toESM(require("crypto"));
-var import_zod44 = require("zod");
+var import_zod45 = 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";
@@ -7184,16 +7221,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 196 tools (161 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
+    "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 197 tools (161 if you skip the optional Firebase fields; add Firebase later with enable_workflow_builder).",
     {
-      email: import_zod44.z.string().email().describe("Email used at purchase."),
-      license_key: import_zod44.z.string().min(20).describe("License key from your purchase email."),
-      ghl_api_key: import_zod44.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_zod44.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
-      ghl_company_id: import_zod44.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
-      ghl_user_id: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
-      ghl_firebase_api_key: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
-      ghl_firebase_refresh_token: import_zod44.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
+      email: import_zod45.z.string().email().describe("Email used at purchase."),
+      license_key: import_zod45.z.string().min(20).describe("License key from your purchase email."),
+      ghl_api_key: import_zod45.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_zod45.z.string().min(10).describe("GHL Location ID (sub-account ID). Found in your GHL URL: /location/THIS_PART/dashboard."),
+      ghl_company_id: import_zod45.z.string().optional().describe("(Agency only) Company ID for multi-location access."),
+      ghl_user_id: import_zod45.z.string().optional().describe("(Workflow Builder, optional) Firebase User ID. See README for browser capture instructions."),
+      ghl_firebase_api_key: import_zod45.z.string().optional().describe("(Workflow Builder, optional) Firebase API Key starting with 'AIza'."),
+      ghl_firebase_refresh_token: import_zod45.z.string().optional().describe("(Workflow Builder, optional) Firebase refresh token starting with 'AMf-'.")
     },
     async (args) => {
       const lic = await validateLicense(args.email, args.license_key);
@@ -7239,7 +7276,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 ? "196" : "161";
+      const toolCount = workflowBuilderEnabled ? "197" : "161";
       const wfLine = workflowBuilderEnabled ? "Workflow Builder: enabled." : "Workflow Builder: not configured (optional).";
       const wfTip = workflowBuilderEnabled ? "" : "\nTo enable Workflow Builder later (8 extra tools): run enable_workflow_builder with your three Firebase values. No need to re-enter license/API key/location ID.";
       return {
@@ -7267,11 +7304,11 @@ Note: Firebase credentials rejected (${fb.error}). Saved without Workflow Builde
 function registerEnableWorkflowBuilderTool(server2) {
   server2.tool(
     "enable_workflow_builder",
-    "Add Firebase credentials to an existing GHL Command install to unlock 30 additional tools across 6 modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder (10 tools), form builder (5 tools), pipeline builder (5 tools), and workflow cloning. Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 161 to 196 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 30 additional tools across 6 modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder (10 tools), form builder (5 tools), pipeline builder (5 tools), and workflow cloning. Requires you've already run setup_ghl_mcp. Capture the three Firebase values from your GHL browser session \u2014 see elitedcs.com/ghl-mcp-firebase for step-by-step DevTools instructions. Tool count goes from 161 to 197 after the next Claude restart.",
     {
-      ghl_user_id: import_zod44.z.string().min(10).describe("Firebase User ID (uid). DevTools \u2192 Application \u2192 IndexedDB \u2192 firebaseLocalStorageDb \u2192 firebaseLocalStorage \u2192 the value.uid field of the firebase:authUser row."),
-      ghl_firebase_api_key: import_zod44.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),
-      ghl_firebase_refresh_token: import_zod44.z.string().min(10).describe("Firebase refresh token. value.stsTokenManager.refreshToken in the firebase:authUser row.")
+      ghl_user_id: import_zod45.z.string().min(10).describe("Firebase User ID (uid). DevTools \u2192 Application \u2192 IndexedDB \u2192 firebaseLocalStorageDb \u2192 firebaseLocalStorage \u2192 the value.uid field of the firebase:authUser row."),
+      ghl_firebase_api_key: import_zod45.z.string().min(10).describe("Firebase API Key starting with 'AIza'. The string between 'firebase:authUser:' and ':[DEFAULT]' in the row's Key column."),
+      ghl_firebase_refresh_token: import_zod45.z.string().min(10).describe("Firebase refresh token. value.stsTokenManager.refreshToken in the firebase:authUser row.")
     },
     async (args) => {
       const existing = readCredentials();
@@ -7314,7 +7351,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "Firebase credentials verified and saved.",
             "",
-            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (196 total).**",
+            "**Restart Claude (quit fully and reopen) to load the workflow builder + funnel builder + pipeline builder + form builder + workflow cloner tools (197 total).**",
             "",
             'After restart, try: "List my workflows in full detail" or "Validate workflow <id>".',
             "",

package/package.json

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