@velaro/mcp-server 0.6.68 → 0.6.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.68",
+  "version": "0.6.69",
   "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/server.js

@@ -2756,6 +2756,59 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  // ── Velaro Avatar (first-party provider) — library, personalities, site/group inheritance ──
+  {
+    name: 'avatar_list_library',
+    description: 'List Velaro Avatar library entries (realistic and character) with id slug, name, kind, hasImage, default personality. Lives in velaro-messaging — requires VELARO_MESSAGING_API.',
+    inputSchema: { type: 'object', properties: { kind: { type: 'string', description: '"realistic" or "character". Omit for all.' } } },
+  },
+  {
+    name: 'avatar_list_personalities',
+    description: 'List Velaro Avatar personality presets (tone/style) that can be selected at site or group level.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'avatar_set_site_default',
+    description: 'Set the calling site\'s default avatar provider, avatar and personality (applies to all groups without an override). Provider "velaro" is the default Velaro-owned avatar; "simli", "d-id", "heygen", "none" also valid.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        providerSlug: { type: 'string', description: 'velaro | simli | d-id | heygen | none' },
+        avatarId: { type: 'string', description: 'Library slug when provider is velaro, else the provider avatar id.' },
+        personalityPresetSlug: { type: 'string', description: 'Personality preset slug.' },
+      },
+    },
+  },
+  {
+    name: 'avatar_get_group_effective',
+    description: 'Show the effective avatar settings for a group (group override field, else site default) and whether an override exists.',
+    inputSchema: { type: 'object', properties: { groupId: { type: 'number' } }, required: ['groupId'] },
+  },
+  {
+    name: 'avatar_set_group_override',
+    description: 'Override avatar/personality/provider for one group. Omitted fields inherit the site default.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        groupId: { type: 'number' },
+        providerSlug: { type: 'string' },
+        avatarId: { type: 'string' },
+        personalityPresetSlug: { type: 'string' },
+      },
+      required: ['groupId'],
+    },
+  },
+  {
+    name: 'avatar_reset_group',
+    description: 'Reset one group to the site default avatar settings (removes its override).',
+    inputSchema: { type: 'object', properties: { groupId: { type: 'number' } }, required: ['groupId'] },
+  },
+  {
+    name: 'avatar_reset_all_overrides',
+    description: 'Reset ALL group overrides for the calling site back to the site default.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+
   // ── Calendly integration management (superadmin) ──────────────────────────
   {
     name: 'calendly_get_status',
@@ -7488,6 +7541,23 @@ async function handleTool(name, args) {
       return `✓ AI Video Avatar updated for site ${args.siteId}. Provider: ${res.providerSlug}, enabled: ${res.enabled}`;
     }
 
+    case 'avatar_list_library':
+      return JSON.stringify(await messagingRequest('GET', `/avatar/library${args.kind ? `?kind=${encodeURIComponent(args.kind)}` : ''}`), null, 2);
+    case 'avatar_list_personalities':
+      return JSON.stringify(await messagingRequest('GET', '/avatar/personalities'), null, 2);
+    case 'avatar_set_site_default':
+      return JSON.stringify(await messagingRequest('POST', '/avatar/site-default', {
+        providerSlug: args.providerSlug, avatarId: args.avatarId, personalityPresetSlug: args.personalityPresetSlug }), null, 2);
+    case 'avatar_get_group_effective':
+      return JSON.stringify(await messagingRequest('GET', `/avatar/groups/${Number(args.groupId)}/effective`), null, 2);
+    case 'avatar_set_group_override':
+      return JSON.stringify(await messagingRequest('PUT', `/avatar/groups/${Number(args.groupId)}/override`, {
+        providerSlug: args.providerSlug, avatarId: args.avatarId, personalityPresetSlug: args.personalityPresetSlug }), null, 2);
+    case 'avatar_reset_group':
+      return JSON.stringify(await messagingRequest('DELETE', `/avatar/groups/${Number(args.groupId)}/override`), null, 2);
+    case 'avatar_reset_all_overrides':
+      return JSON.stringify(await messagingRequest('POST', '/avatar/group-overrides/reset-all', {}), null, 2);
+
     case 'calendly_get_status': {
       // `env`, when given, targets one specific admin API environment instead of whatever
       // VELARO_ADMIN_API this server process happens to be configured with — see ADMIN_API_HOSTS