@velaro/mcp-server 2.0.4 → 2.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
   "type": "module",
   "bin": {

package/parity/billing-insights.customer.js

@@ -0,0 +1,40 @@
+// velaro billing-insights (customer): billing page recommendations and the capacity-button / recommendations preferences.
+// Parity module (CLI group -> MCP tools). Site comes from the credential; only a site administrator sees or changes these.
+
+const pid = (v, n = 'id') => { const x = Number(v); if (!Number.isInteger(x) || x <= 0) throw new Error(n + ' must be a positive integer'); return x; };
+
+export const tools = [
+  {
+    name: 'billing_insights_list_recommendations',
+    description: 'List this month\'s billing recommendations for your site (usage that fits a larger plan, included features that are switched off, add-ons that match how you use Velaro). Quiet by default: at most 3 a month. Site administrators only.',
+    inputSchema: {"type":"object","properties":{}},
+  },
+  {
+    name: 'billing_insights_dismiss_recommendation',
+    description: 'Dismiss a billing recommendation. It stays hidden until the numbers behind it change.',
+    inputSchema: {"type":"object","properties":{"id":{"type":"integer","description":"Recommendation id from billing_insights_list_recommendations"}},"required":["id"]},
+  },
+  {
+    name: 'billing_insights_get_preferences',
+    description: 'Show whether the Add capacity / Compare plans buttons are hidden and whether recommendations are on for your site.',
+    inputSchema: {"type":"object","properties":{}},
+  },
+  {
+    name: 'billing_insights_set_preferences',
+    description: 'Hide or show the Add capacity / Compare plans buttons, and turn billing recommendations on or off for your whole site. Site administrators only.',
+    inputSchema: {"type":"object","properties":{"hideCapacityButtons":{"type":"boolean","description":"Hide the Add capacity and Compare plans buttons"},"recommendationsEnabled":{"type":"boolean","description":"Turn billing recommendations on or off"}}},
+  },
+];
+
+export const handlers = {
+  billing_insights_list_recommendations: async (_a, ctx) => ctx.api('GET', '/BillingInsights/recommendations'),
+  billing_insights_dismiss_recommendation: async (a, ctx) => ctx.api('POST', '/BillingInsights/recommendations/' + pid(a.id) + '/dismiss', {}),
+  billing_insights_get_preferences: async (_a, ctx) => ctx.api('GET', '/BillingInsights/preferences'),
+  billing_insights_set_preferences: async (a, ctx) => {
+    const body = {};
+    if (a.hideCapacityButtons !== undefined) body.hideCapacityButtons = a.hideCapacityButtons === true || a.hideCapacityButtons === 'true';
+    if (a.recommendationsEnabled !== undefined) body.recommendationsEnabled = a.recommendationsEnabled === true || a.recommendationsEnabled === 'true';
+    if (Object.keys(body).length === 0) throw new Error('Provide hideCapacityButtons and/or recommendationsEnabled');
+    return ctx.api('PUT', '/BillingInsights/preferences', body);
+  },
+};

package/parity/capability-authority.customer.js

@@ -0,0 +1,43 @@
+// velaro authority get|set|history|revert: which system the AI uses when two connected systems overlap
+// (capability authority, today realtime_stock). Site comes from the credential. Parity module (CLI group -> MCP tools).
+
+const enc = encodeURIComponent;
+const cap = (a) => {
+  const c = String(a.capability ?? '').trim();
+  if (!/^[a-z][a-z0-9_]*$/.test(c)) throw new Error('capability must be a snake_case name such as realtime_stock');
+  return enc(c);
+};
+
+const CAP = { capability: { type: 'string', description: 'Capability name, e.g. realtime_stock' } };
+
+export const tools = [
+  {
+    name: 'capability_authority_get',
+    description: 'List capability authority rules (which system wins when two overlap, e.g. ERP stock over storefront stock) with the current mode for this site, plus the last 10 changes for the named capability when capability is given.',
+    inputSchema: {"type":"object","properties":{...CAP}},
+  },
+  {
+    name: 'capability_authority_set',
+    description: 'Set a capability authority mode: "default" (Velaro rule applies) or "off" (keep both tools for this site). Administrator only; logged and revertable.',
+    inputSchema: {"type":"object","properties":{...CAP,"mode":{"type":"string","enum":["default","off"]}},"required":["capability","mode"]},
+  },
+  {
+    name: 'capability_authority_revert',
+    description: 'Revert the last change to a capability authority mode. Administrator only; errors (409) when there is nothing to revert.',
+    inputSchema: {"type":"object","properties":{...CAP},"required":["capability"]},
+  },
+];
+
+export const handlers = {
+  capability_authority_get: async (a, ctx) => {
+    const list = await ctx.messagingGet('/CapabilityAuthority');
+    if (!a.capability) return list;
+    const history = await ctx.messagingGet('/CapabilityAuthority/' + cap(a) + '/History');
+    return { ...list, history: history?.history ?? [] };
+  },
+  capability_authority_set: async (a, ctx) => {
+    if (a.mode !== 'default' && a.mode !== 'off') throw new Error('mode must be "default" or "off"');
+    return ctx.messagingPut('/CapabilityAuthority/' + cap(a), { mode: a.mode });
+  },
+  capability_authority_revert: async (a, ctx) => ctx.messagingPost('/CapabilityAuthority/' + cap(a) + '/Revert', {}),
+};

package/parity/commerce-routing.customer.js

@@ -0,0 +1,38 @@
+// MCP parity for `velaro commerce-routing` (cli/lib/commands/commerce-routing.js). The site comes from the credential only (tenant isolation).
+const CAPABILITIES = ['product_search', 'order_status', 'stock_check', 'customer_lookup'];
+const SYSTEMS = ['magento', 'shopify', 'bigcommerce', 'woocommerce', 'netsuite'];
+
+export const tools = [
+  {
+    name: 'commerce_routing_get',
+    description: 'Show which connected commerce system the AI asks first for each kind of question (product questions, order status, stock, customer lookups) when the site has more than one connected, with the default and any override. Lives in velaro-messaging (GET /CommerceRouting).',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'commerce_routing_set',
+    description: 'Set or clear the per-capability first-choice commerce system for this site. Capabilities left out are cleared back to the default; an empty preferred object clears everything. Site administrators only. Lives in velaro-messaging (PUT /CommerceRouting).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        preferred: {
+          type: 'object',
+          description: `Map of capability (${CAPABILITIES.join(', ')}) to system (${SYSTEMS.join(', ')}).`,
+          additionalProperties: { type: 'string', enum: SYSTEMS },
+        },
+      },
+      required: ['preferred'],
+    },
+  },
+];
+
+export const handlers = {
+  commerce_routing_get: async (_a, ctx) => ctx.messagingGet('/CommerceRouting'),
+  commerce_routing_set: async (a, ctx) => {
+    const preferred = a?.preferred ?? {};
+    for (const [cap, sys] of Object.entries(preferred)) {
+      if (!CAPABILITIES.includes(cap)) throw new Error(`Unknown capability '${cap}'. Use one of: ${CAPABILITIES.join(', ')}`);
+      if (!SYSTEMS.includes(String(sys).toLowerCase())) throw new Error(`Unknown system '${sys}'. Use one of: ${SYSTEMS.join(', ')}`);
+    }
+    return ctx.messagingPut('/CommerceRouting', { preferred });
+  },
+};

