@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 +4 -2
- package/package.json +1 -1
- package/parity/crm-calculated-fields.customer.js +1 -0
- package/parity/loader.js +13 -2
- package/server.js +50 -2
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
|
-
- **
|
|
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
|
|
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.
|
|
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
|
-
|
|
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
|
}
|