@velaro/mcp-server 0.6.82 → 0.6.84

package/package.json

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

@@ -492,6 +492,38 @@ const TOOLS = [
     description: 'List all KB topics. Call this first to find the topicId needed for creating articles.',
     inputSchema: { type: 'object', properties: {}, required: [] },
   },
+  {
+    name: 'kb_list_categories',
+    description: 'List KB categories. Topics hang under a category; use with kb_create_topic.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'kb_create_category',
+    description: 'Create a KB category. Seed the topic tree (category -> topic) BEFORE creating articles when the right topic does not exist.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name:     { type: 'string', description: 'Category name' },
+        priority: { type: 'number', description: 'Display priority (lower sorts first)' },
+        icon:     { type: 'string', description: 'Optional icon name' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'kb_create_topic',
+    description: 'Create a KB topic under a category and return its id for kb_create_article.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name:       { type: 'string', description: 'Topic name' },
+        slug:       { type: 'string', description: 'URL slug' },
+        categoryId: { type: 'string', description: 'Category id from kb_list_categories' },
+        priority:   { type: 'number', description: 'Display priority (lower sorts first)' },
+      },
+      required: ['name', 'slug'],
+    },
+  },
   {
     name: 'kb_search_articles',
     description: 'Search KB articles. Returns id, title, slug, topicName, hitCount, isPublished, and public URL.',
@@ -3560,6 +3592,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.',
@@ -4354,6 +4431,16 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     description: 'Backfill SiteSubscription rows from active Subscription rows in the messaging DB. Skips sites that already have a live SiteSubscription. Run once to seed historical state before reconciliation. Superadmin only.',
     inputSchema: { type: 'object', properties: {} },
   },
+  {
+    name: 'entitlement_backfill_sap_tiers',
+    description: 'Grant the four SAP add-on packages (Sales, Service, Finance, Supply Chain) to existing SAP sites after the package split. Dry run by default; pass apply=true to write. Superadmin only.',
+    inputSchema: { type: 'object', properties: { apply: { type: 'boolean', description: 'true writes the grants; default is a dry run' } } },
+  },
+  {
+    name: 'entitlement_backfill_legacy_write_tiers',
+    description: 'Grant EnableServiceNowWrite / EnableAccelaWrite / EnableQuickBooksWrite to existing sites after the dead OR-gate sweep so write skills are not lost. Dry run by default; pass apply=true to write. Superadmin only.',
+    inputSchema: { type: 'object', properties: { apply: { type: 'boolean', description: 'true writes the grants; default is a dry run' } } },
+  },
   {
     name: 'entitlement_reconcile',
     description: 'Diff Subscription.cs bool flags vs the entitlements API for a site. Returns deltaCount and the specific deltas. Zero deltas = site is ready for entitlements cutover. Superadmin only.',
@@ -5336,6 +5423,22 @@ async function handleTool(name, args) {
         || 'No topics found.';
     }
 
+    case 'kb_list_categories': {
+      const data = await api('GET', '/api/kb/categories');
+      const cats = data?.categories ?? [];
+      return cats.map(c => `[${c.id}] ${c.name} (priority ${c.displayPriority})`).join('\n') || 'No categories found.';
+    }
+
+    case 'kb_create_category': {
+      const c = await api('POST', '/api/kb/categories', { name: args.name, displayPriority: args.priority ?? 0, icon: args.icon });
+      return `Category created: [${c.id}] ${c.name}`;
+    }
+
+    case 'kb_create_topic': {
+      const t = await api('POST', '/api/kb/topics', { name: args.name, slug: args.slug, categoryId: args.categoryId, displayPriority: args.priority ?? 0 });
+      return `Topic created: [${t.id}] ${t.name} (slug ${t.slug})`;
+    }
+
     case 'kb_search_articles': {
       const data     = await api('POST', '/api/kb/articles/search', {
         searchTerm:    args.searchTerm,
@@ -8485,6 +8588,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) {
@@ -9558,6 +9685,16 @@ async function handleTool(name, args) {
       return `✅ Backfill complete: ${result.inserted} inserted, ${result.skipped} already existed, ${result.unknownPlan} skipped (unknown plan).`;
     }
 
+    case 'entitlement_backfill_sap_tiers': {
+      const result = await api('POST', `/Entitlements/admin/backfill-sap-tiers?dryRun=${args.apply ? 'false' : 'true'}`);
+      return `${args.apply ? 'APPLIED' : 'DRY RUN'}: ${JSON.stringify(result, null, 2)}`;
+    }
+
+    case 'entitlement_backfill_legacy_write_tiers': {
+      const result = await api('POST', `/Entitlements/admin/backfill-legacy-write-tiers?dryRun=${args.apply ? 'false' : 'true'}`);
+      return `${args.apply ? 'APPLIED' : 'DRY RUN'}: ${JSON.stringify(result, null, 2)}`;
+    }
+
     case 'entitlement_reconcile': {
       if (!args.siteId) throw new Error('siteId is required');
       const result = await api('GET', `/Entitlements/admin/reconcile/${args.siteId}`);