@velaro/mcp-server 2.0.129 → 2.0.131

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 CHANGED
@@ -23,7 +23,7 @@ Most chat platforms require webhooks, custom API wrappers, or point-to-point int
23
23
  - **Hosted HTTP endpoint** — no Node.js required; point Claude Desktop at `https://velaro-admin-staging.azurewebsites.net/mcp` with a Bearer token
24
24
  - **Auto-updates** — the package is republished on every production deploy; `npx` always runs the latest
25
25
  - **596 AI skills** — Shopify, BigCommerce, WooCommerce, Magento, HubSpot, Salesforce, NetSuite, ServiceNow, Dynamics 365, SAP, Square, QuickBooks, Jobber, and more — all callable from within Claude
26
- - **25 built-in tools** — conversations, workflows, bots, contacts, agents, teams, routing rules, conversion tracking, and full KB management
26
+ - **Built-in tools** — conversations, workflows, bots, contacts, agents, teams, routing rules, conversion tracking, and full KB management
27
27
 
28
28
  ---
29
29
 
@@ -82,7 +82,9 @@ If you prefer not to run a local Node process, point directly at Velaro's hosted
82
82
  }
83
83
  ```
84
84
 
85
- This works with any MCP client that supports HTTP/SSE transport — including Claude Desktop 0.8+.
85
+ This works with any MCP client that supports the Streamable HTTP transport.
86
+
87
+ The hosted endpoint serves a smaller toolset than the npm package: knowledge base (`kb_list_topics`, `kb_search_articles`, `kb_get_article`, `kb_create_article`, `kb_update_article`, `kb_delete_article`) contacts (`contact_search`, `contact_get`), and, for keys created with the `admin` scope (Settings > MCP keys > Access, or `velaro mcp-key create --scopes admin`), conversations (`conversation_list`, `conversation_get`, `conversation_search`), workflows (`workflow_list`, `workflow_get`, `workflow_toggle`), bots (`bot_list`, `bot_get`, `bot_update_prompt`), `agent_list`, `team_list` and routing (`routing_list`, `routing_get`). The full toolset listed below is available through `npx @velaro/mcp-server`. Every hosted call is scoped to the site that owns your key.
86
88
 
87
89
  ---
88
90
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.129",
3
+ "version": "2.0.131",
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": {
@@ -63,6 +63,7 @@ export const tools = [
63
63
 
64
64
  export const handlers = {
65
65
  crm_calculated_values: async (a, ctx) => data(await ctx.messagingPost('/CrmCustomFields/calculated/values', { entity: a.entity, recordIds: a.recordIds })),
66
+ crm_calculated_filter: async (a, ctx) => data(await ctx.messagingPost('/CrmCustomFields/calculated/filter', { entity: a.entity, filters: a.filters, limit: a.limit })),
66
67
  crm_calculated_deps: async (a, ctx) => data(await ctx.messagingGet(`/CrmCustomFields/calculated/deps?entity=${encodeURIComponent(a.entity)}`)),
67
68
  crm_calculated_sources: async (a, ctx) => data(await ctx.messagingGet(`/CrmCustomFields/calculated/sources?entity=${encodeURIComponent(a.entity)}`)),
68
69
  };
package/parity/loader.js CHANGED
@@ -14,9 +14,20 @@ export async function loadParity(kind /* 'customer' | 'staff' */) {
14
14
  const dir = dirname(fileURLToPath(import.meta.url));
15
15
  const out = { tools: [], handlers: {} };
16
16
  for (const f of readdirSync(dir).filter((x) => x.endsWith(`.${kind}.js`)).sort()) {
17
- const mod = await import(pathToFileURL(join(dir, f)).href);
17
+ // One broken module must never take down the whole server: log it, skip that module, keep serving the rest.
18
+ let mod;
19
+ try {
20
+ mod = await import(pathToFileURL(join(dir, f)).href);
21
+ } catch (e) {
22
+ console.error(`[velaro-mcp] skipping parity module ${f}: failed to load: ${e?.message || e}`);
23
+ continue;
24
+ }
25
+ const bad = (mod.tools || []).filter((t) => !t?.name || typeof mod.handlers?.[t.name] !== 'function' || out.handlers[t.name]);
26
+ if (bad.length) {
27
+ console.error(`[velaro-mcp] skipping parity module ${f}: tool(s) with no handler or duplicate name: ${bad.map((t) => t?.name).join(', ')}`);
28
+ continue;
29
+ }
18
30
  for (const t of mod.tools || []) {
19
- if (out.handlers[t.name] || !mod.handlers?.[t.name]) throw new Error(`parity module ${f}: tool ${t.name} duplicate or missing handler`);
20
31
  out.tools.push(t);
21
32
  out.handlers[t.name] = mod.handlers[t.name];
22
33
  }
package/server.js CHANGED
@@ -5183,8 +5183,12 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5183
5183
  type: 'object',
5184
5184
  properties: {
5185
5185
  name: { type: 'string', description: 'Resource name. Required.' },
5186
- resourceType: { type: 'string', enum: ['Staff', 'Room', 'Equipment', 'Virtual'], description: 'Resource type. Defaults to Staff.' },
5186
+ resourceType: { type: 'string', enum: ['Staff', 'Room', 'Equipment', 'Virtual', 'Table'], description: 'Resource type. Defaults to Staff. Table is a dining table for TableCapacity booking mode.' },
5187
5187
  isActive: { type: 'boolean', description: 'Whether the resource is active. Defaults to true.' },
5188
+ minParty: { type: 'number', description: 'Table: smallest party this table seats.' },
5189
+ maxParty: { type: 'number', description: 'Table: largest party this table seats.' },
5190
+ turnMinutes: { type: 'number', description: 'Table: minutes a party occupies this table (overrides the service default).' },
5191
+ combineGroup: { type: 'string', description: 'Table: group name; tables in one group can be combined for larger parties when the service allows it.' },
5188
5192
  },
5189
5193
  required: ['name'],
5190
5194
  },
@@ -5197,8 +5201,12 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5197
5201
  properties: {
5198
5202
  resourceId: { type: 'number', description: 'Resource ID. Required.' },
5199
5203
  name: { type: 'string', description: 'New name' },
5200
- resourceType: { type: 'string', enum: ['Staff', 'Room', 'Equipment', 'Virtual'], description: 'New resource type' },
5204
+ resourceType: { type: 'string', enum: ['Staff', 'Room', 'Equipment', 'Virtual', 'Table'], description: 'New resource type' },
5201
5205
  isActive: { type: 'boolean', description: 'New active state' },
5206
+ minParty: { type: 'number', description: 'Table: new smallest party' },
5207
+ maxParty: { type: 'number', description: 'Table: new largest party' },
5208
+ turnMinutes: { type: 'number', description: 'Table: new turn minutes' },
5209
+ combineGroup: { type: 'string', description: 'Table: new combine group name' },
5202
5210
  },
5203
5211
  required: ['resourceId'],
5204
5212
  },
@@ -5238,6 +5246,14 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5238
5246
  requiresResource: { type: 'boolean', description: 'Whether a slot for this service must be tied to a specific bookable resource. Defaults to true.' },
5239
5247
  category: { type: 'string', description: 'Free-text grouping for admin UI/reporting, e.g. "Hair" or "Fitness Classes".' },
5240
5248
  isActive: { type: 'boolean', description: 'Whether the service is active. Defaults to true.' },
5249
+ bookingMode: { type: 'string', enum: ['StaffSchedule', 'TableCapacity', 'SeatCapacity'], description: 'How this service is booked: one person schedule, tables by party size, or seats per class. Omit for current behavior.' },
5250
+ turnMinutes: { type: 'number', description: 'Default minutes a party occupies a table.' },
5251
+ turnMinutesBySize: { type: 'object', description: 'Turn minutes by party size range, e.g. {"1-2":60,"3-5":90,"6+":120}.' },
5252
+ bufferBeforeMinutes: { type: 'number', description: 'Minutes held free before each booking.' },
5253
+ bufferAfterMinutes: { type: 'number', description: 'Minutes held free after each booking.' },
5254
+ allowTableCombining: { type: 'boolean', description: 'Allow combining tables within a combine group.' },
5255
+ minParty: { type: 'number', description: 'Smallest party accepted.' },
5256
+ maxParty: { type: 'number', description: 'Largest party accepted.' },
5241
5257
  },
5242
5258
  required: ['name'],
5243
5259
  },
@@ -5255,6 +5271,14 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5255
5271
  requiresResource: { type: 'boolean', description: 'New requires-resource flag' },
5256
5272
  category: { type: 'string', description: 'New category (empty string clears it)' },
5257
5273
  isActive: { type: 'boolean', description: 'New active state' },
5274
+ bookingMode: { type: 'string', enum: ['StaffSchedule', 'TableCapacity', 'SeatCapacity'], description: 'New booking mode' },
5275
+ turnMinutes: { type: 'number', description: 'New default turn minutes' },
5276
+ turnMinutesBySize: { type: 'object', description: 'New turn minutes by party size range, e.g. {"1-2":60,"3-5":90,"6+":120}' },
5277
+ bufferBeforeMinutes: { type: 'number', description: 'New buffer before, minutes' },
5278
+ bufferAfterMinutes: { type: 'number', description: 'New buffer after, minutes' },
5279
+ allowTableCombining: { type: 'boolean', description: 'New table-combining flag' },
5280
+ minParty: { type: 'number', description: 'New smallest party' },
5281
+ maxParty: { type: 'number', description: 'New largest party' },
5258
5282
  },
5259
5283
  required: ['serviceId'],
5260
5284
  },
@@ -5343,6 +5367,116 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5343
5367
  required: ['ruleId'],
5344
5368
  },
5345
5369
  },
5370
+ {
5371
+ name: 'scheduler_intake_question_list',
5372
+ description: 'List the intake questions customers answer when booking a service. Optionally filter to one service.',
5373
+ inputSchema: { type: 'object', properties: { serviceId: { type: 'number', description: 'Only this service' } }, required: [] },
5374
+ },
5375
+ {
5376
+ name: 'scheduler_intake_question_get',
5377
+ description: 'Get one intake question by id.',
5378
+ inputSchema: { type: 'object', properties: { questionId: { type: 'number', description: 'Question ID. Required.' } }, required: ['questionId'] },
5379
+ },
5380
+ {
5381
+ name: 'scheduler_intake_question_create',
5382
+ description: 'Add an intake question to a bookable service. Answers appear on the booking and in the confirmation email.',
5383
+ inputSchema: {
5384
+ type: 'object',
5385
+ properties: {
5386
+ bookableServiceId: { type: 'number', description: 'Service ID. Required.' },
5387
+ label: { type: 'string', description: 'Question text. Required.' },
5388
+ questionType: { type: 'string', enum: ['text', 'textarea', 'select', 'checkbox'], description: 'Answer type. Required.' },
5389
+ options: { type: 'array', items: { type: 'string' }, description: 'Choices, for select questions only.' },
5390
+ isRequired: { type: 'boolean', description: 'Customer must answer. Defaults to false.' },
5391
+ sortOrder: { type: 'number', description: 'Display order, lowest first.' },
5392
+ isActive: { type: 'boolean', description: 'Defaults to true.' },
5393
+ },
5394
+ required: ['bookableServiceId', 'label', 'questionType'],
5395
+ },
5396
+ },
5397
+ {
5398
+ name: 'scheduler_intake_question_update',
5399
+ description: 'Update an intake question. Only supplied fields change.',
5400
+ inputSchema: {
5401
+ type: 'object',
5402
+ properties: {
5403
+ questionId: { type: 'number', description: 'Question ID. Required.' },
5404
+ label: { type: 'string' },
5405
+ questionType: { type: 'string', enum: ['text', 'textarea', 'select', 'checkbox'] },
5406
+ options: { type: 'array', items: { type: 'string' } },
5407
+ isRequired: { type: 'boolean' },
5408
+ sortOrder: { type: 'number' },
5409
+ isActive: { type: 'boolean' },
5410
+ },
5411
+ required: ['questionId'],
5412
+ },
5413
+ },
5414
+ {
5415
+ name: 'scheduler_intake_question_delete',
5416
+ description: 'Delete an intake question. 404 if it is not found on this site.',
5417
+ inputSchema: { type: 'object', properties: { questionId: { type: 'number', description: 'Question ID. Required.' } }, required: ['questionId'] },
5418
+ },
5419
+ {
5420
+ name: 'scheduler_date_override_list',
5421
+ description: 'List time off and special hours (date overrides). A null resourceId means the whole business.',
5422
+ inputSchema: {
5423
+ type: 'object',
5424
+ properties: {
5425
+ resourceId: { type: 'number', description: 'Only this resource' },
5426
+ fromDate: { type: 'string', description: 'Only entries from this date, yyyy-MM-dd' },
5427
+ },
5428
+ required: [],
5429
+ },
5430
+ },
5431
+ {
5432
+ name: 'scheduler_date_override_get',
5433
+ description: 'Get one time off / special hours entry by id.',
5434
+ inputSchema: { type: 'object', properties: { overrideId: { type: 'number', description: 'Override ID. Required.' } }, required: ['overrideId'] },
5435
+ },
5436
+ {
5437
+ name: 'scheduler_date_override_create',
5438
+ description: 'Add time off (isClosed true) or custom hours (isClosed false, with startLocal/endLocal) for a date range. Omit resourceId for the whole business.',
5439
+ inputSchema: {
5440
+ type: 'object',
5441
+ properties: {
5442
+ resourceId: { type: 'number', description: 'Resource ID. Omit for the whole business.' },
5443
+ startDate: { type: 'string', description: 'yyyy-MM-dd. Required.' },
5444
+ endDate: { type: 'string', description: 'yyyy-MM-dd, inclusive. Required.' },
5445
+ isClosed: { type: 'boolean', description: 'true = time off. Required.' },
5446
+ startLocal: { type: 'string', description: 'HH:mm, custom hours when isClosed is false.' },
5447
+ endLocal: { type: 'string', description: 'HH:mm, custom hours when isClosed is false.' },
5448
+ reason: { type: 'string' },
5449
+ ianaTimeZone: { type: 'string', description: 'IANA timezone id, e.g. America/Los_Angeles.' },
5450
+ isActive: { type: 'boolean', description: 'Defaults to true.' },
5451
+ },
5452
+ required: ['startDate', 'endDate', 'isClosed'],
5453
+ },
5454
+ },
5455
+ {
5456
+ name: 'scheduler_date_override_update',
5457
+ description: 'Update a time off / special hours entry. Only supplied fields change.',
5458
+ inputSchema: {
5459
+ type: 'object',
5460
+ properties: {
5461
+ overrideId: { type: 'number', description: 'Override ID. Required.' },
5462
+ resourceId: { type: 'number' },
5463
+ startDate: { type: 'string' },
5464
+ endDate: { type: 'string' },
5465
+ isClosed: { type: 'boolean' },
5466
+ startLocal: { type: 'string' },
5467
+ endLocal: { type: 'string' },
5468
+ reason: { type: 'string' },
5469
+ ianaTimeZone: { type: 'string' },
5470
+ isActive: { type: 'boolean' },
5471
+ },
5472
+ required: ['overrideId'],
5473
+ },
5474
+ },
5475
+ {
5476
+ name: 'scheduler_date_override_delete',
5477
+ description: 'Delete a time off / special hours entry. 404 if it is not found on this site.',
5478
+ inputSchema: { type: 'object', properties: { overrideId: { type: 'number', description: 'Override ID. Required.' } }, required: ['overrideId'] },
5479
+ },
5346
5480
  {
5347
5481
  name: 'booking_list_appointments',
5348
5482
  description: 'List actual bookings (Phase 1c) made against the booking engine for this site, optionally filtered by date range or service.',
@@ -10039,6 +10173,10 @@ ${JSON.stringify(result, null, 2)}`;
10039
10173
  name: args.name,
