@velaro/mcp-server 2.0.73 → 2.0.75

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 +40 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.73",
3
+ "version": "2.0.75",
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
@@ -1595,6 +1595,19 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
1595
1595
  required: ['email'],
1596
1596
  },
1597
1597
  },
1598
+ {
1599
+ name: 'contact_update',
1600
+ description: "Partially update one contact by id (PATCH /api/v1/contacts/{id}, scope write:contacts). Only the fields sent change; 404 if the contact is not on this site, 409 if the new email belongs to another contact.",
1601
+ inputSchema: {
1602
+ type: 'object',
1603
+ properties: {
1604
+ contactId: { type: 'number' }, email: { type: 'string' }, firstName: { type: 'string' }, lastName: { type: 'string' },
1605
+ phone: { type: 'string' }, mobile: { type: 'string' }, company: { type: 'string' }, jobTitle: { type: 'string' },
1606
+ tags: { type: 'array', items: { type: 'string' } },
1607
+ },
1608
+ required: ['contactId'],
1609
+ },
1610
+ },
1598
1611
  {
1599
1612
  name: 'contact_tag',
1600
1613
  description: "Tag a contact by email (or contactId); the tag is created if new (POST /api/v1/contacts/tag).",
@@ -4873,6 +4886,15 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
4873
4886
  // /BookableResources, /BookableServices, /ResourceAvailabilityRules. SiteId always
4874
4887
  // derives server-side from the caller's auth context, never a tool argument (IDOR).
4875
4888
  // See velaro-admin memory project_2026_09_06_generic_booking_engine_schema_plan.md.
4889
+ {
4890
+ name: 'booking_list_upcoming',
4891
+ description: 'List upcoming appointments (default next 7 days, at most 62 days). Optional scope me|team|group and teamId.',
4892
+ inputSchema: { type: 'object', properties: {
4893
+ scope: { type: 'string', description: 'me, team or group' },
4894
+ teamId: { type: 'number' },
4895
+ fromUtc: { type: 'string', description: 'ISO 8601 UTC start' },
4896
+ toUtc: { type: 'string', description: 'ISO 8601 UTC end' } }, required: [] },
4897
+ },
4876
4898
  {
4877
4899
  name: 'booking_list_resources',
4878
4900
  description: 'List bookable resources (staff / room / equipment / virtual) for this site.',
@@ -6191,6 +6213,14 @@ reply: ${r?.reply}`;
6191
6213
  return `${r.created ? 'Created' : 'Updated'} contact #${r.id} (${r.email})${r.tags?.length ? ' tags: ' + r.tags.join(', ') : ''}`;
6192
6214
  }
6193
6215
 
6216
+ // PATCH api/v1/contacts/{id} -> PublicApiController.PatchContact
6217
+ case 'contact_update': {
6218
+ const { contactId, ...body } = args || {};
6219
+ if (!contactId) return 'Error: contactId is required.';
6220
+ const r = await api('PATCH', `/api/v1/contacts/${encodeURIComponent(contactId)}`, body);
6221
+ return `Updated contact #${r.id} (${r.email})${r.tags?.length ? ' tags: ' + r.tags.join(', ') : ''}`;
6222
+ }
6223
+
6194
6224
  // POST api/v1/contacts/tag -> PublicApiController.TagContact
6195
6225
  case 'contact_tag': {
6196
6226
  const r = await api('POST', '/api/v1/contacts/tag', args);
@@ -9389,6 +9419,16 @@ ${JSON.stringify(result, null, 2)}`;
9389
9419
  }
9390
9420
 
9391
9421
  // -- Generic Booking Engine (Phase 1b) --
9422
+ case 'booking_list_upcoming': {
9423
+ const q = new URLSearchParams();
9424
+ if (args.scope) q.set('scope', String(args.scope));
9425
+ if (args.teamId != null) q.set('teamId', String(args.teamId));
9426
+ if (args.fromUtc) q.set('fromUtc', String(args.fromUtc));
9427
+ if (args.toUtc) q.set('toUtc', String(args.toUtc));
9428
+ const result = await messagingGet(`/Appointments${q.toString() ? '?' + q : ''}`);
9429
+ return JSON.stringify(result, null, 2);
9430
+ }
9431
+
9392
9432
  case 'booking_list_resources': {
9393
9433
  const result = await messagingGet('/BookableResources');
9394
9434
  return JSON.stringify(result, null, 2);