@velaro/mcp-server 0.6.81 → 0.6.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.81",
+  "version": "0.6.83",
   "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.',
@@ -3033,7 +3065,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     name: 'support_bulk_set_flags',
-    description: 'Set multiple subscription feature flags AND/OR numeric caps on a site in one call. SuperAdmin only. Use to restore a test/internal site, enable a batch of features, or set caps like maxEmailCampaignSendsPerMonth. Pass flags as an object e.g. {"enableAI": true, "maxEmailCampaignSendsPerMonth": 500}. Unknown or type-mismatched keys come back in the response\'s "skipped" list — check it, do not assume everything applied.',
+    description: 'Set multiple subscription feature flags AND/OR numeric caps on a site in one call. SuperAdmin only. Use to restore a test/internal site, enable a batch of features, or set caps like maxEmailCampaignSendsPerMonth or maxBotTurnsPerMonth (monthly AI bot turns; 0 = plan value, never unlimited). Pass flags as an object e.g. {"enableAI": true, "maxEmailCampaignSendsPerMonth": 500, "maxBotTurnsPerMonth": 10000}. Unknown or type-mismatched keys come back in the response\'s "skipped" list — check it, do not assume everything applied.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -4354,6 +4386,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 +5378,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,
@@ -9558,6 +9616,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}`);