@elitedcs/ghl-mcp 3.17.1 → 3.19.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.19.0 — npm lead capture + $97 pricing alignment
+
+**One new bootstrap-mode tool. Normal-mode count unchanged (212 across 43 modules).**
+
+- **`request_license`** (bootstrap mode): someone who installs from npm without a license can leave their email instead of hitting a dead end. It records them as a tracked GHL lead (`ghl-command-lead` tag → lead-nurture sequence, New Lead opportunity) and returns the purchase link. Turns anonymous npm installs into sellable pipeline.
+- Bootstrap messaging now points no-license users to `request_license`.
+- Pricing aligned to **$97 one-time** across the README (was inconsistently listed as $297); corrected the post-setup count to 163 core tools (212 with the optional Workflow Builder Firebase add-on).
+
+## 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/README.md

@@ -6,7 +6,7 @@
 
 Works with **both the Claude Desktop App and Claude Code terminal** — your choice.
 
-**License required.** Buy at [elitedcs.com/ghl-mcp-server](https://elitedcs.com/ghl-mcp-server) — one-time $297, three-machine activation, no subscription.
+**License required.** Buy at [elitedcs.com/ghl-mcp-server](https://elitedcs.com/ghl-mcp-server) — one-time $97, three-machine activation, no subscription.
 
 Built by [Elite DCs, LLC](https://elitedcs.com).
 
@@ -61,7 +61,7 @@ This MCP (Model Context Protocol) server connects Claude directly to GoHighLevel
 
 ### 1. Buy a license
 
-[elitedcs.com/ghl-mcp-server](https://elitedcs.com/ghl-mcp-server) — one-time $297. License key arrives by email within 1-2 minutes.
+[elitedcs.com/ghl-mcp-server](https://elitedcs.com/ghl-mcp-server) — one-time $97. License key arrives by email within 1-2 minutes.
 
 ### 2. Install in Claude Desktop App
 
@@ -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 169 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 163 core tools are now unlocked (212 with the optional Workflow Builder Firebase add-on).
 
 ### 4. Try it
 

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.19.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 });
     }
   );
 }
@@ -5747,6 +5769,7 @@ var os2 = __toESM(require("os"));
 var crypto2 = __toESM(require("crypto"));
 var import_zod37 = require("zod");
 var LICENSE_API = "https://elitedcs.com/api/validate-license";
+var CAPTURE_API = "https://elitedcs.com/api/capture-lead";
 var GHL_API = "https://services.leadconnectorhq.com";
 var FIREBASE_TOKEN_API = "https://securetoken.googleapis.com/v1/token";
 function deviceFingerprint() {
@@ -5955,6 +5978,48 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
     }
   );
 }
+function registerLeadCaptureTool(server2) {
+  server2.tool(
+    "request_license",
+    "Get a GHL Command license. Use this if you installed from npm but don't have a license yet (or setup_ghl_mcp says your license is missing/invalid). GHL Command is $97 one-time \u2014 212 tools across 43 modules, 3-machine activation, no subscription. Leave your email and we'll send the purchase link + setup help; the tool also returns where to buy right now.",
+    {
+      email: import_zod37.z.string().email().describe("Your email \u2014 where to send the purchase link and setup help."),
+      name: import_zod37.z.string().optional().describe("Your name (optional).")
+    },
+    async (args) => {
+      const buyUrl = "https://elitedcs.com/ghl-mcp-server";
+      try {
+        const res = await fetch(CAPTURE_API, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ email: args.email.trim(), name: args.name?.trim(), source: "npm-bootstrap" })
+        });
+        const data = await res.json().catch(() => ({}));
+        const url = data.purchaseUrl || buyUrl;
+        return {
+          content: [{
+            type: "text",
+            text: [
+              data.message || "You're on the list.",
+              "",
+              "GHL Command is $97 one-time: 212 tools across 43 modules, including the only programmatic GHL workflow builder. 3 machines, no subscription.",
+              "",
+              `Buy now: ${url}`,
+              "Your license key arrives by email within a couple minutes. Then run setup_ghl_mcp with your email + key."
+            ].join("\n")
+          }]
+        };
+      } catch {
+        return {
+          content: [{
+            type: "text",
+            text: `Buy your GHL Command license ($97 one-time) at ${buyUrl} \u2014 your key arrives by email within a couple minutes, then run setup_ghl_mcp with your email + key.`
+          }]
+        };
+      }
+    }
+  );
+}
 
 // src/tools/location-switcher.ts
 function routeFirebaseForCompany(builderClient, registry2, companyId) {
@@ -8261,10 +8326,11 @@ 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 setup_ghl_mcp and get_mcp_version are available. Run setup_ghl_mcp from Claude with your license + GHL credentials.
+[ghl-mcp] Only setup_ghl_mcp, request_license, and get_mcp_version are available. Run setup_ghl_mcp with your license + GHL credentials \u2014 or request_license if you don't have a license yet.
 `
   );
   registerSetupTool(server);
+  registerLeadCaptureTool(server);
 } else {
   const client = new GHLClient({ apiKey, locationId });
   registerAllTools(server, client, registry, pkg.version);

package/package.json

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