@velaro/mcp-server 2.0.10 → 2.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "2.0.10",
+  "version": "2.0.11",
   "description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
   "type": "module",
   "bin": {

package/parity/callpresence.customer.js

@@ -0,0 +1,69 @@
+// velaro callpresence: call-presence policy (chat and call routing while an agent is on a phone call).
+// Site comes from the credential only. Parity module (CLI group -> MCP tools).
+
+const enc = encodeURIComponent;
+const pid = (v, n = 'id') => { const x = Number(v); if (!Number.isInteger(x) || x <= 0) throw new Error(n + ' must be a positive integer'); return x; };
+const need = (a, ...ks) => { for (const k of ks) if (a[k] === undefined || a[k] === null || a[k] === '') throw new Error(k + ' is required'); };
+
+const SCOPE = { type: 'string', enum: ['site', 'group', 'agent'], description: 'Level: site default, a routing group (id = team id) or an agent (id = agent id)' };
+
+export const tools = [
+  {
+    name: 'callpresence_get',
+    description: 'Get the call-presence policy: site default, routing-group and agent overrides, whether agents may override, and the allowed values. Controls chat/call routing while an agent is on a phone call and what happens when the call ends.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'callpresence_get_effective',
+    description: 'Get the resolved call-presence policy for one agent, with where each setting comes from (Agent override, Group override, Inherited from site, Platform default).',
+    inputSchema: { type: 'object', properties: { agentId: { type: 'integer', description: 'Agent (workspace user) id' }, teamId: { type: 'integer', description: 'Routing group to resolve against, for agents in several groups' } }, required: ['agentId'] },
+  },
+  {
+    name: 'callpresence_status',
+    description: 'List agents who are on a live phone call right now (Ringing, Active or OnHold call records), with call counts and whether a second call is live.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'callpresence_set',
+    description: 'Set the call-presence policy at one level. Omit a setting to inherit it. whileOnCall: NoChats | TakeChats | FinishThenOffline. afterCall: ReturnAutomatically | AskAgent | StayOffline. callsWhileBusy: NoCallsWhileBusy | RingEvenWhenBusy. allowAgentOverrides applies to the site level only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        scope: SCOPE,
+        id: { type: 'integer', description: 'Team id (group) or agent id (agent). Omit for site.' },
+        whileOnCall: { type: 'string', enum: ['NoChats', 'TakeChats', 'FinishThenOffline'] },
+        afterCall: { type: 'string', enum: ['ReturnAutomatically', 'AskAgent', 'StayOffline'] },
+        callsWhileBusy: { type: 'string', enum: ['NoCallsWhileBusy', 'RingEvenWhenBusy'] },
+        allowAgentOverrides: { type: 'boolean', description: 'Site level only: may agents set their own override' },
+      },
+      required: ['scope'],
+    },
+  },
+  {
+    name: 'callpresence_clear',
+    description: 'Remove the call-presence policy at one level so it inherits from the level above again.',
+    inputSchema: { type: 'object', properties: { scope: SCOPE, id: { type: 'integer', description: 'Team id (group) or agent id (agent). Omit for site.' } }, required: ['scope'] },
+  },
+];
+
+const target = (a) => {
+  need(a, 'scope');
+  if (!['site', 'group', 'agent'].includes(a.scope)) throw new Error('scope must be site, group or agent');
+  return a.scope === 'site' ? 'site/0' : `${a.scope}/${pid(a.id, 'id')}`;
+};
+
+export const handlers = {
+  callpresence_get: async (a, ctx) => ctx.messagingGet('/CallPresencePolicy'),
+  callpresence_get_effective: async (a, ctx) => {
+    need(a, 'agentId');
+    const q = a.teamId ? `?teamId=${pid(a.teamId, 'teamId')}` : '';
+    return ctx.messagingGet(`/CallPresencePolicy/effective/${pid(a.agentId, 'agentId')}${q}`);
+  },
+  callpresence_status: async (a, ctx) => ctx.messagingGet('/CallPresencePolicy/presence'),
+  callpresence_set: async (a, ctx) => {
+    const body = { whileOnCall: a.whileOnCall ?? null, afterCall: a.afterCall ?? null, callsWhileBusy: a.callsWhileBusy ?? null };
+    if (a.scope === 'site' && a.allowAgentOverrides !== undefined) body.allowAgentOverrides = a.allowAgentOverrides;
+    return ctx.messagingRequest('PUT', '/CallPresencePolicy/' + target(a), body);
+  },
+  callpresence_clear: async (a, ctx) => ctx.messagingRequest('DELETE', '/CallPresencePolicy/' + target(a)),
+};

package/tool-annotations.js

@@ -24,7 +24,7 @@ const MUTATING = new Set([
   'monday_set_field_mapping', 'teams_push_settings_update', 'teams_channel_config_update',
   'routing_team_update_config', 'pickup_update_config', 'payment_recovery_update_config',
   'recruiting_sync_jobs', 'ai_config_set_reply_format', 'magento_set_sidebar_fields',
-  'zoom_phone_set_config',
+  'zoom_phone_set_config', 'callpresence_set', 'callpresence_clear',
   'billing_insights_set_preferences', 'billing_insights_dismiss_recommendation',
   'site_sale_create', 'site_sale_update', 'site_sale_end',
 ]);