Update api client 0.12.0 catalog bulk tools

.github/workflows/publish.yml

@@ -37,8 +37,8 @@ jobs:
           node-version: 22
           cache: "pnpm"
 
-      - name: Install npm 11+ for OIDC provenance publishing
-        run: corepack enable npm && corepack install -g npm@latest
+      - name: Install npm 11 for OIDC provenance publishing
+        run: corepack enable npm && corepack install -g npm@11
         env:
           COREPACK_ENABLE_STRICT: 0
 

TOOLS.md

@@ -1,4 +1,4 @@
-# Available Iterable MCP Tools (108 tools)
+# Available Iterable MCP Tools (109 tools)
 
 **Legend:**
 - 🔒 = Requires enabling user PII access
@@ -22,7 +22,7 @@
 - **send_campaign** ✏️✉️: Send an existing scheduled campaign immediately
 - **trigger_campaign** ✏️✉️: Trigger a campaign to send to specified lists
 
-## Catalogs (12 tools)
+## Catalogs (13 tools)
 - **bulk_delete_catalog_items** ✏️: Bulk delete catalog items by their IDs
 - **create_catalog** ✏️: Create a new catalog
 - **delete_catalog** ✏️: Delete a catalog
@@ -32,9 +32,10 @@
 - **get_catalog_items**: Get items from a catalog with optional pagination and sorting
 - **get_catalogs**: Get list of all catalogs with optional pagination
 - **partial_update_catalog_item** ✏️: Partial update (PATCH) a catalog item - updates only specified fields
+- **partial_update_catalog_items** ✏️: Bulk partial update (upsert) up to 1000 catalog items. documents maps each item ID to fields to merge; omitted fields on existing items are preserved. Creates items that do not exist yet.
 - **replace_catalog_item** ✏️: Replace (PUT) a catalog item - replaces the entire item with new value
+- **replace_catalog_items** ✏️: Bulk replace (upsert) up to 1000 catalog items. documents maps each item ID to the item's complete new value; fields not included are removed from existing items. Creates items that do not exist yet.
 - **update_catalog_field_mappings** ✏️: Update catalog field mappings (data types). Valid types: boolean, date, geo_location, long, double, object, and string
-- **update_catalog_items** ✏️: Update catalog items
 
 ## Data Export (5 tools)
 - **cancel_export_job** 🔒✏️: Cancel a queued or running export job created with 'start_export_job'. Use the jobId returned from the start export endpoint.

package.json

@@ -76,7 +76,7 @@
   },
   "dependencies": {
     "@alcyone-labs/zod-to-json-schema": "4.0.10",
-    "@iterable/api": "0.11.1",
+    "@iterable/api": "0.12.0",
     "@modelcontextprotocol/sdk": "1.18.1",
     "@primno/dpapi": "2.0.1",
     "@types/json-schema": "7.0.15",

src/tool-filter.ts

@@ -59,7 +59,8 @@ export const NON_PII_TOOLS: Set<string> = new Set([
   "send_campaign",
   "trigger_campaign",
   "update_catalog_field_mappings",
-  "update_catalog_items",
+  "partial_update_catalog_items",
+  "replace_catalog_items",
   "update_email_template",
   "update_inapp_template",
   "update_push_template",

src/tools/catalogs.ts

@@ -13,9 +13,10 @@ import {
   GetCatalogItemsParamsSchema,
   GetCatalogsParamsSchema,
   PartialUpdateCatalogItemParamsSchema,
+  PartialUpdateCatalogItemsParamsSchema,
   ReplaceCatalogItemParamsSchema,
+  ReplaceCatalogItemsParamsSchema,
   UpdateCatalogFieldMappingsParamsSchema,
-  UpdateCatalogItemParamsSchema,
 } from "@iterable/api";
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 
@@ -30,10 +31,18 @@ export function createCatalogTools(client: IterableClient): Tool[] {
       execute: (params) => client.createCatalog(params),
     }),
     createTool({
-      name: "update_catalog_items",
-      description: "Update catalog items",
-      schema: UpdateCatalogItemParamsSchema,
-      execute: (params) => client.updateCatalogItems(params),
+      name: "partial_update_catalog_items",
+      description:
+        "Bulk partial update catalog items (up to 1000). Merges document fields per item ID.",
+      schema: PartialUpdateCatalogItemsParamsSchema,
+      execute: (params) => client.partialUpdateCatalogItems(params),
+    }),
+    createTool({
+      name: "replace_catalog_items",
+      description:
+        "Bulk replace catalog items (up to 1000). Each item becomes only the document fields provided.",
+      schema: ReplaceCatalogItemsParamsSchema,
+      execute: (params) => client.replaceCatalogItems(params),
     }),
     createTool({
       name: "get_catalog_item",

tests/unit/tools.test.ts

@@ -101,7 +101,8 @@ const EXPECTED_TOOLS = [
   "unsubscribe_user_by_email",
   "unsubscribe_user_by_userid",
   "update_catalog_field_mappings",
-  "update_catalog_items",
+  "partial_update_catalog_items",
+  "replace_catalog_items",
   "update_email",
   "update_email_template",
   "update_inapp_template",