@velaro/mcp-server 2.0.105 → 2.0.106

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 +33 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.105",
3
+ "version": "2.0.106",
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
@@ -334,7 +334,7 @@ const MESSAGING_ADMIN_TOOLS = new Set([
334
334
  'ai_config_attach_index', 'ai_config_set_reply_format', 'call_pop_settings_get', 'call_pop_settings_set',
335
335
  'crm_mobile_fields_get', 'crm_mobile_fields_set',
336
336
  'agent_list', 'team_list', 'conversation_list', 'conversation_get', 'conversation_search',
337
- 'contact_search', 'contact_get', 'routing_list', 'routing_get', 'site_info',
337
+ 'contact_search', 'contact_get', 'contacts_api_custom_fields', 'routing_list', 'routing_get', 'site_info',
338
338
  'linked_identity_list', 'linked_identity_unlink',
339
339
  'ms_bookings_cancel_appointment', 'ms_bookings_check_availability_range', 'ms_bookings_reschedule_appointment',
340
340
  'outlook_calendar_cancel', 'outlook_calendar_get_available_range',
@@ -5301,6 +5301,31 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5301
5301
  {"name":"ai_field_extraction_update_config","description":"Update AI field extraction config (partial). enabled, monthlyCap (null = 500 default, hard ceiling 50000), createThemeTags.","inputSchema":{"type":"object","properties":{"enabled":{"type":"boolean"},"monthlyCap":{"type":"number"},"createThemeTags":{"type":"boolean"}}}},
5302
5302
  {"name":"ai_field_extraction_correct_field","description":"Agent correction of an extracted field on a conversation.","inputSchema":{"type":"object","properties":{"conversationId":{"type":"number"},"fieldName":{"type":"string"},"value":{"type":"string"}},"required":["conversationId","fieldName","value"]}},
5303
5303
  {"name":"qa_calibration","description":"QA calibration report (AI score vs human review) for the last N days.","inputSchema":{"type":"object","properties":{"days":{"type":"number"}}}},
5304
+ {
5305
+ name: 'contacts_api_delete',
5306
+ description: "Soft-delete a contact via the public REST API (restorable for 30 days).",
5307
+ inputSchema: {"type": "object", "properties": {"id": {"type": "number"}}, "required": ["id"]},
5308
+ },
5309
+ {
5310
+ name: 'contacts_api_upsert',
5311
+ description: "Create or update a contact matched by uniqueId, then email, then phone. At least one is required.",
5312
+ inputSchema: {"type": "object", "properties": {"uniqueId": {"type": "string"}, "email": {"type": "string"}, "phone": {"type": "string"}, "firstName": {"type": "string"}, "lastName": {"type": "string"}, "company": {"type": "string"}, "jobTitle": {"type": "string"}}},
5313
+ },
5314
+ {
5315
+ name: 'contacts_api_custom_fields',
5316
+ description: "List the site's custom contact field definitions (vault and internal fields are never returned).",
5317
+ inputSchema: {"type": "object", "properties": {}},
5318
+ },
5319
+ {
5320
+ name: 'contacts_api_sms',
5321
+ description: "Send an SMS to an existing contact. Requires the SMS channel; opted-out recipients are refused.",
5322
+ inputSchema: {"type": "object", "properties": {"contactId": {"type": "number"}, "body": {"type": "string"}}, "required": ["contactId", "body"]},
5323
+ },
5324
+ {
5325
+ name: 'contacts_api_whatsapp',
5326
+ description: "Send an approved WhatsApp template to an existing contact. idempotencyKey is required; opted-out recipients are refused.",
5327
+ inputSchema: {"type": "object", "properties": {"contactId": {"type": "number"}, "templateName": {"type": "string"}, "language": {"type": "string"}, "variables": {"type": "array", "items": {"type": "string"}}, "idempotencyKey": {"type": "string"}}, "required": ["contactId", "templateName", "idempotencyKey"]},
5328
+ },
5304
5329
  {"name":"qa_alert_settings","description":"Get or set quality alert settings. Omit \"settings\" to read; pass it to update.","inputSchema":{"type":"object","properties":{"settings":{"type":"object"}}}},
5305
5330
  ];
5306
5331
 
@@ -5703,6 +5728,12 @@ async function handleTool(name, args) {
5703
5728
  return `Restored #${args.id}.`;
5704
5729
  }
5705
5730
 
5731
+ case 'contacts_api_delete': return JSON.stringify(await api('DELETE', `/api/v1/contacts/${args.id}`), null, 2);
5732
+ case 'contacts_api_upsert': return JSON.stringify(await api('POST', '/api/v1/contacts/upsert', args), null, 2);
5733
+ case 'contacts_api_custom_fields': return JSON.stringify(await api('GET', '/api/v1/custom-fields'), null, 2);
5734
+ case 'contacts_api_sms': return JSON.stringify(await api('POST', '/api/v1/sms', { contactId: args.contactId, body: args.body }), null, 2);
5735
+ case 'contacts_api_whatsapp': return JSON.stringify(await api('POST', '/api/v1/whatsapp', args), null, 2);
5736
+
5706
5737
  case 'contactsegment_list_deleted': {
5707
5738
  const rows = await api('GET', `/ContactSegments/deleted`);
5708
5739
  if (!Array.isArray(rows) || !rows.length) return 'Nothing in Recently deleted.';
@@ -6425,7 +6456,7 @@ reply: ${r?.reply}`;
6425
6456
  }
6426
6457
 
6427
6458
  // POST api/v1/contacts -> PublicApiController.UpsertContact
6428
- case 'contact_upsert': {
6459
+ case 'contacts_api_upsert': {
6429
6460
  const r = await api('POST', '/api/v1/contacts', args);
6430
6461
  return `${r.created ? 'Created' : 'Updated'} contact #${r.id} (${r.email})${r.tags?.length ? ' tags: ' + r.tags.join(', ') : ''}`;
6431
6462
  }