10040
10174
  resourceType: args.resourceType,
10041
10175
  isActive: args.isActive,
10176
+ minParty: args.minParty,
10177
+ maxParty: args.maxParty,
10178
+ turnMinutes: args.turnMinutes,
10179
+ combineGroup: args.combineGroup,
10042
10180
  });
10043
10181
  return JSON.stringify(result, null, 2);
10044
10182
  }
@@ -10049,6 +10187,10 @@ ${JSON.stringify(result, null, 2)}`;
10049
10187
  name: args.name,
10050
10188
  resourceType: args.resourceType,
10051
10189
  isActive: args.isActive,
10190
+ minParty: args.minParty,
10191
+ maxParty: args.maxParty,
10192
+ turnMinutes: args.turnMinutes,
10193
+ combineGroup: args.combineGroup,
10052
10194
  });
10053
10195
  return JSON.stringify(result, null, 2);
10054
10196
  }
@@ -10079,6 +10221,14 @@ ${JSON.stringify(result, null, 2)}`;
10079
10221
  requiresResource: args.requiresResource,
10080
10222
  category: args.category,
10081
10223
  isActive: args.isActive,
10224
+ bookingMode: args.bookingMode,
10225
+ turnMinutes: args.turnMinutes,
10226
+ turnMinutesBySize: args.turnMinutesBySize,
10227
+ bufferBeforeMinutes: args.bufferBeforeMinutes,
10228
+ bufferAfterMinutes: args.bufferAfterMinutes,
10229
+ allowTableCombining: args.allowTableCombining,
10230
+ minParty: args.minParty,
10231
+ maxParty: args.maxParty,
10082
10232
  });
