@elitedcs/ghl-mcp 3.62.0 → 3.63.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 3.63.0 — the guide library grows from 3 guides to 20
+
+- **`get_user_guide` now opens a 20-guide library.** Seventeen guides were
+  written and proven live but had never shipped, so anyone running
+  `get user guide` was still getting the three-guide edition. The bundled
+  offline guide goes from 43KB to 111KB: 20 open guides, 10 still marked
+  "Available in the app" until their prompts are proven. Every prompt marked
+  "Proven live" was run against a real GoHighLevel account before it shipped.
+- Same library renders to ghlcommand.com/skills, so the in-product guide and
+  the website always match.
+- **Fix: reading appointments returned nothing.** `get_calendar_events` sent
+  ISO timestamps, but GHL's `/calendars/events` needs epoch milliseconds and
+  answers a wrong-format request with `200` and an empty array instead of an
+  error — so a calendar holding real confirmed bookings read back as "nothing
+  booked". Now converts via the timezone-aware helper free-slots already used,
+  plus an optional `timezone` parameter so a bare `YYYY-MM-DD` window resolves
+  in the sub-account's timezone (end date inclusive). Live-proven both
+  directions.
+
+## 3.62.1 — update_pipeline works again (Bug 8)
+
+- **Fix: `update_pipeline` no longer 422s.** GHL's pipeline PUT rejects unknown
+  body properties, and the request body was seeded with `locationId` — so every
+  update died with "property locationId should not exist" before the stages were
+  read. locationId now rides as a query parameter (the same pattern
+  `delete_pipeline` already used). Live-proven on the sandbox with the case that
+  matters: existing stage IDs survive the update (rename + reorder + append in
+  one call), so open opportunities are never orphaned. New regression proof:
+  `scripts/pipeline-update-proof.mjs`.
+- Trigger reference: `custom_date_reminder` real UI-generated shape captured
+  (conditions + custom_date_reminder_config; before-days variant — after-days
+  still unverified).
+- Action reference: the workflow Email action has NO "to" field — it always
+  mails the enrolled contact; third parties are copied via `cc` (merge fields
+  supported). Documented so nobody builds a "send to a third party" node that
+  silently mails the contact.
+
+
 ## 3.62.0 — The user guide ships inside the product
 
 - **New tool `get_user_guide`** (free tier included): opens the full GHL Command

package/dist/index.js

@@ -2854,7 +2854,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.62.0",
+      version: "3.63.0",
       mcpName: "io.github.drjerryrelth/ghl-command",
       description: "GoHighLevel MCP Server for Claude. 235 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
