@velaro/mcp-server 2.0.49 → 2.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +1 -0
  2. package/package.json +1 -1
  3. package/server.js +71 -1
package/README.md CHANGED
@@ -119,6 +119,7 @@ This works with any MCP client that supports HTTP/SSE transport — including Cl
119
119
  | `bot_get` | Get full bot config including system prompt |
120
120
  | `bot_update_prompt` | Update a bot's system prompt |
121
121
  | `ai_config_set_reply_format` | Set reply format: global (plain text), plain, or markdown |
122
+ | `ai_config_set_message_speed` | Set bot Message Speed: instant, fixed (0-5s) or human; typed chat channels only |
122
123
  | `ai_config_channel_overrides_get` | List per-channel overrides incl. selection presentation settings ("All" row = bot default) |
123
124
  | `ai_config_selection_presentation_set` | Set how choice lists are shown for a channel or the "All" default: carousel/list/text, cap 1-25, repeat, Tell me more, follow-up chips (null = inherit) |
124
125
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.49",
3
+ "version": "2.0.51",
4
4
  "description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
5
5
  "type": "module",
6
6
  "bin": {
package/server.js CHANGED
@@ -1265,6 +1265,19 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
1265
1265
  required: ['aiConfigId', 'mode'],
1266
1266
  },
1267
1267
  },
1268
+ {
1269
+ name: 'ai_config_set_message_speed',
1270
+ description: 'Set a bot\'s Message Speed (Admin UI: Bots > General > Message Speed). mode: instant (no pause) | fixed (set delay, seconds 0-5) | human (random 0.5-2.5s). It is a MINIMUM time from the start of the bot\'s turn to its reply (a slow AI call adds no extra wait), applied once per turn on typed chat channels only (Web, Apple Messages, WhatsApp, SMS, RCS, Facebook, Instagram, TikTok, Twitter, Teams). Voice (IVR, click-to-call) and email/tickets are never paced. Separate from the workflow "Set Message Speed" node.',
1271
+ inputSchema: {
1272
+ type: 'object',
1273
+ properties: {
1274
+ aiConfigId: { type: 'number', description: 'AI configuration ID (from bot_list)' },
1275
+ mode: { type: 'string', enum: ['instant', 'fixed', 'human'], description: 'Message speed mode' },
1276
+ seconds: { type: 'number', description: 'Fixed-mode delay in seconds (0-5). Ignored for instant and human.' },
1277
+ },
1278
+ required: ['aiConfigId', 'mode'],
1279
+ },
1280
+ },
1268
1281
  {
1269
1282
  name: 'ai_config_channel_overrides_get',
1270
1283
  description: 'List a bot\'s per-channel overrides including the selection presentation settings (how product/choice lists are shown). Rows: conversationSource Web, AppleMessages, WhatsApp, TwilioSms, TwilioIvr, etc., plus "All" = the bot/site default row. Resolution: channel row, then the "All" row, then the platform default (carousel; caps 10 web / 3 Apple / 3 SMS; repeat always; tell-me-more on; chips on). Admin UI: Bots > AI Settings > Channel Overrides.',
@@ -3690,7 +3703,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
3690
3703
  },
