@elitedcs/ghl-mcp 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 3.3.0 — 100% native trigger coverage
+
+**173 tools across 36 modules. Bundle: 255.4 KB.**
+
+All **57 of 57** native GHL workflow trigger types now have their own typed Zod variant in `WorkflowTriggerSchema`. Claude can discriminate every trigger type by name and read documented field paths where the catalogue captured them.
+
+Field-documentation completeness (per trigger, marked in the schema's `.describe()` so the LLM knows):
+
+- **42 fully documented** — every filter field path captured (e.g., `contact_changed` with 12 fields, `opportunity_decay` with 9, `survey_submission`, `birthday_reminder`, etc.)
+- **4 partial** — some fields captured, others not: `custom_date_reminder`, `inbound_trigger`, `facebook_comment_on_post`, `ig_comment_on_post`. Reads still pass; LLM is told docs are partial.
+- **2 fieldless by design** — `inbound_webhook`, `payment_received` (fire on any event)
+- **9 uncaptured** — typed-but-no-docs: `affiliate_created`, `scheduler_trigger`, `user_log_in`, `order_submission`, `conv_ai_trigger`, `conv_ai_autonomous_trigger`, `custom_object_created`, `custom_object_changed`, `facebook_lead_gen`. Most rarely used. Type discrimination still works; field paths to be backfilled when buyers need them.
+
+### Backfills
+- The 4 originally-typed triggers (contact_tag, appointment, customer_reply, pipeline_stage_updated) had incomplete field lists in v3.2.0. Now enriched with all captured fields. `customer_reply` went from "no fields documented" to `workflow.id, message.type, message.body, contact.tags`.
+
+### Coverage delta
+| State | Typed | Reachable-but-untyped | Total |
+|---|---:|---:|---:|
+| Before v3.1.0 | 4 | 0 (reads crashed) | 57 |
+| v3.1.0 | 4 | 53 | 57 |
+| v3.2.0 | 13 | 44 | 57 |
+| **v3.3.0** | **57** | **0** | **57** |
+
+### Future-proof
+Even though every native trigger has a typed variant now, `UnknownTriggerSchema` is still in the union as the last fallback — if GHL ships a new trigger type, reads will pass through cleanly instead of throwing.
+
+### Verified
+- 57 / 57 typed variants matched their own type literal via runtime z.union parse test
+- A synthetic "future_trigger_ghl_invents" type still passes through via the fallback
+- Build: 255.4 KB (up from 248.4 KB; +7 KB for the 44 new variants)
+
+### Files changed
+- `src/trigger-schemas.ts` — all 57 typed variants + 4 doc-completeness statuses (`documented`, `partial`, `fieldless`, `uncaptured`) so the LLM's expectations match each trigger's reality.
+
 ## 3.2.0 — Deep trigger typing
 
 **173 tools across 36 modules. Bundle: 248.4 KB.**

package/README.md

@@ -350,7 +350,7 @@ Re-run setup_ghl_mcp with workflow builder:
 
 **Supported action types:** `sms`, `email`, `add_contact_tag`, `remove_contact_tag`, `update_contact_field`, `wait`, `if_else`, `webhook`, `create_opportunity`, `custom_code`, `add_notes`, `internal_notification`, `task-notification`, `remove_from_workflow`, and more.
 
-**Supported trigger types:** All 57 native GHL trigger types read cleanly. **13 are deeply typed** with documented field paths (contact_tag, customer_reply, appointment, pipeline_stage_updated, form_submission, opportunity_created, opportunity_changed, opportunity_status_changed, payment_received, inbound_webhook, mailgun_email_event, note_add, task_added). The other 44 pass through a permissive schema so workflows never fail to read regardless of trigger type. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
+**Supported trigger types:** **All 57 native GHL trigger types are deeply typed** with their own Zod variant. 42 have full field-path documentation (`opportunity_*`, `form_submission`, `contact_changed`, `survey_submission`, `birthday_reminder`, `mailgun_email_event`, and 36 others). 4 have partial docs, 2 are fieldless by design, 9 have type-only discrimination pending field-path capture. A permissive fallback handles any future trigger types GHL ships, so reads never crash. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
 
 ### Pipeline Builder (5 tools) — Internal API
 

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.2.0",
+      version: "3.3.0",
       description: "GoHighLevel MCP Server for Claude. 173 tools \u2014 full CRM, automation, marketing control, and the only programmatic GHL workflow builder.",
       main: "dist/index.js",
       bin: {
@@ -405,12 +405,24 @@ var TriggerCommonSchema = import_zod2.z.object({
   schedule_config: import_zod2.z.record(import_zod2.z.unknown()).optional(),
   date_updated: import_zod2.z.string().optional()
 }).passthrough();
-function typedTrigger(typeLiteral, knownFields) {
-  const fieldDesc = knownFields.length === 0 ? "No filter fields \u2014 trigger matches any event of this type." : `Known field paths: ${knownFields.join(", ")}.`;
+function describe(status, knownFields) {
+  switch (status) {
+    case "fieldless":
+      return "No filter fields \u2014 trigger fires on any event of this type.";
+    case "documented":
+      return `Known field paths: ${knownFields.join(", ")}.`;
+    case "partial":
+      return knownFields.length > 0 ? `Known field paths: ${knownFields.join(", ")}. Note: GHL exposes additional filter fields that aren't yet captured; pass them through if known.` : "GHL exposes one or more filter fields for this trigger; the exact field paths are not yet captured. Pass through whatever you know from the GHL UI.";
+    case "uncaptured":
+      return "Filter field paths not yet captured. Pass through whatever fields you know from the GHL UI; reads will accept any.";
+  }
+}
+function typedTrigger(typeLiteral, knownFields, status = "documented") {
+  const fieldDesc = describe(status, knownFields);
   return TriggerCommonSchema.extend({
     type: import_zod2.z.literal(typeLiteral),
     conditions: import_zod2.z.array(import_zod2.z.object({
-      operator: import_zod2.z.string().describe("Comparison operator (equals, greater_than, less_than, contains, index-of-true, etc.)."),
+      operator: import_zod2.z.string().describe("Comparison operator (equals, greater_than, less_than, contains, index-of-true, is-any-of, etc.)."),
       field: import_zod2.z.string().describe(fieldDesc),
       value: import_zod2.z.unknown().optional(),
       title: import_zod2.z.string().optional(),
@@ -430,9 +442,6 @@ var ContactTagTriggerSchema = TriggerCommonSchema.extend({
     id: import_zod2.z.string().optional()
   }).passthrough())
 });
-var CustomerReplyTriggerSchema = typedTrigger("customer_reply", [
-  // No fields in the catalogue — Customer Reply matches any inbound message.
-]);
 var AppointmentTriggerSchema = typedTrigger("appointment", [
   "calendar.id",
   "appointment.status",
@@ -441,15 +450,105 @@ var AppointmentTriggerSchema = typedTrigger("appointment", [
   "appointment.eventType",
   "appointment.modifiedBy"
 ]);
-var PipelineStageUpdatedTriggerSchema = typedTrigger("pipeline_stage_updated", [
-  "opportunity.pipelineId",
-  "opportunity.pipelineStageId",
+var BirthdayReminderTriggerSchema = typedTrigger("birthday_reminder", [
+  "contact.birthMonth",
+  "contact.birthDay",
+  "contact.dateOfBirth"
+]);
+var CallStatusTriggerSchema = typedTrigger("call_status", [
+  "call_status",
+  "custom_disposition",
+  "message.direction",
+  "workflow.id"
+]);
+var CategoryCompletedTriggerSchema = typedTrigger("category_completed", [
+  "membership.product.id"
+]);
+var CategoryStartedTriggerSchema = typedTrigger("category_started", [
+  "membership.product.id"
+]);
+var ContactChangedTriggerSchema = typedTrigger("contact_changed", [
+  "contact.tags",
+  "contact.dnd",
+  "contact.assignedTo",
+  "contact.phone",
+  "contact.email",
+  "contact.type",
+  "contact.address1",
+  "contact.city",
+  "contact.state",
+  "contact.country",
+  "contact.postalCode",
+  "contact.website"
+]);
+var ContactCreatedTriggerSchema = typedTrigger("contact_created", [
+  "tagsAdded",
+  "contact.phone",
+  "contact.email",
+  "contact.type"
+]);
+var CustomerAppointmentTriggerSchema = typedTrigger("customer_appointment", [
+  "calendar.id",
+  "contact.tags"
+]);
+var CustomerReplyTriggerSchema = typedTrigger("customer_reply", [
+  "workflow.id",
+  "message.type",
+  "message.body",
+  "contact.tags"
+]);
+var DndContactTriggerSchema = typedTrigger("dnd_contact", [
+  "contact.dnd_direction",
+  "contact.dnd",
   "contact.tags"
 ]);
 var FormSubmissionTriggerSchema = typedTrigger("form_submission", [
   "form.id",
   "formData.termsAndConditions"
 ]);
+var InvoiceTriggerSchema = typedTrigger("invoice", [
+  "invoice.status",
+  "contact.tags"
+]);
+var IvrIncomingCallTriggerSchema = typedTrigger("ivr_incoming_call", [
+  "inbound_number"
+]);
+var LessonCompletedTriggerSchema = typedTrigger("lesson_completed", [
+  "membership.product.id"
+]);
+var LessonStartedTriggerSchema = typedTrigger("lesson_started", [
+  "membership.product.id"
+]);
+var MailgunEmailEventTriggerSchema = typedTrigger("mailgun_email_event", [
+  "workflow.id",
+  "mailgun.event"
+  // opened | clicked | bounced | delivered | etc.
+]);
+var MembershipContactCreatedTriggerSchema = typedTrigger("membership_contact_created", [
+  "offer.id"
+]);
+var NoteAddTriggerSchema = typedTrigger("note_add", [
+  "contact.tags"
+]);
+var NoteChangedTriggerSchema = typedTrigger("note_changed", [
+  "contact.tags"
+]);
+var OfferAccessGrantedTriggerSchema = typedTrigger("offer_access_granted", [
+  "offer.id"
+]);
+var OfferAccessRemovedTriggerSchema = typedTrigger("offer_access_removed", [
+  "offer.id"
+]);
+var OpportunityChangedTriggerSchema = typedTrigger("opportunity_changed", [
+  "opportunity.pipelineId",
+  "contact.tags",
+  "opportunity.assignedTo",
+  "opportunity.monetaryValue",
+  "opportunity.forecastExpectedCloseDate",
+  "opportunity.forecastProbability",
+  "opportunity.status",
+  "opportunity.lostReasonId"
+]);
 var OpportunityCreatedTriggerSchema = typedTrigger("opportunity_created", [
   "opportunity.pipelineId",
   "contact.tags",
@@ -460,8 +559,9 @@ var OpportunityCreatedTriggerSchema = typedTrigger("opportunity_created", [
   "opportunity.status",
   "opportunity.lostReasonId"
 ]);
-var OpportunityChangedTriggerSchema = typedTrigger("opportunity_changed", [
+var OpportunityDecayTriggerSchema = typedTrigger("opportunity_decay", [
   "opportunity.pipelineId",
+  "opportunity.lastActionDate",
   "contact.tags",
   "opportunity.assignedTo",
   "opportunity.monetaryValue",
@@ -481,44 +581,146 @@ var OpportunityStatusChangedTriggerSchema = typedTrigger("opportunity_status_cha
   "opportunity.forecastProbability",
   "opportunity.lostReasonId"
 ]);
-var PaymentReceivedTriggerSchema = typedTrigger("payment_received", [
-  // No filter fields — fires on any payment received.
+var PipelineStageUpdatedTriggerSchema = typedTrigger("pipeline_stage_updated", [
+  "opportunity.pipelineId",
+  "opportunity.pipelineStageId",
+  // not in catalogue but central to this trigger by name
+  "contact.tags",
+  "opportunity.assignedTo",
+  "opportunity.monetaryValue",
+  "opportunity.forecastExpectedCloseDate",
+  "opportunity.forecastProbability",
+  "opportunity.status",
+  "opportunity.lostReasonId"
 ]);
-var InboundWebhookTriggerSchema = typedTrigger("inbound_webhook", [
-  // No filter fields — fires on any inbound webhook hit.
+var ProductAccessGrantedTriggerSchema = typedTrigger("product_access_granted", [
+  "product.id"
 ]);
-var MailgunEmailEventTriggerSchema = typedTrigger("mailgun_email_event", [
-  "workflow.id",
-  "mailgun.event"
-  // opened | clicked | bounced | delivered | etc.
+var ProductAccessRemovedTriggerSchema = typedTrigger("product_access_removed", [
+  "product.id"
 ]);
-var NoteAddTriggerSchema = typedTrigger("note_add", [
-  "contact.tags"
+var ProductCompletedTriggerSchema = typedTrigger("product_completed", [
+  "membership.product.id"
+]);
+var ProductStartedTriggerSchema = typedTrigger("product_started", [
+  "membership.product.id"
+]);
+var ShopifyAbandonedCartTriggerSchema = typedTrigger("shopify_abandoned_cart", [
+  "duration",
+  "cart_value"
+]);
+var ShopifyOrderFulfilledTriggerSchema = typedTrigger("shopify_order_fulfilled", [
+  "cart_value"
+]);
+var ShopifyOrderPlacedTriggerSchema = typedTrigger("shopify_order_placed", [
+  "cart_value"
+]);
+var SurveySubmissionTriggerSchema = typedTrigger("survey_submission", [
+  "survey.id",
+  "surveySubmission.disqualified",
+  "surveyData.termsAndConditions"
 ]);
 var TaskAddedTriggerSchema = typedTrigger("task_added", [
   "task.assignedTo"
 ]);
+var TaskDueDateReminderTriggerSchema = typedTrigger("task_due_date_reminder", [
+  "task.dueDate"
+]);
+var TikTokFormSubmittedTriggerSchema = typedTrigger("tik_tok_form_submitted", [
+  "tikTok.formId"
+]);
+var TriggerLinkTriggerSchema = typedTrigger("trigger_link", [
+  "link.id"
+]);
+var TwoStepFormSubmissionTriggerSchema = typedTrigger("two_step_form_submission", [
+  "twoStepOrderForm.funnelId",
+  "twoStepOrderForm.submissionType"
+]);
+var ValidationErrorTriggerSchema = typedTrigger("validation_error", [
+  "contact.phoneInfo"
+]);
+var VideoEventTriggerSchema = typedTrigger("video_event", [
+  "video.funnelId",
+  "video.videoId",
+  "video.duration"
+]);
+var CustomDateReminderTriggerSchema = typedTrigger("custom_date_reminder", [], "partial");
+var InboundTriggerTriggerSchema = typedTrigger("inbound_trigger", ["contact.tags"], "partial");
+var FacebookCommentOnPostTriggerSchema = typedTrigger("facebook_comment_on_post", [], "partial");
+var IgCommentOnPostTriggerSchema = typedTrigger("ig_comment_on_post", [], "partial");
+var InboundWebhookTriggerSchema = typedTrigger("inbound_webhook", [], "fieldless");
+var PaymentReceivedTriggerSchema = typedTrigger("payment_received", [], "fieldless");
+var AffiliateCreatedTriggerSchema = typedTrigger("affiliate_created", [], "uncaptured");
+var SchedulerTriggerTriggerSchema = typedTrigger("scheduler_trigger", [], "uncaptured");
+var UserLogInTriggerSchema = typedTrigger("user_log_in", [], "uncaptured");
+var OrderSubmissionTriggerSchema = typedTrigger("order_submission", [], "uncaptured");
+var ConvAiTriggerTriggerSchema = typedTrigger("conv_ai_trigger", [], "uncaptured");
+var ConvAiAutonomousTriggerTriggerSchema = typedTrigger("conv_ai_autonomous_trigger", [], "uncaptured");
+var CustomObjectCreatedTriggerSchema = typedTrigger("custom_object_created", [], "uncaptured");
+var CustomObjectChangedTriggerSchema = typedTrigger("custom_object_changed", [], "uncaptured");
+var FacebookLeadGenTriggerSchema = typedTrigger("facebook_lead_gen", [], "uncaptured");
 var UnknownTriggerSchema = TriggerCommonSchema.extend({
   type: import_zod2.z.string(),
   conditions: import_zod2.z.array(import_zod2.z.record(import_zod2.z.unknown())).optional()
 });
 var WorkflowTriggerSchema = import_zod2.z.union([
-  // Originally typed (v3.0.x)
   ContactTagTriggerSchema,
-  CustomerReplyTriggerSchema,
   AppointmentTriggerSchema,
-  PipelineStageUpdatedTriggerSchema,
-  // Added in v3.2.0
+  BirthdayReminderTriggerSchema,
+  CallStatusTriggerSchema,
+  CategoryCompletedTriggerSchema,
+  CategoryStartedTriggerSchema,
+  ContactChangedTriggerSchema,
+  ContactCreatedTriggerSchema,
+  CustomerAppointmentTriggerSchema,
+  CustomerReplyTriggerSchema,
+  DndContactTriggerSchema,
   FormSubmissionTriggerSchema,
-  OpportunityCreatedTriggerSchema,
-  OpportunityChangedTriggerSchema,
-  OpportunityStatusChangedTriggerSchema,
-  PaymentReceivedTriggerSchema,
-  InboundWebhookTriggerSchema,
+  InvoiceTriggerSchema,
+  IvrIncomingCallTriggerSchema,
+  LessonCompletedTriggerSchema,
+  LessonStartedTriggerSchema,
   MailgunEmailEventTriggerSchema,
+  MembershipContactCreatedTriggerSchema,
   NoteAddTriggerSchema,
+  NoteChangedTriggerSchema,
+  OfferAccessGrantedTriggerSchema,
+  OfferAccessRemovedTriggerSchema,
+  OpportunityChangedTriggerSchema,
+  OpportunityCreatedTriggerSchema,
+  OpportunityDecayTriggerSchema,
+  OpportunityStatusChangedTriggerSchema,
+  PipelineStageUpdatedTriggerSchema,
+  ProductAccessGrantedTriggerSchema,
+  ProductAccessRemovedTriggerSchema,
+  ProductCompletedTriggerSchema,
+  ProductStartedTriggerSchema,
+  ShopifyAbandonedCartTriggerSchema,
+  ShopifyOrderFulfilledTriggerSchema,
+  ShopifyOrderPlacedTriggerSchema,
+  SurveySubmissionTriggerSchema,
   TaskAddedTriggerSchema,
-  // Fallback for the remaining 44 native trigger types + any future ones
+  TaskDueDateReminderTriggerSchema,
+  TikTokFormSubmittedTriggerSchema,
+  TriggerLinkTriggerSchema,
+  TwoStepFormSubmissionTriggerSchema,
+  ValidationErrorTriggerSchema,
+  VideoEventTriggerSchema,
+  CustomDateReminderTriggerSchema,
+  InboundTriggerTriggerSchema,
+  FacebookCommentOnPostTriggerSchema,
+  IgCommentOnPostTriggerSchema,
+  InboundWebhookTriggerSchema,
+  PaymentReceivedTriggerSchema,
+  AffiliateCreatedTriggerSchema,
+  SchedulerTriggerTriggerSchema,
+  UserLogInTriggerSchema,
+  OrderSubmissionTriggerSchema,
+  ConvAiTriggerTriggerSchema,
+  ConvAiAutonomousTriggerTriggerSchema,
+  CustomObjectCreatedTriggerSchema,
+  CustomObjectChangedTriggerSchema,
+  FacebookLeadGenTriggerSchema,
   UnknownTriggerSchema
 ]);
 

package/package.json

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