@velaro/mcp-server 0.6.72 → 0.6.73

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.72",
+  "version": "0.6.73",
   "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

@@ -2103,6 +2103,33 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['reportType', 'isEnabled'],
     },
   },
+  {
+    name: 'report_subscriptions_list',
+    description: "List the caller's own scheduled report email subscriptions (velaro-messaging /report-subscriptions): id, report type, frequency, active, delivery hour, format (pdf/html), extra recipients.",
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'report_subscription_update',
+    description: "Update one of the caller's report subscriptions by id. Only passed fields change. Extra recipients must be other users on the same account (max 10); pass an empty string to clear.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id:                { type: 'number', description: 'Subscription id from report_subscriptions_list' },
+        frequency:         { type: 'string', enum: ['daily', 'weekly', 'bi-monthly', 'monthly'] },
+        deliveryHour:      { type: 'number', description: 'Site-local hour 0-23 to deliver at or after' },
+        clearDeliveryHour: { type: 'boolean', description: 'Remove the delivery hour (send at the first run)' },
+        format:            { type: 'string', enum: ['pdf', 'html'] },
+        extraRecipients:   { type: 'string', description: 'Comma-separated emails; empty string clears' },
+        isActive:          { type: 'boolean', description: 'false pauses, true resumes' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'report_subscription_delete',
+    description: "Delete one of the caller's report subscriptions by id (not by report type).",
+    inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Subscription id' } }, required: ['id'] },
+  },
   {
     name: 'report_export_status',
     description: 'Check the status of a queued async report export (Reports/ExportStatus/{id}) — pending/processing/completed/failed and the download URL once ready.',
@@ -6901,6 +6928,33 @@ async function handleTool(name, args) {
         : `Failed to save schedule for "${args.reportType}".`;
     }
 
+    case 'report_subscriptions_list': {
+      const rows = await messagingGet('/report-subscriptions');
+      if (!Array.isArray(rows) || !rows.length) return 'No report subscriptions.';
+      return rows.map(x =>
+        `#${x.id} ${x.reportType}: ${x.isActive ? 'active' : 'paused'}, ${x.frequency}, ${x.deliveryHour == null ? 'any hour' : String(x.deliveryHour).padStart(2, '0') + ':00'}, ${x.format ?? 'pdf'}${x.extraRecipients ? ' | also to ' + x.extraRecipients : ''}`
+      ).join('\n');
+    }
+
+    case 'report_subscription_update': {
+      if (!Number.isInteger(args.id)) return 'Error: id is required.';
+      const body = {};
+      for (const k of ['frequency', 'format', 'extraRecipients', 'isActive', 'clearDeliveryHour']) if (args[k] !== undefined) body[k] = args[k];
+      if (args.deliveryHour !== undefined) {
+        if (!Number.isInteger(args.deliveryHour) || args.deliveryHour < 0 || args.deliveryHour > 23) return 'Error: deliveryHour must be an integer 0-23.';
+        body.deliveryHour = args.deliveryHour;
+      }
+      if (!Object.keys(body).length) return 'Error: pass at least one field to update.';
+      await messagingRequest('PUT', `/report-subscriptions/${args.id}`, body);
+      return `Subscription #${args.id} updated.`;
+    }
+
+    case 'report_subscription_delete': {
+      if (!Number.isInteger(args.id)) return 'Error: id is required.';
+      await messagingRequest('DELETE', `/report-subscriptions/${args.id}`);
+      return `Subscription #${args.id} deleted.`;
+    }
+
     case 'report_export_status': {
       if (!args.exportId) return 'Error: exportId is required.';
       const s = await api('GET', `/Reports/ExportStatus/${args.exportId}`);