3691
3704
  {
3692
3705
  name: 'ivr_update_line',
3693
- description: 'Update an IVR phone line: set the default transfer (bridge) number and/or assign a different voice configuration. All changes are logged.',
3706
+ description: 'Update an IVR phone line: set the Fallback Transfer Number (IVR Settings; the bot cannot transfer a call without one) and/or assign a different voice configuration. All changes are logged.',
3694
3707
  inputSchema: {
3695
3708
  type: 'object',
3696
3709
  properties: {
@@ -4655,6 +4668,36 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
4655
4668
  },
4656
4669
  },
4657
4670
 
4671
+ // ── Booking defaults and presets ──────────────────────────────────────────────
4672
+ // Backend: server/Velaro.Messaging/Controllers/BookingDefaultsController.cs at /BookingDefaults.
4673
+ // SiteId derives from the caller's auth context, never a tool argument (IDOR).
4674
+ {
4675
+ name: 'booking_defaults_get',
4676
+ description: 'Get this site\'s booking defaults (default provider, preset, length, meeting type, location, time zone, which contact fields are pre-filled) and its booking presets ("Demo 30 min" style choices offered on every channel). A site with nothing saved returns the built-in defaults and an empty preset list.',
4677
+ inputSchema: { type: 'object', properties: {}, required: [] },
4678
+ },
4679
+ {
4680
+ name: 'booking_defaults_update',
4681
+ description: 'Change this site\'s booking defaults. Only the fields you pass change; the rest keep their current value. Pass null to clear a nullable field. Presets are managed with the velaro CLI (velaro booking-defaults presets add|remove) or the admin UI.',
4682
+ inputSchema: {
4683
+ type: 'object',
4684
+ properties: {
4685
+ defaultProviderSlug: { type: ['string', 'null'], description: 'calendly | acuity | msbookings | outlook, or null for whichever provider is connected' },
4686
+ defaultPresetId: { type: ['number', 'null'], description: 'Preset id used when the customer does not pick one, or null' },
4687
+ defaultDurationMinutes: { type: ['number', 'null'], description: 'Default length in minutes (5 to 480), or null' },
4688
+ defaultMeetingType: { type: ['string', 'null'], description: 'phone | video | in_person | other, or null' },
4689
+ defaultLocation: { type: ['string', 'null'], description: 'Default location or meeting link (max 250 chars), or null' },
4690
+ timeZoneId: { type: ['string', 'null'], description: 'IANA time zone id such as America/Los_Angeles, or null for the site time zone' },
4691
+ prefillName: { type: 'boolean', description: 'Pre-fill the contact\'s known name in the booking flow' },
4692
+ prefillEmail: { type: 'boolean', description: 'Pre-fill the contact\'s known email' },
4693
+ prefillPhone: { type: 'boolean', description: 'Pre-fill the contact\'s known phone' },
4694
+ confirmPrefilled: { type: 'boolean', description: 'Have the bot confirm pre-filled values with the customer' },
4695
+ enabled: { type: 'boolean', description: 'Turn booking defaults on or off for the site' },
4696
+ },
4697
+ required: [],
4698
+ },
4699
+ },
4700
+
4658
4701
  // ── Generic Booking Engine (Phase 1b) ─────────────────────────────────────────
4659
4702
  // Backend: server/Velaro.Messaging/Controllers/{BookableResourcesController,
4660
4703
  // BookableServicesController,ResourceAvailabilityRulesController}.cs, routed at
@@ -5313,6 +5356,17 @@ async function handleTool(name, args) {
5313
5356
  return JSON.stringify(result, null, 2);
5314
5357
  }
5315
5358
 
5359
+ case 'ai_config_set_message_speed': {
5360
+ const all = (await messagingGet('/AIConfiguration/list')) ?? [];
5361
+ const bot = all.find(x => x.id === args.aiConfigId);
5362
+ if (!bot) return `AI configuration ${args.aiConfigId} not found.`;
5363
+ if (args.seconds !== undefined && (args.seconds < 0 || args.seconds > 5)) return 'seconds must be between 0 and 5.';
5364
+ const body = { ...bot, messageSpeedMode: args.mode };
5365
+ if (args.seconds !== undefined) body.messageSpeedSeconds = args.seconds;
5366
+ const r = await messagingPost('/AIConfiguration', body);
5367
+ return `Message speed set: [${args.aiConfigId}] ${r?.name ?? bot.name} mode=${r?.messageSpeedMode ?? args.mode} seconds=${r?.messageSpeedSeconds ?? '-'}`;
5368
+ }
5369
+
5316
5370
  case 'chat_intelligence_themes': {
5317
5371
  const qs = new URLSearchParams();
5318
5372
  if (args.startDate) qs.set('startDate', args.startDate);
@@ -8986,6 +9040,22 @@ ${JSON.stringify(result, null, 2)}`;
8986
9040
  return JSON.stringify(result, null, 2);
8987
9041
  }
8988
9042
 
9043
+ // -- Booking defaults and presets --
9044
+ case 'booking_defaults_get': {
9045
+ const result = await messagingGet('/BookingDefaults');
9046
+ return JSON.stringify(result, null, 2);
9047
+ }
9048
+
9049
+ case 'booking_defaults_update': {
9050
+ // The messaging PUT replaces the row, so start from the current values and override only what was passed.
9051
+ const current = (await messagingGet('/BookingDefaults'))?.defaults ?? {};
9052
+ const keys = ['defaultProviderSlug', 'defaultPresetId', 'defaultDurationMinutes', 'defaultMeetingType', 'defaultLocation', 'timeZoneId', 'prefillName', 'prefillEmail', 'prefillPhone', 'confirmPrefilled', 'enabled'];
9053
+ const body = {};
9054
+ for (const k of keys) body[k] = args[k] !== undefined ? args[k] : (current[k] ?? null);
9055
+ const result = await messagingPut('/BookingDefaults', body);
9056
+ return JSON.stringify(result, null, 2);
9057
+ }
9058
+
8989
9059
  // -- Generic Booking Engine (Phase 1b) --
8990
9060
  case 'booking_list_resources': {
8991
9061
  const result = await messagingGet('/BookableResources');