@velaro/mcp-server 0.6.57 → 0.6.59

package/package.json

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

@@ -170,6 +170,8 @@ const messagingPatch = (path, body) => messagingRequest('PATCH', path, body);
 const messagingDel   = (path)       => messagingRequest('DELETE', path);
 
 async function api(method, path, body, base = API_BASE) {
+  // Normalize: a path without a leading slash would glue onto the host ("...comScraperJobs/...") and fail as "fetch failed".
+  if (!path.startsWith('/')) path = '/' + path;
   const res = await fetch(`${base}${path}`, {
     method,
     headers: { Authorization: authHeader(), 'Content-Type': 'application/json' },
@@ -579,6 +581,12 @@ const TOOLS = [
     },
   },
 
+  {
+    name: 'scraper_verify_token',
+    description: "Show the calling site's web-scraper verification header (name + value), the scraper IP, and ready-to-send instructions for allowlisting Velaro's crawler with the customer's web host/WAF. Wraps GET ScraperJobs/VerifyToken. Site comes from auth context, never a parameter.",
+    inputSchema: { type: 'object', properties: {} },
+  },
+
   // ── Startup migration diagnostics (AdminStartupDiagnostics canary table) ──
   {
     name: 'admin_startup_diagnostics',
@@ -2960,6 +2968,21 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: [],
     },
   },
+  {
+    name: 'ai_spend_report',
+    description: 'SuperAdmin AI spend report: logged AI cost for prod and/or staging over a window, by site, model, key source (platform/copilot/byok) and site x feature, with cache-read ratio, QA share, top movers vs the previous period and anomalies. Also records/lists provider reconciliation (console total vs logged). Breaker trips are not in AiCostLogs so are reported as not available.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        env:  { type: 'string', enum: ['both', 'prod', 'staging'], description: 'Environment. Default both.' },
+        days: { type: 'number', description: 'Trailing window in days. Default 7, max 92.' },
+        reconcile_entered_usd: { type: 'number', description: 'If set, records a reconciliation for the window with this provider console total in USD instead of only reading the report.' },
+        provider: { type: 'string', description: 'Provider for reconciliation. Default Anthropic.' },
+        key_bucket: { type: 'string', description: 'Per-key bucket for reconciliation: platform, copilot or byok. Omit for provider total.' },
+      },
+      required: [],
+    },
+  },
   {
     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.',
@@ -4754,6 +4777,11 @@ async function handleTool(name, args) {
       return JSON.stringify(result, null, 2);
     }
 
+    case 'scraper_verify_token': {
+      const result = await api('GET', 'ScraperJobs/VerifyToken');
+      return JSON.stringify(result, null, 2);
+    }
+
     case 'site_scraper_usage': {
       const result = await api('GET', `ScraperJobs/StaffUsage/${encodeURIComponent(args.siteId)}`);
       return JSON.stringify(result, null, 2);
@@ -7350,6 +7378,22 @@ async function handleTool(name, args) {
     case 'velaro_diagnostic_start':
       return DIAGNOSTIC_RUNBOOK;
 
+    case 'ai_spend_report': {
+      const days = Math.min(Math.max(Number(args.days) || 7, 1), 92);
+      const to = new Date();
+      const from = new Date(to.getTime() - days * 86400000);
+      const env = args.env || 'both';
+      if (args.reconcile_entered_usd !== undefined && args.reconcile_entered_usd !== null) {
+        const row = await api('POST', '/SuperAdmin/AiSpend/Reconciliations', {
+          periodStartUtc: from.toISOString(), periodEndUtc: to.toISOString(), environment: env,
+          provider: args.provider || 'Anthropic', keyLabel: args.key_bucket || null, enteredUsd: Number(args.reconcile_entered_usd),
+        });
+        return JSON.stringify(row, null, 2);
+      }
+      const data = await api('GET', `/SuperAdmin/AiSpend/Report?env=${env}&from=${encodeURIComponent(from.toISOString())}&to=${encodeURIComponent(to.toISOString())}`);
+      return JSON.stringify(data, null, 2);
+    }
+
     case 'signalr_diagnostics': {
       // Parse a SignalR connection string into { endpoint, accessKey }
       function parseSignalRConn(conn) {