@@ -7643,7 +7643,7 @@ function toEpochMillis(value, opts = {}) {
   const trimmed = value.trim();
   if (/^\d+$/.test(trimmed)) {
     if (trimmed.length === 13) return trimmed;
-    throw new Error(`Ambiguous numeric date "${value}" for free-slots \u2014 pass epoch MILLISECONDS (13 digits), a YYYY-MM-DD date, or a full ISO datetime.`);
+    throw new Error(`Ambiguous numeric date "${value}" \u2014 pass epoch MILLISECONDS (13 digits), a YYYY-MM-DD date, or a full ISO datetime.`);
   }
   const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
   if (dateOnly) {
@@ -7658,7 +7658,7 @@ function toEpochMillis(value, opts = {}) {
   }
   const parsed = Date.parse(trimmed);
   if (!Number.isNaN(parsed)) return String(parsed);
-  throw new Error(`Invalid date "${value}" for free-slots \u2014 use YYYY-MM-DD, a full ISO datetime, or epoch milliseconds.`);
+  throw new Error(`Invalid date "${value}" \u2014 use YYYY-MM-DD, a full ISO datetime, or epoch milliseconds.`);
 }
 function buildFreeSlotsParams(args) {
   const params = {
@@ -7669,6 +7669,16 @@ function buildFreeSlotsParams(args) {
   if (args.userId !== void 0) params.userId = args.userId;
   return params;
 }
+function buildCalendarEventsParams(args) {
+  const params = {
+    locationId: args.locationId,
+    startTime: toEpochMillis(args.startTime, { timeZone: args.timezone }),
+    endTime: toEpochMillis(args.endTime, { endOfDay: true, timeZone: args.timezone })
+  };
+  if (args.calendarId !== void 0) params.calendarId = args.calendarId;
+  if (args.userId !== void 0) params.userId = args.userId;
+  return params;
+}
 function registerCalendarTools(server2, client) {
   safeTool(
     server2,
@@ -7789,20 +7799,25 @@ function registerCalendarTools(server2, client) {
     "List calendar events for a location within a time range",
     {
       locationId: import_zod12.z.string().optional().describe("Location ID (falls back to GHL_LOCATION_ID env var)"),
-      startTime: import_zod12.z.string().describe("Start time in ISO format"),
-      endTime: import_zod12.z.string().describe("End time in ISO format"),
+      startTime: import_zod12.z.string().describe(
+        "Start of the window. Accepts a date (YYYY-MM-DD), a full ISO datetime, or epoch milliseconds. A bare date is taken as start-of-day in `timezone` (UTC if unset). GHL needs epoch ms here; the tool converts for you."
+      ),
+      endTime: import_zod12.z.string().describe(
+        "End of the window. Accepts a date (YYYY-MM-DD), a full ISO datetime, or epoch milliseconds. A bare date is taken as END of that day, inclusive, in `timezone`."
+      ),
+      timezone: import_zod12.z.string().optional().describe("IANA timezone (e.g. America/Phoenix) used to resolve bare YYYY-MM-DD dates. Defaults to UTC."),
       calendarId: import_zod12.z.string().optional().describe("Filter by calendar ID"),
       userId: import_zod12.z.string().optional().describe("Filter by user ID")
     },
-    async ({ locationId: locationId2, startTime, endTime, calendarId, userId }) => {
-      const resolvedLocationId = client.resolveLocationId(locationId2);
-      const params = {
-        locationId: resolvedLocationId,
+    async ({ locationId: locationId2, startTime, endTime, timezone, calendarId, userId }) => {
+      const params = buildCalendarEventsParams({
+        locationId: client.resolveLocationId(locationId2),
         startTime,
-        endTime
-      };
-      if (calendarId !== void 0) params.calendarId = calendarId;
-      if (userId !== void 0) params.userId = userId;
+        endTime,
+        timezone,
+        calendarId,
+        userId
+      });
       return await client.get("/calendars/events", { params });
     }
   );
@@ -12486,7 +12501,7 @@ ${text2}`);
     },
     async ({ pipelineId }) => {
       try {
-        const result = await pipelineRequest("GET", `/${pipelineId}?locationId=${client.locationId}`);
+        const result = await pipelineRequest("GET", `/${encodeURIComponent(pipelineId)}?locationId=${client.locationId}`);
         return {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
@@ -12556,12 +12571,12 @@ ${text2}`);
     },
     async ({ pipelineId, name, stages, showInFunnel, showInPieChart }) => {
       try {
-        const body = { locationId: client.locationId };
+        const body = {};
         if (name !== void 0) body.name = name;
         if (stages !== void 0) body.stages = stages;
         if (showInFunnel !== void 0) body.showInFunnel = showInFunnel;
         if (showInPieChart !== void 0) body.showInPieChart = showInPieChart;
-        const result = await pipelineRequest("PUT", `/${pipelineId}`, body);
+        const result = await pipelineRequest("PUT", `/${encodeURIComponent(pipelineId)}?locationId=${client.locationId}`, body);
         return {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
@@ -12580,7 +12595,7 @@ ${text2}`);
     },
     async ({ pipelineId }) => {
       try {
-        const result = await pipelineRequest("DELETE", `/${pipelineId}?locationId=${client.locationId}`);
+        const result = await pipelineRequest("DELETE", `/${encodeURIComponent(pipelineId)}?locationId=${client.locationId}`);
         return {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };