@velaro/mcp-server 2.0.25 → 2.0.26
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 +2 -0
- package/package.json +1 -1
- package/server.js +48 -0
- package/tool-annotations.js +1 -0
package/README.md
CHANGED
|
@@ -119,6 +119,8 @@ 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_channel_overrides_get` | List per-channel overrides incl. selection presentation settings ("All" row = bot default) |
|
|
123
|
+
| `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) |
|
|
122
124
|
|
|
123
125
|
### CRM Mobile Fields
|
|
124
126
|
| Tool | What It Does |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@velaro/mcp-server",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.26",
|
|
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
|
@@ -1257,6 +1257,33 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
|
|
|
1257
1257
|
required: ['aiConfigId', 'mode'],
|
|
1258
1258
|
},
|
|
1259
1259
|
},
|
|
1260
|
+
{
|
|
1261
|
+
name: 'ai_config_channel_overrides_get',
|
|
1262
|
+
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.',
|
|
1263
|
+
inputSchema: {
|
|
1264
|
+
type: 'object',
|
|
1265
|
+
properties: { aiConfigId: { type: 'number', description: 'AI configuration ID (from bot_list)' } },
|
|
1266
|
+
required: ['aiConfigId'],
|
|
1267
|
+
},
|
|
1268
|
+
},
|
|
1269
|
+
{
|
|
1270
|
+
name: 'ai_config_selection_presentation_set',
|
|
1271
|
+
description: 'Set selection presentation for one channel row (or "All" = bot/site default) on a bot, leaving every other row and field untouched (read-modify-write of the channel-overrides list). Fields: selectionPresentation ("carousel"|"list"|"text"), maxSelectionResults (1-25), repeatSelectionsInline ("always"|"collapsed"), showTellMeMore (bool), tellMeMoreLabel (<=64 chars), showFollowUpChips (bool). null = inherit. Pass only the fields to change; pass null to reset a field to inherit. Channels: web = carousel, Apple Messages = native rich links, WhatsApp = native list/cards, IVR = spoken summary only (no links). Admin UI: Bots > AI Settings > Channel Overrides.',
|
|
1272
|
+
inputSchema: {
|
|
1273
|
+
type: 'object',
|
|
1274
|
+
properties: {
|
|
1275
|
+
aiConfigId: { type: 'number', description: 'AI configuration ID (from bot_list)' },
|
|
1276
|
+
channel: { type: 'string', description: 'conversationSource: All, Web, AppleMessages, WhatsApp, TwilioSms, TwilioIvr, Email, Facebook, Twitter, Rcs' },
|
|
1277
|
+
selectionPresentation: { type: ['string', 'null'], enum: ['carousel', 'list', 'text', null] },
|
|
1278
|
+
maxSelectionResults: { type: ['number', 'null'], minimum: 1, maximum: 25 },
|
|
1279
|
+
repeatSelectionsInline: { type: ['string', 'null'], enum: ['always', 'collapsed', null] },
|
|
1280
|
+
showTellMeMore: { type: ['boolean', 'null'] },
|
|
1281
|
+
tellMeMoreLabel: { type: ['string', 'null'], maxLength: 64 },
|
|
1282
|
+
showFollowUpChips: { type: ['boolean', 'null'] },
|
|
1283
|
+
},
|
|
1284
|
+
required: ['aiConfigId', 'channel'],
|
|
1285
|
+
},
|
|
1286
|
+
},
|
|
1260
1287
|
{
|
|
1261
1288
|
name: 'site_identity_secret_status',
|
|
1262
1289
|
description: 'Check whether a visitor identity signing secret is configured for this site. The secret lets pre-authenticated visitors (already logged in to the customer website) skip the OTP challenge when the bot looks up their CRM data. Returns whether configured and the masked secret. To generate or rotate the secret, the customer goes to Admin → Account Settings → Security → "Visitor Identity Signing Secret".',
|
|
@@ -5405,6 +5432,27 @@ async function handleTool(name, args) {
|
|
|
5405
5432
|
// [Authorize] does not accept vel_live_* service keys (only a handful of controllers opt
|
|
5406
5433
|
// into that manually) — these tools need VELARO_JWT, same requirement as the existing
|
|
5407
5434
|
// notifications_get tool they're modeled on.
|
|
5435
|
+
case 'ai_config_channel_overrides_get': {
|
|
5436
|
+
const rows = await messagingGet(`/AIConfiguration/${encodeURIComponent(args.aiConfigId)}/channel-overrides`);
|
|
5437
|
+
return JSON.stringify(Array.isArray(rows) ? rows : [], null, 2);
|
|
5438
|
+
}
|
|
5439
|
+
|
|
5440
|
+
case 'ai_config_selection_presentation_set': {
|
|
5441
|
+
const path = `/AIConfiguration/${encodeURIComponent(args.aiConfigId)}/channel-overrides`;
|
|
5442
|
+
const FIELDS = ['selectionPresentation', 'maxSelectionResults', 'repeatSelectionsInline', 'showTellMeMore', 'tellMeMoreLabel', 'showFollowUpChips'];
|
|
5443
|
+
const rows = (await messagingGet(path)) ?? [];
|
|
5444
|
+
const list = Array.isArray(rows) ? rows : [];
|
|
5445
|
+
const src = String(args.channel);
|
|
5446
|
+
const cur = list.find(r => r.conversationSource === src)
|
|
5447
|
+
?? { conversationSource: src, mode: 'additive', overrideText: '' };
|
|
5448
|
+
const next = { ...cur };
|
|
5449
|
+
for (const f of FIELDS) if (f in args) next[f] = args[f];
|
|
5450
|
+
// PUT replaces all rows, so send every existing row back (fields round-trip as returned).
|
|
5451
|
+
const out = [...list.filter(r => r.conversationSource !== src), next];
|
|
5452
|
+
await messagingPut(path, out);
|
|
5453
|
+
return JSON.stringify(await messagingGet(path), null, 2);
|
|
5454
|
+
}
|
|
5455
|
+
|
|
5408
5456
|
case 'ai_followups_site_get': {
|
|
5409
5457
|
const r = await messagingGet('/SiteSettings/AiFollowUps');
|
|
5410
5458
|
return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
|
package/tool-annotations.js
CHANGED
|
@@ -24,6 +24,7 @@ const MUTATING = new Set([
|
|
|
24
24
|
'monday_set_field_mapping', 'teams_push_settings_update', 'teams_channel_config_update',
|
|
25
25
|
'routing_team_update_config', 'pickup_update_config', 'payment_recovery_update_config',
|
|
26
26
|
'recruiting_sync_jobs', 'ai_config_set_reply_format', 'magento_set_sidebar_fields',
|
|
27
|
+
'ai_config_selection_presentation_set',
|
|
27
28
|
'zoom_phone_set_config', 'callpresence_set', 'callpresence_set_groups', 'callpresence_clear',
|
|
28
29
|
'billing_insights_set_preferences', 'billing_insights_dismiss_recommendation',
|
|
29
30
|
'site_sale_create', 'site_sale_update', 'site_sale_end',
|