@velaro/mcp-server 0.6.61 → 0.6.62

package/package.json

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

@@ -2535,6 +2535,18 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['siteId'],
     },
   },
+  {
+    name: 'experience_impact_report',
+    description: 'Experience Impact report: shows how staffing and schedule adherence affect customer experience. Returns a 0-100 experience index (adherence 25, service level 30, missed-chat rate 20, CSAT 25), per-interval staffing vs chat demand (scheduled vs actual agents, missed chats, wait time, CSAT), per-agent rows, and plain-language insights. Scoped to the caller site.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        from:   { type: 'string', description: 'yyyy-MM-dd start (default: 7 days ago).' },
+        to:     { type: 'string', description: 'yyyy-MM-dd end (default: today).' },
+        teamId: { type: 'number', description: 'Optional team ID to narrow the report.' },
+      },
+    },
+  },
   // -- Staff: schedule adherence by site + role (SupportTools-style: explicit siteId, never auth-derived) --
   // Backend: velaro-messaging ReportsController.ScheduleAdherenceDiagnosticsAsync, gated by
   // IsSuperAdminAsync(allowSupport: true) -> 403 for non-staff. role=agent REQUIRES agentId (fails closed).
@@ -7205,6 +7217,22 @@ async function handleTool(name, args) {
       ).join('\n');
     }
 
+    case 'experience_impact_report': {
+      const qs = new URLSearchParams();
+      for (const k of ['from', 'to', 'teamId']) if (args[k] != null && args[k] !== '') qs.set(k, String(args[k]));
+      const r = await messagingGet(`/Reports/experience-impact${qs.toString() ? '?' + qs : ''}`);
+      const sm = r.summary ?? {};
+      const lines = [
+        `=== Experience Impact ${r.range?.from ?? ''}..${r.range?.to ?? ''} ===`,
+        `Experience index: ${sm.experienceIndex ?? '-'} / 100`,
+        `Adherence ${sm.adherencePct ?? '-'}% | Service level ${sm.serviceLevelPct ?? '-'}% | Missed chats ${sm.missedChats ?? '-'} | Avg wait ${sm.avgWaitSec ?? '-'}s | CSAT ${sm.csatAvg ?? '-'} (${sm.csatResponses ?? 0} responses)`,
+        ...(r.insights ?? []).map(i => `  [${i.severity}] ${i.text}`),
+        `Intervals: ${(r.intervals ?? []).length} | Agents: ${(r.agents ?? []).length}`,
+      ];
+      for (const a of r.agents ?? []) lines.push(`  ${a.name}: index ${a.experienceIndex} | adherence ${a.adherencePct}% | CSAT ${a.csatAvg ?? '-'} | handled ${a.handled}`);
+      return lines.join('\n');
+    }
+
     case 'support_schedule_adherence': {
       if (args.role === 'agent' && !args.agentId) throw new Error('agentId is required when role=agent');
       const qs = new URLSearchParams({ detail: 'true' });