package/parity/site-sale.customer.js

@@ -0,0 +1,107 @@
+// MCP parity for `velaro site-sale` (cli/lib/commands/site-sale.js): Current Sales (time-boxed bot override Q&A +
+// per-customer coupons). Site comes from the credential, never an argument.
+export const tools = [
+  {
+    name: 'site_sale_list',
+    description: "List this site's Current Sales (temporary sales or discounts the bot answers about deterministically until they end).",
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'site_sale_create',
+    description: 'Create a Current Sale: while active, the bot answers sales, discount and coupon questions from this definition and can issue per-customer coupons (Magento sites mint a real cart price rule). It stops at the end time. Times are UTC; convert from Pacific.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name:             { type: 'string', description: 'Sale name shown to customers' },
+        description:      { type: 'string', description: 'Short description the bot can quote' },
+        appliesTo:        { type: 'string', enum: ['all','category','products'], description: 'Scope of the sale' },
+        appliesToValue:   { type: 'string', description: 'Category name or comma-separated product identifiers when appliesTo is category or products' },
+        discountType:     { type: 'string', enum: ['percentage','fixed_amount','free_shipping'], description: 'Kind of discount' },
+        discountValue:    { type: 'number', description: 'Percent or fixed amount (ignored for free_shipping)' },
+        startsAtUtc:      { type: 'string', description: 'ISO 8601 start time in UTC (convert from Pacific)' },
+        endsAtUtc:        { type: 'string', description: 'ISO 8601 end time in UTC; the sale stops answering at this time' },
+        couponCode:       { type: 'string', description: 'Optional shared coupon code' },
+        autoGenerateCoupons:   { type: 'boolean', description: 'Let the bot issue a unique coupon per customer' },
+        maxCouponsPerCustomer: { type: 'number', description: 'Max coupons the bot issues to one customer' },
+        couponUsageLimit:      { type: 'number', description: 'Times each coupon can be used' },
+        couponExpiresHours:    { type: 'number', description: 'Hours before an issued coupon expires' },
+      },
+      required: ['name', 'discountType', 'startsAtUtc', 'endsAtUtc'],
+    },
+  },
+  {
+    name: 'site_sale_update',
+    description: 'Update a Current Sale by id. Omit a field to leave it unchanged.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Sale ID from site_sale_list. Required.' },
+        name:             { type: 'string', description: 'Sale name shown to customers' },
+        description:      { type: 'string', description: 'Short description the bot can quote' },
+        appliesTo:        { type: 'string', enum: ['all','category','products'], description: 'Scope of the sale' },
+        appliesToValue:   { type: 'string', description: 'Category name or comma-separated product identifiers when appliesTo is category or products' },
+        discountType:     { type: 'string', enum: ['percentage','fixed_amount','free_shipping'], description: 'Kind of discount' },
+        discountValue:    { type: 'number', description: 'Percent or fixed amount (ignored for free_shipping)' },
+        startsAtUtc:      { type: 'string', description: 'ISO 8601 start time in UTC (convert from Pacific)' },
+        endsAtUtc:        { type: 'string', description: 'ISO 8601 end time in UTC; the sale stops answering at this time' },
+        couponCode:       { type: 'string', description: 'Optional shared coupon code' },
+        autoGenerateCoupons:   { type: 'boolean', description: 'Let the bot issue a unique coupon per customer' },
+        maxCouponsPerCustomer: { type: 'number', description: 'Max coupons the bot issues to one customer' },
+        couponUsageLimit:      { type: 'number', description: 'Times each coupon can be used' },
+        couponExpiresHours:    { type: 'number', description: 'Hours before an issued coupon expires' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'site_sale_end',
+    description: 'End a Current Sale now. The bot stops answering from it immediately.',
+    inputSchema: {
+      type: 'object',
+      properties: { id: { type: 'number', description: 'Sale ID. Required.' } },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'site_sale_delete',
+    description: 'Delete a Current Sale by id.',
+    inputSchema: {
+      type: 'object',
+      properties: { id: { type: 'number', description: 'Sale ID. Required.' } },
+      required: ['id'],
+    },
+  },
+];
+
+// Field names must match the SiteSales request on the messaging API exactly (undefined is dropped by JSON).
+const saleBody = (a) => ({
+  name: a.name,
+  description: a.description,
+  appliesTo: a.appliesTo,
+  appliesToValue: a.appliesToValue,
+  discountType: a.discountType,
+  discountValue: a.discountValue,
+  startsAtUtc: a.startsAtUtc,
+  endsAtUtc: a.endsAtUtc,
+  couponCode: a.couponCode,
+  autoGenerateCoupons: a.autoGenerateCoupons,
+  maxCouponsPerCustomer: a.maxCouponsPerCustomer,
+  couponUsageLimit: a.couponUsageLimit,
+  couponExpiresHours: a.couponExpiresHours,
+});
+
+const saleId = (a) => {
+  if (a.id == null) throw new Error('id is required.');
+  return encodeURIComponent(a.id);
+};
+
+export const handlers = {
+  site_sale_list: async (_a, ctx) => ctx.messagingGet('/SiteSales'),
+  site_sale_create: async (a, ctx) => {
+    if (!a.name || !a.discountType || !a.startsAtUtc || !a.endsAtUtc) throw new Error('name, discountType, startsAtUtc and endsAtUtc are required.');
+    return ctx.messagingPost('/SiteSales', saleBody(a));
+  },
+  site_sale_update: async (a, ctx) => ctx.messagingPut(`/SiteSales/${saleId(a)}`, saleBody(a)),
+  site_sale_end: async (a, ctx) => ctx.messagingPost(`/SiteSales/${saleId(a)}/end`, {}),
+  site_sale_delete: async (a, ctx) => ctx.messagingDel(`/SiteSales/${saleId(a)}`),
+};

