@daeda/mcp-pro 0.1.1 → 0.1.4

package/dist/index.js

@@ -4190,31 +4190,76 @@ var batchDeleteRecordsMeta = {
 
 // ../shared/operations/create-list/meta.ts
 import { z as z28 } from "zod";
+var FilterSchema = z28.object({
+  filterType: z28.string(),
+  property: z28.string().optional(),
+  operation: z28.record(z28.unknown()).optional()
+}).passthrough();
+var FilterBranchSchema = z28.object({
+  filterBranchType: z28.enum(["AND", "ASSOCIATION", "UNIFIED_EVENTS"]),
+  filterBranches: z28.lazy(() => z28.array(FilterBranchSchema)).default([]),
+  filters: z28.array(FilterSchema).default([])
+}).passthrough();
+var RootFilterBranchSchema = z28.object({
+  filterBranchType: z28.literal("OR"),
+  filterBranches: z28.array(FilterBranchSchema).min(1),
+  filters: z28.array(FilterSchema).default([])
+}).passthrough();
 var CreateListOperationSchema = z28.object({
   type: z28.literal("create_list"),
   description: z28.string().min(1),
   name: z28.string().min(1),
   object_type_id: z28.string().min(1),
   processing_type: z28.enum(["MANUAL", "DYNAMIC"]),
-  filter_branch: z28.record(z28.unknown()).optional()
+  filter_branch: RootFilterBranchSchema.optional()
 });
+var FILTER_BRANCH_DESCRIPTION = `HubSpot filter definition for DYNAMIC lists. MUST follow the OR\u2192AND hierarchy:
+- Root: { filterBranchType: "OR", filters: [], filterBranches: [<one or more AND branches>] }
+- Each AND branch: { filterBranchType: "AND", filters: [<actual filters>], filterBranches: [] }
+- For OR logic between filter groups, use multiple AND branches under the root OR.
+- For AND logic within a group, put multiple filters in the same AND branch's filters array.
+- ASSOCIATION and UNIFIED_EVENTS branches can be nested inside AND branches.
+Property filter example: { filterType: "PROPERTY", property: "lifecyclestage", operation: { operationType: "MULTISTRING", operator: "IS_EQUAL_TO", values: ["lead"] } }
+Common operationTypes: MULTISTRING (strings), NUMBER (numbers), BOOL (booleans), ENUMERATION (select/multi-select), ALL_PROPERTY (IS_KNOWN/IS_NOT_KNOWN), TIME_POINT (date comparison), TIME_RANGED (date ranges).`;
 var fields17 = [
   { name: "name", type: "string", required: true, description: "Name for the new list" },
-  { name: "object_type_id", type: "string", required: true, description: "Object type ID (e.g. '0-1' for contacts, '0-2' for companies)" },
+  { name: "object_type_id", type: "string", required: true, description: "Object type ID (e.g. '0-1' for contacts, '0-2' for companies, '0-3' for deals)" },
   { name: "processing_type", type: "string", required: true, description: "List type: 'MANUAL' (static) or 'DYNAMIC' (active)" },
-  { name: "filter_branch", type: "object", required: false, description: "HubSpot filter definition for DYNAMIC lists (passed as-is to API)" }
+  { name: "filter_branch", type: "object", required: false, description: FILTER_BRANCH_DESCRIPTION }
 ];
 var createListMeta = {
   type: "create_list",
   category: "create",
   summary: "Create a contact or company list (static or dynamic)",
-  description: "Create a new HubSpot list. MANUAL lists are static (members added manually). DYNAMIC lists are active (membership determined by filter criteria). For DYNAMIC lists, provide filter_branch with the HubSpot filter definition.",
+  description: `Create a new HubSpot list. MANUAL lists are static (members added manually). DYNAMIC lists are active (membership determined by filter criteria).
+For DYNAMIC lists, provide filter_branch with the HubSpot filter definition. The root filterBranchType MUST be "OR" with filters: [] and one or more "AND" child branches containing the actual filters. This structure is enforced by HubSpot's API.`,
   fields: fields17,
   example: {
     fields: {
-      name: "Hot Leads",
+      name: "Active Leads",
       object_type_id: "0-1",
-      processing_type: "MANUAL"
+      processing_type: "DYNAMIC",
+      filter_branch: {
+        filterBranchType: "OR",
+        filters: [],
+        filterBranches: [
+          {
+            filterBranchType: "AND",
+            filterBranches: [],
+            filters: [
+              {
+                filterType: "PROPERTY",
+                property: "lifecyclestage",
+                operation: {
+                  operationType: "MULTISTRING",
+                  operator: "IS_EQUAL_TO",
+                  values: ["lead"]
+                }
+              }
+            ]
+          }
+        ]
+      }
     }
   },
   toNested: (description, fields29) => {
@@ -4230,13 +4275,21 @@ var createListMeta = {
   },
   requiredScopes: () => ["crm.lists.write"],
   getSummary: (op) => `Create List \u2014 ${op.name} (${op.processing_type})`,
-  getResourceUrl: (portalId) => `${HUBSPOT_BASE}/contacts/${portalId}/lists`,
+  getResourceUrl: (portalId) => `${HUBSPOT_BASE}/contacts/${portalId}/objectLists/views/all`,
   renderDetails: (op) => {
     const rows = [
       { label: "Name", value: op.name },
       { label: "Object Type ID", value: op.object_type_id },
       { label: "Processing Type", value: op.processing_type }
     ];
+    if (op.filter_branch) {
+      const andCount = op.filter_branch.filterBranches?.length ?? 0;
+      const totalFilters = op.filter_branch.filterBranches?.reduce(
+        (sum, branch) => sum + (branch.filters?.length ?? 0),
+        0
+      ) ?? 0;
+      rows.push({ label: "Filter Groups", value: `${andCount} group(s), ${totalFilters} filter(s)` });
+    }
     return { rows };
   }
 };
@@ -7027,6 +7080,55 @@ var createListHandler = {
         message: `Processing type '${op.processing_type}' is invalid \u2014 must be "MANUAL" or "DYNAMIC"`
       });
     }
