@velaro/mcp-server 2.0.130 → 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.130",
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
  },
@@ -10149,6 +10173,10 @@ ${JSON.stringify(result, null, 2)}`;
10149
10173
  name: args.name,
10150
10174
  resourceType: args.resourceType,
10151
10175
  isActive: args.isActive,
10176
+ minParty: args.minParty,
10177
+ maxParty: args.maxParty,
10178
+ turnMinutes: args.turnMinutes,
10179
+ combineGroup: args.combineGroup,
10152
10180
  });
10153
10181
  return JSON.stringify(result, null, 2);
10154
10182
  }
@@ -10159,6 +10187,10 @@ ${JSON.stringify(result, null, 2)}`;
10159
10187
  name: args.name,
10160
10188
  resourceType: args.resourceType,
10161
10189
  isActive: args.isActive,
10190
+ minParty: args.minParty,
10191
+ maxParty: args.maxParty,
10192
+ turnMinutes: args.turnMinutes,
10193
+ combineGroup: args.combineGroup,
10162
10194
  });
10163
10195
  return JSON.stringify(result, null, 2);
10164
10196
  }
@@ -10189,6 +10221,14 @@ ${JSON.stringify(result, null, 2)}`;
10189
10221
  requiresResource: args.requiresResource,
10190
10222
  category: args.category,
10191
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,
10192
10232
  });
10193
10233
  return JSON.stringify(result, null, 2);
10194
10234
  }
@@ -10202,6 +10242,14 @@ ${JSON.stringify(result, null, 2)}`;
10202
10242
  requiresResource: args.requiresResource,
10203
10243
  category: args.category,
10204
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,
10205
10253
  });
10206
10254
  return JSON.stringify(result, null, 2);
10207
10255
  }