@velaro/mcp-server 2.0.2 → 2.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "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/server.js

@@ -4063,6 +4063,77 @@ 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.',
@@ -8341,6 +8412,66 @@ ${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',
+  'site_sale_create', 'site_sale_update', 'site_sale_end',
 ]);
 
 // Names that look like writes but only read (checked before the write rules).