+    if (op.processing_type === "DYNAMIC" && !op.filter_branch) {
+      issues.push({
+        severity: "warning",
+        operation_index: index,
+        code: "DYNAMIC_LIST_NO_FILTER",
+        message: `DYNAMIC list '${op.name}' has no filter_branch \u2014 it will match all records of the object type`
+      });
+    }
+    if (op.filter_branch) {
+      const result = RootFilterBranchSchema.safeParse(op.filter_branch);
+      if (!result.success) {
+        const zodIssues = result.error.issues.map((i) => i.message).join("; ");
+        issues.push({
+          severity: "error",
+          operation_index: index,
+          code: "INVALID_FILTER_BRANCH",
+          message: `filter_branch is invalid: ${zodIssues}. Root must be { filterBranchType: "OR", filters: [], filterBranches: [{ filterBranchType: "AND", filters: [...], filterBranches: [] }] }`
+        });
+      } else {
+        const fb = op.filter_branch;
+        if (fb.filterBranchType !== "OR") {
+          issues.push({
+            severity: "error",
+            operation_index: index,
+            code: "INVALID_FILTER_BRANCH_ROOT",
+            message: `Root filterBranchType must be "OR", got "${fb.filterBranchType}"`
+          });
+        }
+        const branches = fb.filterBranches;
+        const hasAndBranch = branches?.some((b) => b.filterBranchType === "AND");
+        if (!hasAndBranch) {
+          issues.push({
+            severity: "error",
+            operation_index: index,
+            code: "INVALID_FILTER_BRANCH_NO_AND",
+            message: `Root OR branch must contain at least one AND child branch`
+          });
+        }
+        const rootFilters = fb.filters;
+        if (rootFilters && rootFilters.length > 0) {
+          issues.push({
+            severity: "error",
+            operation_index: index,
+            code: "INVALID_FILTER_BRANCH_ROOT_FILTERS",
+            message: `Root OR branch must have an empty filters array \u2014 filters belong inside AND child branches`
+          });
+        }
+      }
+    }
     return issues;
   },
   validateEffectful: (op, index) => pipe42(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daeda/mcp-pro",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "MCP server for HubSpot CRM — sync, query, and manage your portal data",
   "type": "module",
   "bin": {