package/parity/sms.customer.js

@@ -0,0 +1,78 @@
+// MCP parity for `velaro sms tollfree` (cli/lib/commands/sms.js). Site from the credential only.
+// Backend: velaro-messaging Sms/TollFree (SmsTollFreeController -> TollFreeSmsService). Text-enables a toll-free number the
+// site already owns (for example an 833 line whose calls run on Microsoft Teams Phone): Twilio hosts the SMS side only.
+const address = {
+  street: { type: 'string' },
+  city: { type: 'string' },
+  region: { type: 'string', description: 'State or province' },
+  postalCode: { type: 'string' },
+  country: { type: 'string', description: 'Two-letter country (default US)' },
+};
+
+export const tools = [
+  {
+    name: 'sms_tollfree_status',
+    description: 'Status of texting on one of your toll-free numbers: hosting order, text-enabled, in your Inbox, carrier verification, and whether it can send texts. When hosting has completed this also adds the Inbox channel.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        phoneNumber: { type: 'string', description: 'E.164, e.g. +18335550100' },
+        teamId: { type: 'number', description: 'Team whose Inbox receives the texts (default first team).' },
+      },
+      required: ['phoneNumber'],
+    },
+  },
+  {
+    name: 'sms_tollfree_host',
+    description: 'Request texting on a toll-free number you already own (calls stay with your phone system). Twilio emails the contact a letter of authorization to sign.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        phoneNumber: { type: 'string' },
+        teamId: { type: 'number' },
+        businessName: { type: 'string' },
+        contactName: { type: 'string' },
+        contactEmail: { type: 'string' },
+        contactPhone: { type: 'string' },
+        ...address,
+      },
+      required: ['phoneNumber', 'businessName', 'contactEmail', 'contactPhone', 'street', 'city', 'region', 'postalCode'],
+    },
+  },
+  {
+    name: 'sms_tollfree_verify',
+    description: 'Submit the carrier toll-free verification for a text-enabled toll-free number (required before US carriers deliver its texts).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        phoneNumber: { type: 'string' },
+        businessName: { type: 'string' },
+        businessWebsite: { type: 'string' },
+        notificationEmail: { type: 'string' },
+        useCaseCategories: { type: 'array', items: { type: 'string' }, description: 'e.g. CUSTOMER_CARE, ACCOUNT_NOTIFICATIONS' },
+        useCaseSummary: { type: 'string' },
+        productionMessageSample: { type: 'string' },
+        optInType: { type: 'string', enum: ['VERBAL', 'WEB_FORM', 'PAPER_FORM', 'VIA_TEXT', 'MOBILE_QR_CODE'] },
+        optInImageUrls: { type: 'array', items: { type: 'string' } },
+        messageVolume: { type: 'string', description: 'e.g. 1,000' },
+        contactFirstName: { type: 'string' },
+        contactLastName: { type: 'string' },
+        contactEmail: { type: 'string' },
+        contactPhone: { type: 'string' },
+        additionalInformation: { type: 'string' },
+        ...address,
+      },
+      required: ['phoneNumber'],
+    },
+  },
+];
+
+export const handlers = {
+  sms_tollfree_status: async (a, ctx) => {
+    if (!a.phoneNumber) throw new Error('phoneNumber is required.');
+    const team = a.teamId ? '&teamId=' + encodeURIComponent(a.teamId) : '';
+    return ctx.messagingGet('/Sms/TollFree/Status?phoneNumber=' + encodeURIComponent(a.phoneNumber) + team);
+  },
+  sms_tollfree_host: async (a, ctx) => ctx.messagingPost('/Sms/TollFree/Host', a),
+  sms_tollfree_verify: async (a, ctx) => ctx.messagingPost('/Sms/TollFree/Verification', a),
+};

