@elitedcs/ghl-mcp 3.17.1 → 3.18.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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.

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.1",
+      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: {
@@ -3606,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(
@@ -3625,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(
@@ -3636,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",
     {
@@ -3650,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(
@@ -3674,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({
@@ -3685,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 });
     }
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.17.1",
+  "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": {