@velaro/mcp-server 2.0.115 → 2.0.116

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 (2) hide show
  1. package/package.json +1 -1
  2. package/server.js +123 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.115",
3
+ "version": "2.0.116",
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
@@ -5333,6 +5333,73 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5333
5333
  },
5334
5334
  },
5335
5335
 
5336
+ // -- Scheduler floor + booking no-show / deposits / analytics (velaro-messaging FloorController + BookingsController). SiteId derives server-side from the caller's auth, never a tool argument (IDOR).
5337
+ {
5338
+ name: 'booking_floor_list_waitlist',
5339
+ description: 'List the current floor waitlist and walk-ins (party size, status, quoted wait). GET /Floor/Waitlist.',
5340
+ inputSchema: { type: 'object', properties: {}, required: [] },
5341
+ },
5342
+ {
5343
+ name: 'booking_floor_add_waitlist',
5344
+ description: 'Add a guest to the floor waitlist. POST /Floor/Waitlist.',
5345
+ inputSchema: { type: 'object', properties: { guestName: { type: 'string', description: 'Guest name. Required.' }, phone: { type: 'string', description: 'Phone for the table-ready text. Required.' }, partySize: { type: 'number', description: 'Party size. Required.' }, isVip: { type: 'boolean', description: 'VIP flag' }, quotedWaitMinutes: { type: 'number', description: 'Quoted wait in minutes' }, notes: { type: 'string', description: 'Notes' } }, required: ['guestName', 'phone', 'partySize'] },
5346
+ },
5347
+ {
5348
+ name: 'booking_floor_add_walk_in',
5349
+ description: 'Record a walk-in on the floor. POST /Floor/WalkIn.',
5350
+ inputSchema: { type: 'object', properties: { guestName: { type: 'string', description: 'Guest name. Required.' }, phone: { type: 'string', description: 'Phone. Required.' }, partySize: { type: 'number', description: 'Party size. Required.' }, isVip: { type: 'boolean', description: 'VIP flag' }, quotedWaitMinutes: { type: 'number', description: 'Quoted wait in minutes' }, notes: { type: 'string', description: 'Notes' } }, required: ['guestName', 'phone', 'partySize'] },
5351
+ },
5352
+ {
5353
+ name: 'booking_floor_waitlist_action',
5354
+ description: 'Act on a waitlist entry: ready (texts the guest the table is ready), seat, remove or noshow. POST /Floor/Waitlist/{id}/Ready|Seat|Remove|NoShow.',
5355
+ inputSchema: { type: 'object', properties: { entryId: { type: 'number', description: 'Waitlist entry ID. Required.' }, action: { type: 'string', description: 'ready | seat | remove | noshow. Required.' }, resourceId: { type: 'number', description: 'Table (resource) ID, for seat' } }, required: ['entryId', 'action'] },
5356
+ },
5357
+ {
5358
+ name: 'booking_floor_get_settings',
5359
+ description: 'Read the floor settings (turn minutes, overbook percent, seatings, confirmation SMS, automatic meeting link, default instructions). GET /Floor/Settings.',
5360
+ inputSchema: { type: 'object', properties: {}, required: [] },
5361
+ },
5362
+ {
5363
+ name: 'booking_floor_update_settings',
5364
+ description: 'Partially update the floor settings; only fields passed change. PUT /Floor/Settings.',
5365
+ inputSchema: { type: 'object', properties: { defaultTurnMinutes: { type: 'number', description: '5 to 600' }, overbookPercent: { type: 'number', description: '0 to 50' }, seatingsJson: { type: 'string', description: 'Seatings JSON' }, sendBookingConfirmationSms: { type: 'boolean', description: 'Send a confirmation SMS' }, autoCreateMeetingLink: { type: 'boolean', description: 'Create meeting links automatically' }, meetingOrganizerUpn: { type: 'string', description: 'Meeting organizer UPN' }, defaultInstructions: { type: 'string', description: 'Default guest instructions' } }, required: [] },
5366
+ },
5367
+ {
5368
+ name: 'booking_floor_update_table',
5369
+ description: 'Update one table: party range, turn minutes, combine group (empty text clears it). Only fields passed change. PUT /Floor/Tables/{resourceId}.',
5370
+ inputSchema: { type: 'object', properties: { resourceId: { type: 'number', description: 'Table (resource) ID. Required.' }, minParty: { type: 'number', description: 'Minimum party' }, maxParty: { type: 'number', description: 'Maximum party' }, turnMinutes: { type: 'number', description: 'Turn minutes' }, combineGroup: { type: 'string', description: 'Combine group' } }, required: ['resourceId'] },
5371
+ },
5372
+ {
5373
+ name: 'booking_floor_send_meeting_link',
5374
+ description: 'Send the meeting link for a booking to the guest now. POST /Floor/Bookings/{id}/SendMeetingLink.',
5375
+ inputSchema: { type: 'object', properties: { bookingId: { type: 'number', description: 'Booking ID. Required.' }, channel: { type: 'string', description: 'sms or email (default sms)' } }, required: ['bookingId'] },
5376
+ },
5377
+ {
5378
+ name: 'booking_mark_no_show',
5379
+ description: 'Mark a booking as a no-show. POST /Bookings/{id}/no-show.',
5380
+ inputSchema: { type: 'object', properties: { bookingId: { type: 'number', description: 'Booking ID. Required.' } }, required: ['bookingId'] },
5381
+ },
5382
+ {
5383
+ name: 'booking_set_deposit',
5384
+ description: 'Require or clear a deposit on a booking, with an optional amount. PUT /Bookings/{id}/deposit.',
5385
+ inputSchema: { type: 'object', properties: { bookingId: { type: 'number', description: 'Booking ID. Required.' }, required: { type: 'boolean', description: 'Whether a deposit is required. Required.' }, amount: { type: 'number', description: 'Deposit amount' } }, required: ['bookingId', 'required'] },
5386
+ },
5387
+ {
5388
+ name: 'booking_create_deposit_link',
5389
+ description: 'Create a deposit payment link for a booking. POST /Bookings/{id}/deposit/link.',
5390
+ inputSchema: { type: 'object', properties: { bookingId: { type: 'number', description: 'Booking ID. Required.' } }, required: ['bookingId'] },
5391
+ },
5392
+ {
5393
+ name: 'booking_deposit_status',
5394
+ description: 'Check a deposit payment by payment id. GET /Bookings/deposit/status.',
5395
+ inputSchema: { type: 'object', properties: { paymentId: { type: 'string', description: 'Payment ID. Required.' } }, required: ['paymentId'] },
5396
+ },
5397
+ {
5398
+ name: 'booking_analytics',
5399
+ description: 'Booking analytics for a date range: bookings and seats by status, no-shows, utilization per resource. GET /Bookings/analytics.',
5400
+ inputSchema: { type: 'object', properties: { fromUtc: { type: 'string', description: 'ISO 8601 UTC start' }, toUtc: { type: 'string', description: 'ISO 8601 UTC end' } }, required: [] },
5401
+ },
5402
+
5336
5403
  // Focus Inbox -- draft pregeneration usage/cap report ("Always Learning" addon,
