@velaro/mcp-server 0.6.83 → 0.6.85

package/package.json

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

@@ -2290,6 +2290,21 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
 
   // ── Campaign Deliverability Intelligence ─────────────────────────────────
+  {
+    name: 'sender_domain_health',
+    description: 'Health of your email sending domains: registration expiry date, DNS records present/missing, email-provider verification, open notices with what to do, and recent history.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'sender_domain_health_settings',
+    description: 'View or change sender-domain health warning days and the grace days after expiry before sending pauses (per-site override; reset=true returns to the account default).',
+    inputSchema: { type: 'object', properties: { thresholds: { type: 'string', description: 'Comma-separated days, e.g. 60,30,14,7,3,1' }, graceDays: { type: 'number' }, reset: { type: 'boolean' } } },
+  },
+  {
+    name: 'sender_domain_health_dismiss',
+    description: 'Dismiss a sender-domain health notice by event id (do not remind me). It clears on its own once resolved.',
+    inputSchema: { type: 'object', properties: { eventId: { type: 'number' } }, required: ['eventId'] },
+  },
   {
     name: 'campaign_sender_auth',
     description: 'Check SPF, DKIM, DMARC, BIMI, and MX DNS records for a sending domain. Returns pass/warn/fail per record with details and an overall auth score 0-100.',
@@ -3592,6 +3607,51 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: [],
     },
   },
