@elitedcs/ghl-mcp 3.17.0 → 3.18.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 3.18.0 — Social Planner: location-scoped endpoints, scheduled posts, typed media
+
+**No new tools (still 212 across 43 modules) — fixes plus a capability add to the existing Social Planner tools.**
+
+- Every Social Planner call (`get_social_posts`, `get_social_post`, `delete_social_post`, `get_social_media_accounts`, `create_social_post`) now hits the correct location-scoped v2 path (`/social-media-posting/{locationId}/...`). The bare paths were returning errors.
+- `create_social_post` now supports **scheduled posts**: pass `scheduledAt` (sent as `scheduleDate`) with `status: "scheduled"`. `status` is a typed enum: `in_review`, `scheduled`, `draft`, `published`.
+- Media items are typed — each URL is sent as `{ url, type }` with the MIME type inferred. Scheduled posts reject untyped media (and Instagram requires at least one media item).
+
+## 3.17.1 — Onboarding messaging fixes + public feedback tracker
+
+**No tool changes — still 212 across 43 modules.** Bug-driven fixes from a buyer support ticket (Ryan Thomas, 2026-05-25), plus a public place to file feedback.
+
+### Firebase / Workflow Builder onboarding was steering buyers wrong
+
+`workflow_builder_status` told users to "set env vars in start-mcp.sh or .env" to enable the 49 Firebase-gated tools. On the npm / Claude Desktop install path there is no `start-mcp.sh` or `.env`, so buyers added the Firebase values to the `claude_desktop_config.json` env block — which Claude Desktop passes unreliably — and got `health_check` → "Firebase: SKIP" after a restart. Now both `workflow_builder_status` and the `health_check` Firebase-SKIP detail steer to `enable_workflow_builder` (the supported path: it validates the values and writes them to `credentials.json`), explicitly warn off the config env-var path, and demote the raw env vars to an advanced/self-hosted note.
+
+### Dead npm "Repository" link → public feedback repo
+
+`package.json` `repository`/`bugs` pointed at the **private** source repo, which npm renders as a clickable link that 404s for buyers. Now both point to the new public feedback tracker — **https://github.com/drjerryrelth/ghl-command-feedback** — where users can file bug reports and feature requests via issue templates.
+
 ## 3.17.0 — Multi-tenant bootstrap, internal hardening, test coverage
 
 **No new tools — still 212 across 43 modules. Internal hardening + a multi-tenant fix.**

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.17.0",
+      version: "3.18.0",
       description: "GoHighLevel MCP Server for Claude. 212 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
       bin: {
@@ -68,10 +68,11 @@ var require_package = __commonJS({
       homepage: "https://elitedcs.com/ghl-mcp-server",
       repository: {
         type: "git",
-        url: "git+https://github.com/drjerryrelth/elite-dcs-ghl-mcp.git"
+        url: "git+https://github.com/drjerryrelth/ghl-command-feedback.git"
       },
       bugs: {
-        url: "https://github.com/drjerryrelth/elite-dcs-ghl-mcp/issues"
+        url: "https://github.com/drjerryrelth/ghl-command-feedback/issues",
+        email: "support@cliniclaunchlab.com"
       },
       publishConfig: {
         access: "public"
@@ -3605,18 +3606,22 @@ function registerSocialPlannerTools(server2, client) {
       fromDate: import_zod21.z.string().optional().describe("Start date filter (ISO string)"),
       toDate: import_zod21.z.string().optional().describe("End date filter (ISO string)"),
       includeUsers: import_zod21.z.boolean().optional().describe("Whether to include user details"),
-      status: import_zod21.z.enum(["in_review", "scheduled", "published", "failed", "in_progress"]).optional().describe("Post status filter")
+      status: import_zod21.z.enum(["in_review", "scheduled", "published", "failed", "in_progress"]).optional().describe("Post status filter"),
+      skip: import_zod21.z.number().optional().describe("Pagination offset"),
+      limit: import_zod21.z.number().optional().describe("Page size")
     },
-    async ({ locationId: locationId2, type, accounts, fromDate, toDate, includeUsers, status }) => {
+    async ({ locationId: locationId2, type, accounts, fromDate, toDate, includeUsers, status, skip, limit }) => {
       const resolvedLocationId = client.resolveLocationId(locationId2);
-      const params = { locationId: resolvedLocationId };
-      if (type !== void 0) params.type = type;
-      if (accounts !== void 0) params.accounts = accounts;
-      if (fromDate !== void 0) params.fromDate = fromDate;
-      if (toDate !== void 0) params.toDate = toDate;
-      if (includeUsers !== void 0) params.includeUsers = includeUsers;
-      if (status !== void 0) params.status = status;
-      return client.get("/social-media-posting/", { params });
+      const body = {};
+      if (type !== void 0) body.type = type;
+      if (accounts !== void 0) body.accounts = accounts;
+      if (fromDate !== void 0) body.fromDate = fromDate;
+      if (toDate !== void 0) body.toDate = toDate;
+      if (includeUsers !== void 0) body.includeUsers = includeUsers;
+      if (status !== void 0) body.status = status;
+      body.skip = skip ?? 0;
+      body.limit = limit ?? 20;
+      return client.post(`/social-media-posting/${resolvedLocationId}/posts/list`, { body });
     }
   );
   safeTool(
@@ -3624,10 +3629,12 @@ function registerSocialPlannerTools(server2, client) {
     "get_social_post",
     "Get a single social media post by ID",
     {
-      postId: import_zod21.z.string().describe("The social media post ID")
+      postId: import_zod21.z.string().describe("The social media post ID"),
+      locationId: import_zod21.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)")
     },
-    async ({ postId }) => {
-      return client.get(`/social-media-posting/${postId}`);
+    async ({ postId, locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      return client.get(`/social-media-posting/${resolvedLocationId}/posts/${postId}`);
     }
   );
   safeTool(
@@ -3635,13 +3642,16 @@ function registerSocialPlannerTools(server2, client) {
     "delete_social_post",
     "Delete a social media post",
     {
-      postId: import_zod21.z.string().describe("The social media post ID to delete")
+      postId: import_zod21.z.string().describe("The social media post ID to delete"),
+      locationId: import_zod21.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)")
     },
-    async ({ postId }) => {
-      return client.delete(`/social-media-posting/${postId}`);
+    async ({ postId, locationId: locationId2 }) => {
+      const resolvedLocationId = client.resolveLocationId(locationId2);
+      return client.delete(`/social-media-posting/${resolvedLocationId}/posts/${postId}`);
     }
   );
-  server2.tool(
+  safeTool(
+    server2,
     "get_social_media_accounts",
     "Get connected social media accounts for a location",
     {
@@ -3649,21 +3659,7 @@ function registerSocialPlannerTools(server2, client) {
     },
     async ({ locationId: locationId2 }) => {
       const resolvedLocationId = client.resolveLocationId(locationId2);
-      try {
-        const result = await client.get(
-          `/social-media-posting/oauth/${resolvedLocationId}/accounts`
-        );
-        return jsonResponse(result);
-      } catch {
-        try {
-          const result = await client.get(
-            `/social-media-posting/oauth/facebook/accounts/${resolvedLocationId}`
-          );
-          return jsonResponse(result);
-        } catch (fallbackError) {
-          return errorResponse(fallbackError);
-        }
-      }
+      return client.get(`/social-media-posting/${resolvedLocationId}/accounts`);
     }
   );
   safeTool(
@@ -3673,9 +3669,11 @@ function registerSocialPlannerTools(server2, client) {
     {
       locationId: import_zod21.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)"),
       accountIds: import_zod21.z.array(import_zod21.z.string()).describe("Array of social account IDs to post to"),
+      userId: import_zod21.z.string().optional().describe("GHL user ID that authors the post (required by the API; falls back to GHL_USER_ID env)"),
       summary: import_zod21.z.string().optional().describe("The post text/caption"),
       media: import_zod21.z.array(import_zod21.z.string()).optional().describe("Array of media URLs to attach"),
-      status: import_zod21.z.enum(["in_review", "scheduled", "draft"]).optional().describe("Post status"),
+      type: import_zod21.z.enum(["post", "story", "reel"]).optional().describe("Post type (default post)"),
+      status: import_zod21.z.enum(["in_review", "scheduled", "draft", "published"]).optional().describe("Post status"),
       scheduledAt: import_zod21.z.string().optional().describe("Scheduled publish time (ISO string)"),
       tags: import_zod21.z.array(import_zod21.z.string()).optional().describe("Tags for the post"),
       ogData: import_zod21.z.object({
@@ -3684,16 +3682,41 @@ function registerSocialPlannerTools(server2, client) {
         image: import_zod21.z.string().optional()
       }).optional().describe("Open Graph data for link previews")
     },
-    async ({ locationId: locationId2, accountIds, summary, media, status, scheduledAt, tags, ogData }) => {
+    async ({ locationId: locationId2, accountIds, userId, summary, media, type, status, scheduledAt, tags, ogData }) => {
       const resolvedLocationId = client.resolveLocationId(locationId2);
-      const body = { locationId: resolvedLocationId, accountIds };
+      const resolvedUserId = userId ?? process.env.GHL_USER_ID;
+      if (!resolvedUserId) {
+        throw new Error(
+          "create_social_post requires a userId (the post author). Pass userId or set GHL_USER_ID."
+        );
+      }
+      const body = {
+        accountIds,
+        userId: resolvedUserId,
+        type: type ?? "post"
+      };
       if (summary !== void 0) body.summary = summary;
-      if (media !== void 0) body.media = media;
+      if (media !== void 0) {
+        const mimeFor = (url) => {
+          const ext = url.split("?")[0].split(".").pop()?.toLowerCase() ?? "";
+          const map = {
+            png: "image/png",
+            jpg: "image/jpeg",
+            jpeg: "image/jpeg",
+            gif: "image/gif",
+            webp: "image/webp",
+            mp4: "video/mp4",
+            mov: "video/quicktime"
+          };
+          return map[ext] ?? "image/png";
+        };
+        body.media = media.map((url) => ({ url, type: mimeFor(url) }));
+      }
       if (status !== void 0) body.status = status;
-      if (scheduledAt !== void 0) body.scheduledAt = scheduledAt;
+      if (scheduledAt !== void 0) body.scheduleDate = scheduledAt;
       if (tags !== void 0) body.tags = tags;
       if (ogData !== void 0) body.ogData = ogData;
-      return client.post("/social-media-posting/", { body });
+      return client.post(`/social-media-posting/${resolvedLocationId}/posts`, { body });
     }
   );
 }
@@ -4791,13 +4814,21 @@ function registerWorkflowBuilderTools(server2, client) {
   if (!client) {
     server2.tool(
       "workflow_builder_status",
-      "Check if the workflow builder (internal API) is configured. Requires GHL_FIREBASE_API_KEY, GHL_FIREBASE_REFRESH_TOKEN, GHL_API_KEY, GHL_LOCATION_ID, and GHL_USER_ID.",
+      "Check if the workflow builder (internal API) is configured. Needs Firebase credentials, added via enable_workflow_builder.",
       {},
       async () => ({
         content: [
           {
             type: "text",
-            text: "Workflow builder is NOT configured. Missing required env vars: GHL_FIREBASE_API_KEY, GHL_FIREBASE_REFRESH_TOKEN, GHL_USER_ID. Set these in start-mcp.sh or .env to enable full workflow editing."
+            text: [
+              "Workflow builder is NOT configured (Firebase credentials missing).",
+              "",
+              "To enable the 49 Firebase-gated tools, run enable_workflow_builder with your three Firebase values (ghl_user_id, ghl_firebase_api_key, ghl_firebase_refresh_token) captured from a logged-in GHL browser tab. Step-by-step DevTools guide: https://elitedcs.com/ghl-mcp-firebase",
+              "",
+              "Do NOT add these as env vars in your Claude Desktop config \u2014 that path is unreliable and is the usual reason this still shows missing after a restart. enable_workflow_builder validates the values and saves them for you; then fully quit and reopen Claude.",
+              "",
+              "(Advanced / self-hosted wrapper only: GHL_FIREBASE_API_KEY, GHL_FIREBASE_REFRESH_TOKEN, GHL_USER_ID via start-mcp.sh or .env.)"
+            ].join("\n")
           }
         ],
         isError: true
@@ -8041,7 +8072,7 @@ function registerDiagnosticTools(server2, installedVersion, client, builderClien
       })();
       const firebasePromise = (async () => {
         if (!builderClient) {
-          return { name: "Firebase auth (workflow builder)", status: "skip", detail: "Not configured. The 49 Firebase-gated tools need Firebase credentials. The other 163 tools work fine without. To add it: run enable_workflow_builder with the three Firebase values from your GHL browser session (see elitedcs.com/ghl-mcp-firebase for DevTools steps)." };
+          return { name: "Firebase auth (workflow builder)", status: "skip", detail: "Not configured. The 49 Firebase-gated tools need Firebase credentials. The other 163 tools work fine without. To add it: run enable_workflow_builder with the three Firebase values from your GHL browser session (see elitedcs.com/ghl-mcp-firebase for DevTools steps). Do NOT put Firebase values as env vars in your Claude Desktop config \u2014 that path is unreliable and is the usual reason this still shows skip after a restart. enable_workflow_builder saves and verifies them for you." };
         }
         const result = await builderClient.checkAuth();
         const activeCompany = builderClient.getCurrentCompanyId();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.17.0",
+  "version": "3.18.0",
   "description": "GoHighLevel MCP Server for Claude. 212 tools — full CRM, automation, marketing control, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",
   "bin": {
@@ -37,10 +37,11 @@
   "homepage": "https://elitedcs.com/ghl-mcp-server",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/drjerryrelth/elite-dcs-ghl-mcp.git"
+    "url": "git+https://github.com/drjerryrelth/ghl-command-feedback.git"
   },
   "bugs": {
-    "url": "https://github.com/drjerryrelth/elite-dcs-ghl-mcp/issues"
+    "url": "https://github.com/drjerryrelth/ghl-command-feedback/issues",
+    "email": "support@cliniclaunchlab.com"
   },
   "publishConfig": {
     "access": "public"