@velaro/mcp-server 2.0.105 → 2.0.107

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 +49 -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.107",
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',
@@ -489,6 +489,16 @@ const TOOLS = [
489
489
  description: 'Restore a saved version of the signature policy (site administrators only). The restored settings are saved as a NEW version. Use signature_policy_history to find the versionId.',
490
490
  inputSchema: { type: 'object', properties: { versionId: { type: 'integer' } }, required: ['versionId'] },
491
491
  },
492
+ {
493
+ name: 'apollo_status',
494
+ description: 'Apollo prospecting connection state for this site: connected or not, masked key, usage counters and terms acceptance. Read only.',
495
+ inputSchema: { type: 'object', properties: {}, required: [] },
496
+ },
497
+ {
498
+ name: 'apollo_presets',
499
+ description: 'List the Apollo prospecting search presets available to this site. Read only.',
500
+ inputSchema: { type: 'object', properties: {}, required: [] },
501
+ },
492
502
  {
493
503
  name: 'kb_list_topics',
494
504
  description: 'List all KB topics. Call this first to find the topicId needed for creating articles.',
@@ -5301,6 +5311,31 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
5301
5311
  {"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
5312
  {"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
5313
  {"name":"qa_calibration","description":"QA calibration report (AI score vs human review) for the last N days.","inputSchema":{"type":"object","properties":{"days":{"type":"number"}}}},
5314
+ {
5315
+ name: 'contacts_api_delete',
5316
+ description: "Soft-delete a contact via the public REST API (restorable for 30 days).",
5317
+ inputSchema: {"type": "object", "properties": {"id": {"type": "number"}}, "required": ["id"]},
5318
+ },
5319
+ {
5320
+ name: 'contacts_api_upsert',
5321
+ description: "Create or update a contact matched by uniqueId, then email, then phone. At least one is required.",
5322
+ 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"}}},
5323
+ },
5324
+ {
5325
+ name: 'contacts_api_custom_fields',
5326
+ description: "List the site's custom contact field definitions (vault and internal fields are never returned).",
5327
+ inputSchema: {"type": "object", "properties": {}},
5328
+ },
5329
+ {
5330
+ name: 'contacts_api_sms',
5331
+ description: "Send an SMS to an existing contact. Requires the SMS channel; opted-out recipients are refused.",
5332
+ inputSchema: {"type": "object", "properties": {"contactId": {"type": "number"}, "body": {"type": "string"}}, "required": ["contactId", "body"]},
5333
+ },
5334
+ {
5335
+ name: 'contacts_api_whatsapp',
5336
+ description: "Send an approved WhatsApp template to an existing contact. idempotencyKey is required; opted-out recipients are refused.",
5337
+ 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"]},
5338
+ },
5304
5339
  {"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
5340
  ];
5306
5341
 
@@ -5547,6 +5582,12 @@ async function handleTool(name, args) {
5547
5582
  return JSON.stringify(await messagingPost(`/Signatures/policy/rollback/${args.versionId}`, {}), null, 2);
5548
5583
  }
5549
5584
 
5585
+ case 'apollo_status':
5586
+ return JSON.stringify(await api('GET', '/Apollo/Status'), null, 2);
5587
+
5588
+ case 'apollo_presets':
5589
+ return JSON.stringify(await api('GET', '/Apollo/Presets'), null, 2);
5590
+
5550
5591
  case 'kb_list_topics': {
5551
5592
  const data = await api('GET', '/api/kb/topics');
5552
5593
  const topics = data?.topics ?? [];
@@ -5703,6 +5744,12 @@ async function handleTool(name, args) {
5703
5744
  return `Restored #${args.id}.`;
5704
5745
  }
5705
5746
 
5747
+ case 'contacts_api_delete': return JSON.stringify(await api('DELETE', `/api/v1/contacts/${args.id}`), null, 2);
5748
+ case 'contacts_api_upsert': return JSON.stringify(await api('POST', '/api/v1/contacts/upsert', args), null, 2);
5749
+ case 'contacts_api_custom_fields': return JSON.stringify(await api('GET', '/api/v1/custom-fields'), null, 2);
5750
+ case 'contacts_api_sms': return JSON.stringify(await api('POST', '/api/v1/sms', { contactId: args.contactId, body: args.body }), null, 2);
5751
+ case 'contacts_api_whatsapp': return JSON.stringify(await api('POST', '/api/v1/whatsapp', args), null, 2);
5752
+
5706
5753
  case 'contactsegment_list_deleted': {
5707
5754
  const rows = await api('GET', `/ContactSegments/deleted`);
5708
5755
  if (!Array.isArray(rows) || !rows.length) return 'Nothing in Recently deleted.';
@@ -6425,7 +6472,7 @@ reply: ${r?.reply}`;
6425
6472
  }
6426
6473
 
6427
6474
  // POST api/v1/contacts -> PublicApiController.UpsertContact
6428
- case 'contact_upsert': {
6475
+ case 'contacts_api_upsert': {
6429
6476
  const r = await api('POST', '/api/v1/contacts', args);
6430
6477
  return `${r.created ? 'Created' : 'Updated'} contact #${r.id} (${r.email})${r.tags?.length ? ' tags: ' + r.tags.join(', ') : ''}`;
6431
6478
  }