10083
10233
  return JSON.stringify(result, null, 2);
10084
10234
  }
@@ -10092,6 +10242,14 @@ ${JSON.stringify(result, null, 2)}`;
10092
10242
  requiresResource: args.requiresResource,
10093
10243
  category: args.category,
10094
10244
  isActive: args.isActive,
10245
+ bookingMode: args.bookingMode,
10246
+ turnMinutes: args.turnMinutes,
10247
+ turnMinutesBySize: args.turnMinutesBySize,
10248
+ bufferBeforeMinutes: args.bufferBeforeMinutes,
10249
+ bufferAfterMinutes: args.bufferAfterMinutes,
10250
+ allowTableCombining: args.allowTableCombining,
10251
+ minParty: args.minParty,
10252
+ maxParty: args.maxParty,
10095
10253
  });
10096
10254
  return JSON.stringify(result, null, 2);
10097
10255
  }
@@ -10157,6 +10315,53 @@ ${JSON.stringify(result, null, 2)}`;
10157
10315
  return JSON.stringify(result, null, 2);
10158
10316
  }
10159
10317
 
10318
+ case 'scheduler_intake_question_list': {
10319
+ const qs = args.serviceId != null ? `?serviceId=${encodeURIComponent(args.serviceId)}` : '';
10320
+ return JSON.stringify(await messagingGet(`/BookableServiceIntakeQuestions${qs}`), null, 2);
10321
+ }
10322
+ case 'scheduler_intake_question_get': {
10323
+ if (args.questionId == null) return 'questionId is required.';
10324
+ return JSON.stringify(await messagingGet(`/BookableServiceIntakeQuestions/${encodeURIComponent(args.questionId)}`), null, 2);
10325
+ }
10326
+ case 'scheduler_intake_question_create': {
10327
+ if (args.bookableServiceId == null || !args.label || !args.questionType) return 'bookableServiceId, label, and questionType are required.';
10328
+ const { bookableServiceId, label, questionType, options, isRequired, sortOrder, isActive } = args;
10329
+ return JSON.stringify(await messagingPost('/BookableServiceIntakeQuestions', { bookableServiceId, label, questionType, options, isRequired, sortOrder, isActive }), null, 2);
10330
+ }
10331
+ case 'scheduler_intake_question_update': {
10332
+ if (args.questionId == null) return 'questionId is required.';
10333
+ const { label, questionType, options, isRequired, sortOrder, isActive } = args;
10334
+ return JSON.stringify(await messagingPut(`/BookableServiceIntakeQuestions/${encodeURIComponent(args.questionId)}`, { label, questionType, options, isRequired, sortOrder, isActive }), null, 2);
10335
+ }
10336
+ case 'scheduler_intake_question_delete': {
10337
+ if (args.questionId == null) return 'questionId is required.';
10338
+ return JSON.stringify(await messagingDel(`/BookableServiceIntakeQuestions/${encodeURIComponent(args.questionId)}`), null, 2);
10339
+ }
10340
+ case 'scheduler_date_override_list': {
10341
+ const params = [];
10342
+ if (args.resourceId != null) params.push(`resourceId=${encodeURIComponent(args.resourceId)}`);
10343
+ if (args.fromDate != null) params.push(`fromDate=${encodeURIComponent(args.fromDate)}`);
10344
+ return JSON.stringify(await messagingGet(`/BookingDateOverrides${params.length ? '?' + params.join('&') : ''}`), null, 2);
10345
+ }
10346
+ case 'scheduler_date_override_get': {
10347
+ if (args.overrideId == null) return 'overrideId is required.';
10348
+ return JSON.stringify(await messagingGet(`/BookingDateOverrides/${encodeURIComponent(args.overrideId)}`), null, 2);
10349
+ }
10350
+ case 'scheduler_date_override_create': {
10351
+ if (!args.startDate || !args.endDate || args.isClosed == null) return 'startDate, endDate, and isClosed are required.';
10352
+ const { resourceId, startDate, endDate, isClosed, startLocal, endLocal, reason, ianaTimeZone, isActive } = args;
10353
+ return JSON.stringify(await messagingPost('/BookingDateOverrides', { resourceId, startDate, endDate, isClosed, startLocal, endLocal, reason, ianaTimeZone, isActive }), null, 2);
10354
+ }
10355
+ case 'scheduler_date_override_update': {
10356
+ if (args.overrideId == null) return 'overrideId is required.';
10357
+ const { resourceId, startDate, endDate, isClosed, startLocal, endLocal, reason, ianaTimeZone, isActive } = args;
10358
+ return JSON.stringify(await messagingPut(`/BookingDateOverrides/${encodeURIComponent(args.overrideId)}`, { resourceId, startDate, endDate, isClosed, startLocal, endLocal, reason, ianaTimeZone, isActive }), null, 2);
10359
+ }
10360
+ case 'scheduler_date_override_delete': {
10361
+ if (args.overrideId == null) return 'overrideId is required.';
10362
+ return JSON.stringify(await messagingDel(`/BookingDateOverrides/${encodeURIComponent(args.overrideId)}`), null, 2);
10363
+ }
10364
+
10160
10365
  case 'booking_list_appointments': {
10161
10366
  const params = [];
10162
10367
  if (args.fromUtc != null) params.push(`fromUtc=${encodeURIComponent(args.fromUtc)}`);