5337
5404
  // issue #582 Phase D). Entitlements-gated (EnableFocusDraftPregeneration), not a
5338
5405
  // Subscription.cs flag -- the response's own `entitled` field is the source of
@@ -10031,6 +10098,62 @@ ${JSON.stringify(result, null, 2)}`;
10031
10098
  return JSON.stringify(result, null, 2);
10032
10099
  }
10033
10100
 
10101
+ // -- Scheduler floor + booking no-show / deposits / analytics --
10102
+ case 'booking_floor_list_waitlist': return JSON.stringify(await messagingGet('/Floor/Waitlist'), null, 2);
10103
+ case 'booking_floor_add_waitlist':
10104
+ case 'booking_floor_add_walk_in': {
10105
+ if (!args.guestName || !args.phone || args.partySize == null) return 'guestName, phone and partySize are required.';
10106
+ const body = { guestName: args.guestName, phone: args.phone, partySize: args.partySize, isVip: args.isVip, quotedWaitMinutes: args.quotedWaitMinutes, notes: args.notes };
10107
+ return JSON.stringify(await messagingPost(name === 'booking_floor_add_walk_in' ? '/Floor/WalkIn' : '/Floor/Waitlist', body), null, 2);
10108
+ }
10109
+ case 'booking_floor_waitlist_action': {
10110
+ const verbs = { ready: 'Ready', seat: 'Seat', remove: 'Remove', noshow: 'NoShow' };
10111
+ const verb = verbs[String(args.action || '').toLowerCase()];
10112
+ if (args.entryId == null || !verb) return 'entryId and action (ready | seat | remove | noshow) are required.';
10113
+ const body = args.resourceId != null ? { resourceId: args.resourceId } : {};
10114
+ return JSON.stringify(await messagingPost(`/Floor/Waitlist/${encodeURIComponent(args.entryId)}/${verb}`, body), null, 2);
10115
+ }
10116
+ case 'booking_floor_get_settings': return JSON.stringify(await messagingGet('/Floor/Settings'), null, 2);
10117
+ case 'booking_floor_update_settings': {
10118
+ const keys = ['defaultTurnMinutes', 'overbookPercent', 'seatingsJson', 'sendBookingConfirmationSms', 'autoCreateMeetingLink', 'meetingOrganizerUpn', 'defaultInstructions'];
10119
+ const body = {}; for (const k of keys) if (args[k] !== undefined) body[k] = args[k];
10120
+ if (!Object.keys(body).length) return 'Pass at least one setting to change.';
10121
+ return JSON.stringify(await messagingPut('/Floor/Settings', body), null, 2);
10122
+ }
10123
+ case 'booking_floor_update_table': {
10124
+ if (args.resourceId == null) return 'resourceId is required.';
10125
+ const body = {}; for (const k of ['minParty', 'maxParty', 'turnMinutes', 'combineGroup']) if (args[k] !== undefined) body[k] = args[k];
10126
+ if (!Object.keys(body).length) return 'Pass at least one table field to change.';
10127
+ return JSON.stringify(await messagingPut(`/Floor/Tables/${encodeURIComponent(args.resourceId)}`, body), null, 2);
10128
+ }
10129
+ case 'booking_floor_send_meeting_link': {
10130
+ if (args.bookingId == null) return 'bookingId is required.';
10131
+ return JSON.stringify(await messagingPost(`/Floor/Bookings/${encodeURIComponent(args.bookingId)}/SendMeetingLink`, { channel: args.channel || 'sms' }), null, 2);
10132
+ }
10133
+ case 'booking_mark_no_show': {
10134
+ if (args.bookingId == null) return 'bookingId is required.';
10135
+ return JSON.stringify(await messagingPost(`/Bookings/${encodeURIComponent(args.bookingId)}/no-show`, {}), null, 2);
10136
+ }
10137
+ case 'booking_set_deposit': {
10138
+ if (args.bookingId == null || typeof args.required !== 'boolean') return 'bookingId and required (true or false) are required.';
10139
+ const body = { required: args.required }; if (args.amount != null) body.amount = args.amount;
10140
+ return JSON.stringify(await messagingPut(`/Bookings/${encodeURIComponent(args.bookingId)}/deposit`, body), null, 2);
10141
+ }
10142
+ case 'booking_create_deposit_link': {
10143
+ if (args.bookingId == null) return 'bookingId is required.';
10144
+ return JSON.stringify(await messagingPost(`/Bookings/${encodeURIComponent(args.bookingId)}/deposit/link`, {}), null, 2);
10145
+ }
10146
+ case 'booking_deposit_status': {
10147
+ if (!args.paymentId) return 'paymentId is required.';
10148
+ return JSON.stringify(await messagingGet(`/Bookings/deposit/status?paymentId=${encodeURIComponent(args.paymentId)}`), null, 2);
10149
+ }
10150
+ case 'booking_analytics': {
10151
+ const params = [];
10152
+ if (args.fromUtc != null) params.push(`fromUtc=${encodeURIComponent(args.fromUtc)}`);
10153
+ if (args.toUtc != null) params.push(`toUtc=${encodeURIComponent(args.toUtc)}`);
10154
+ return JSON.stringify(await messagingGet(`/Bookings/analytics${params.length ? '?' + params.join('&') : ''}`), null, 2);
10155
+ }
10156
+
10034
10157
 
10035
10158
  // -- Wave: sentiment / quality / keyword intelligence / skill routing / QA rubric --
10036
10159
  case 'sentiment_report': {