package/server.js

@@ -4075,77 +4075,6 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['contactId'],
     },
   },
-  // -- Current Sales (time-boxed bot override Q&A + per-customer coupons). Site comes from the credential, never an arg. --
-  {
-    name: 'site_sale_list',
-    description: "List this site's Current Sales (temporary sales or discounts the bot answers about deterministically until they end).",
-    inputSchema: { type: 'object', properties: {}, required: [] },
-  },
-  {
-    name: 'site_sale_create',
-    description: 'Create a Current Sale: while active, the bot answers sales, discount and coupon questions from this definition and can issue per-customer coupons (Magento sites mint a real cart price rule). It stops at the end time. Times are UTC; convert from Pacific.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        name:             { type: 'string', description: 'Sale name shown to customers' },
-        description:      { type: 'string', description: 'Short description the bot can quote' },
-        appliesTo:        { type: 'string', enum: ['all','category','products'], description: 'Scope of the sale' },
-        appliesToValue:   { type: 'string', description: 'Category name or comma-separated product identifiers when appliesTo is category or products' },
-        discountType:     { type: 'string', enum: ['percentage','fixed_amount','free_shipping'], description: 'Kind of discount' },
-        discountValue:    { type: 'number', description: 'Percent or fixed amount (ignored for free_shipping)' },
-        startsAtUtc:      { type: 'string', description: 'ISO 8601 start time in UTC (convert from Pacific)' },
-        endsAtUtc:        { type: 'string', description: 'ISO 8601 end time in UTC; the sale stops answering at this time' },
-        couponCode:       { type: 'string', description: 'Optional shared coupon code' },
-        autoGenerateCoupons:   { type: 'boolean', description: 'Let the bot issue a unique coupon per customer' },
-        maxCouponsPerCustomer: { type: 'number', description: 'Max coupons the bot issues to one customer' },
-        couponUsageLimit:      { type: 'number', description: 'Times each coupon can be used' },
-        couponExpiresHours:    { type: 'number', description: 'Hours before an issued coupon expires' },
-      },
-      required: ['name', 'discountType', 'startsAtUtc', 'endsAtUtc'],
-    },
-  },
-  {
-    name: 'site_sale_update',
-    description: 'Update a Current Sale by id. Omit a field to leave it unchanged.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        id: { type: 'number', description: 'Sale ID from site_sale_list. Required.' },
-        name:             { type: 'string', description: 'Sale name shown to customers' },
-        description:      { type: 'string', description: 'Short description the bot can quote' },
-        appliesTo:        { type: 'string', enum: ['all','category','products'], description: 'Scope of the sale' },
-        appliesToValue:   { type: 'string', description: 'Category name or comma-separated product identifiers when appliesTo is category or products' },
-        discountType:     { type: 'string', enum: ['percentage','fixed_amount','free_shipping'], description: 'Kind of discount' },
-        discountValue:    { type: 'number', description: 'Percent or fixed amount (ignored for free_shipping)' },
-        startsAtUtc:      { type: 'string', description: 'ISO 8601 start time in UTC (convert from Pacific)' },
-        endsAtUtc:        { type: 'string', description: 'ISO 8601 end time in UTC; the sale stops answering at this time' },
-        couponCode:       { type: 'string', description: 'Optional shared coupon code' },
-        autoGenerateCoupons:   { type: 'boolean', description: 'Let the bot issue a unique coupon per customer' },
-        maxCouponsPerCustomer: { type: 'number', description: 'Max coupons the bot issues to one customer' },
-        couponUsageLimit:      { type: 'number', description: 'Times each coupon can be used' },
-        couponExpiresHours:    { type: 'number', description: 'Hours before an issued coupon expires' },
-      },
-      required: ['id'],
-    },
-  },
-  {
-    name: 'site_sale_end',
-    description: 'End a Current Sale now. The bot stops answering from it immediately.',
-    inputSchema: {
-      type: 'object',
-      properties: { id: { type: 'number', description: 'Sale ID. Required.' } },
-      required: ['id'],
-    },
-  },
-  {
-    name: 'site_sale_delete',
-    description: 'Delete a Current Sale by id.',
-    inputSchema: {
-      type: 'object',
-      properties: { id: { type: 'number', description: 'Sale ID. Required.' } },
-      required: ['id'],
-    },
-  },
   {
     name: 'pickup_get_config',
     description: 'Get this site\'s Pickup & Reminder Texting configuration (default cadence, max reminders, message template, enabled state, quiet-hours override). Returns null/404 if no config has been created yet -- use pickup_update_config to create one.',
@@ -8446,66 +8375,6 @@ ${JSON.stringify(result, null, 2)}`;
       return JSON.stringify(history, null, 2);
     }
 
-    case 'site_sale_list': {
-      const result = await messagingGet('/SiteSales');
-      return JSON.stringify(result, null, 2);
-    }
-
-    case 'site_sale_create': {
-      if (!args.name || !args.discountType || !args.startsAtUtc || !args.endsAtUtc) return 'name, discountType, startsAtUtc and endsAtUtc are required.';
-      // Field names must match the SiteSales request on the messaging API exactly (undefined is dropped by JSON).
-      const body = {
-        name: args.name,
-        description: args.description,
-        appliesTo: args.appliesTo,
-        appliesToValue: args.appliesToValue,
-        discountType: args.discountType,
-        discountValue: args.discountValue,
-        startsAtUtc: args.startsAtUtc,
-        endsAtUtc: args.endsAtUtc,
-        couponCode: args.couponCode,
-        autoGenerateCoupons: args.autoGenerateCoupons,
-        maxCouponsPerCustomer: args.maxCouponsPerCustomer,
-        couponUsageLimit: args.couponUsageLimit,
-        couponExpiresHours: args.couponExpiresHours,
-      };
-      const result = await messagingPost('/SiteSales', body);
-      return JSON.stringify(result, null, 2);
-    }
-
-    case 'site_sale_update': {
-      if (args.id == null) return 'id is required.';
-      const body = {
-        name: args.name,
-        description: args.description,
-        appliesTo: args.appliesTo,
-        appliesToValue: args.appliesToValue,
-        discountType: args.discountType,
-        discountValue: args.discountValue,
-        startsAtUtc: args.startsAtUtc,
-        endsAtUtc: args.endsAtUtc,
-        couponCode: args.couponCode,
-        autoGenerateCoupons: args.autoGenerateCoupons,
-        maxCouponsPerCustomer: args.maxCouponsPerCustomer,
-        couponUsageLimit: args.couponUsageLimit,
-        couponExpiresHours: args.couponExpiresHours,
-      };
-      const result = await messagingPut(`/SiteSales/${encodeURIComponent(args.id)}`, body);
-      return JSON.stringify(result, null, 2);
-    }
-
-    case 'site_sale_end': {
-      if (args.id == null) return 'id is required.';
-      const result = await messagingPost(`/SiteSales/${encodeURIComponent(args.id)}/end`, {});
-      return JSON.stringify(result, null, 2);
-    }
-
-    case 'site_sale_delete': {
-      if (args.id == null) return 'id is required.';
-      const result = await messagingDel(`/SiteSales/${encodeURIComponent(args.id)}`);
-      return JSON.stringify(result, null, 2);
-    }
-
     case 'pickup_get_config': {
       const config = await messagingGet('/PickupNotifications/Config').catch(err => {
         if (String(err.message).includes(' 404')) return null;

package/tool-annotations.js

@@ -25,6 +25,7 @@ const MUTATING = new Set([
   'routing_team_update_config', 'pickup_update_config', 'payment_recovery_update_config',
   'recruiting_sync_jobs', 'ai_config_set_reply_format', 'magento_set_sidebar_fields',
   'zoom_phone_set_config',
+  'billing_insights_set_preferences', 'billing_insights_dismiss_recommendation',
   'site_sale_create', 'site_sale_update', 'site_sale_end',
 ]);