+  {
+    name: 'status_incident_list',
+    description: 'Velaro staff only (SuperAdmin). Lists public status page incidents, including component overrides (IncidentType "Override").',
+    inputSchema: { type: 'object', properties: { filter: { type: 'string', enum: ['active', 'resolved', 'all'], description: 'Default active.' } }, required: [] },
+  },
+  {
+    name: 'status_incident_upsert',
+    description: 'Velaro staff only (SuperAdmin). Creates a public status incident, or updates one when id is given (update replaces all fields, so pass every field to keep). AffectedServices is a comma-separated list of component names (Messaging, Voice & Calls, AI Assistant, Database, API, Integrations, Email Campaigns, Velaro Sign, Velaro Forms, Agent Console, Core API, Chat Engagement) plus optional uptime tokens: "counts-uptime" forces the incident to count against uptime, "no-uptime-impact" forces it not to. Default: only a core chat outage counts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Existing incident id to update; omit to create.' },
+        title: { type: 'string' }, description: { type: 'string' },
+        status: { type: 'string', description: 'Investigating, Identified, Monitoring, Resolved' },
+        incidentType: { type: 'string', description: 'Incident or Maintenance' },
+        severity: { type: 'string', description: 'Minor or Major' },
+        affectedServices: { type: 'string', description: 'CSV of component names plus optional counts-uptime / no-uptime-impact.' },
+        affectedRegions: { type: 'string' },
+        endTime: { type: 'string', description: 'ISO timestamp' },
+        excludeFromUptime: { type: 'boolean' },
+        isVisibleToCustomers: { type: 'boolean' },
+      },
+      required: [],
+    },
+  },
+  {
+    name: 'status_incident_delete',
+    description: 'Velaro staff only (SuperAdmin). Deletes a status incident, or clears a component override created by status_override_set.',
+    inputSchema: { type: 'object', properties: { id: { type: 'number' } }, required: ['id'] },
+  },
+  {
+    name: 'status_override_set',
+    description: 'Velaro staff only (SuperAdmin). Forces a public status page component to a status until expiresAt. Components: Messaging, Voice & Calls, AI Assistant, Database, API, Integrations, Email Campaigns, Velaro Sign, Velaro Forms, Agent Console, Core API, Chat Engagement. countsAgainstUptime: true adds the counts-uptime token, false adds no-uptime-impact, omit for default (only a core chat outage counts). Clear with status_incident_delete.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        component: { type: 'string' },
+        status: { type: 'string', enum: ['operational', 'degraded', 'outage', 'maintenance'] },
+        note: { type: 'string' },
+        expiresAt: { type: 'string', description: 'ISO timestamp the override auto-clears.' },
+        countsAgainstUptime: { type: 'boolean' },
+      },
+      required: ['component', 'status'],
+    },
+  },
   {
     name: 'signalr_diagnostics',
     description: 'Check health, connection counts, hub stats, and recent errors for Velaro\'s Azure SignalR Service instances. Covers both the infra-prod instance (velaro-eastus-prd-signalr, Premium P1) and the legacy prod instance (velaro-prod-us). Use this to diagnose "hub down", connection storms, capacity issues, or capacity saturation alerts.',
@@ -7522,6 +7582,28 @@ async function handleTool(name, args) {
     }
 
     // ── Campaign Deliverability Intelligence ─────────────────────────────
+    case 'sender_domain_health': {
+      const r = await api('GET', '/SenderDomains/Health');
+      const lines = (r.domains || []).map(d => `${d.domainName} [${d.healthStatus}] status=${d.status} expires=${d.registrationExpiresOn ? d.registrationExpiresOn.slice(0, 10) + ' (' + d.daysToExpiry + 'd)' : 'unknown'}${d.healthDetail ? '\n   ' + d.healthDetail : ''}`);
+      for (const n of (r.notices || [])) lines.push(`ACTION NEEDED ${n.domainName}: ${n.message} | ${n.remedy}`);
+      lines.push(`Warnings at ${r.settings.thresholds.join('/')} days; sending pauses ${r.settings.graceDays}d after expiry.`);
+      return lines.join('\n');
+    }
+
+    case 'sender_domain_health_settings': {
+      if (args.reset || args.thresholds || args.graceDays !== undefined) {
+        const r = await api('PUT', '/SenderDomains/Health/Settings', { thresholds: args.thresholds, graceDays: args.graceDays, reset: args.reset });
+        return JSON.stringify(r);
+      }
+      const h = await api('GET', '/SenderDomains/Health');
+      return JSON.stringify(h.settings);
+    }
+
+    case 'sender_domain_health_dismiss': {
+      if (!args.eventId) return 'Error: eventId required';
+      return JSON.stringify(await api('POST', `/SenderDomains/Health/Events/${args.eventId}/Dismiss`, {}));
+    }
+
     case 'campaign_sender_auth': {
       const domain = args.domain;
       if (!domain) return 'Error: domain required';
@@ -8543,6 +8625,30 @@ async function handleTool(name, args) {
       return JSON.stringify(data, null, 2);
     }
 
+    case 'status_incident_list': {
+      const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${encodeURIComponent(args.filter || 'active')}`);
+      return JSON.stringify(rows, null, 2);
+    }
+
+    case 'status_incident_upsert': {
+      const body = {
+        title: args.title, description: args.description, status: args.status, incidentType: args.incidentType, severity: args.severity,
+        affectedServices: args.affectedServices, affectedRegions: args.affectedRegions, endTime: args.endTime,
+        excludeFromUptime: args.excludeFromUptime ?? false, isVisibleToCustomers: args.isVisibleToCustomers ?? true,
+      };
+      if (args.id) return JSON.stringify(await messagingRequest('PUT', `/superadmin/status-incidents/${Number(args.id)}`, body), null, 2);
+      if (!args.title) throw new Error('title is required when creating an incident.');
+      return JSON.stringify(await messagingRequest('POST', '/superadmin/status-incidents', body), null, 2);
+    }
+
+    case 'status_incident_delete':
+      return JSON.stringify(await messagingRequest('DELETE', `/superadmin/status-incidents/${Number(args.id)}`), null, 2);
+
+    case 'status_override_set':
+      return JSON.stringify(await messagingRequest('POST', '/superadmin/status-overrides', {
+        component: args.component, status: args.status, note: args.note || '', expiresAt: args.expiresAt ?? null, countsAgainstUptime: args.countsAgainstUptime ?? null,
+      }), null, 2);
+
     case 'signalr_diagnostics': {
       // Parse a SignalR connection string into { endpoint, accessKey }
       function parseSignalRConn(conn) {