@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.
- package/README.md +1 -0
- package/package.json +1 -1
- 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.
|
|
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
|
|
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');
|