@opencx/mcp 1.15.75 → 1.15.77

package/dist/tools/salesforce-integration.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { jsonContent } from '../api-client.js';
+import { registerSalesforceAiReplyTemplateTools } from './salesforce-ai-reply-templates.js';
+// Registered by createServer only when the org has this integration connected.
+// The AI reply template tools ride along: they only apply to Salesforce orgs.
+export function registerSalesforceIntegrationTools(server, client) {
+    registerSalesforceAiReplyTemplateTools(server, client);
+    server.registerTool('get_salesforce_settings', {
+        description: 'Get the Salesforce settings: case_management (assist drafts, auto-fill, Case comments, first-email content) and miaw (messaging deployment). A section is null when that side is not connected. Credentials are never returned.',
+        annotations: { title: 'Get Salesforce settings', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/salesforce/settings')).data));
+    server.registerTool('update_salesforce_settings', {
+        description: 'Change Salesforce settings. Pass only the fields to change. case_management needs Case management connected; miaw needs messaging configured.',
+        inputSchema: {
+            case_management: z
+                .object({
+                assist_replies_as_drafts: z
+                    .boolean()
+                    .optional()
+                    .describe('true = assist suggestions become editable email drafts on the Case instead of private comments'),
+                draft_from_address: z
+                    .string()
+                    .nullable()
+                    .optional()
+                    .describe('From address on those drafts — must be from list_salesforce_org_wide_addresses; null = composer default'),
+                autofill_fields_on_assist_mode: z
+                    .boolean()
+                    .optional()
+                    .describe('true = AI Case-field auto-fill writes to the Case on assist sessions too'),
+                include_session_url_in_case_comment: z
+                    .boolean()
+                    .optional()
+                    .describe('true = Case comments include a link to the session'),
+                post_handoff_case_comment: z
+                    .boolean()
+                    .optional()
+                    .describe('true = a handoff posts a summary comment on the Case'),
+                prefer_first_email_content: z
+                    .boolean()
+                    .optional()
+                    .describe("true = new sessions start from the Case's first email instead of its description"),
+            })
+                .optional(),
+            miaw: z
+                .object({
+                es_developer_name: z
+                    .string()
+                    .nullable()
+                    .optional()
+                    .describe('Developer name of the Embedded Service deployment for messaging'),
+                salesforce_org_id: z.string().nullable().optional().describe('Salesforce org id (00D…)'),
+            })
+                .optional(),
+        },
+        annotations: { title: 'Update Salesforce settings', destructiveHint: true },
+    }, async (input) => {
+        const body = input;
+        return jsonContent((await client.PATCH('/integrations/salesforce/settings', { body })).data);
+    });
+    server.registerTool('list_salesforce_org_wide_addresses', {
+        description: 'List the verified org-wide email addresses of the connected Salesforce org — the valid values for case_management.draft_from_address.',
+        annotations: { title: 'List Salesforce org-wide addresses', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/salesforce/org-wide-addresses')).data));
+}
+//# sourceMappingURL=salesforce-integration.js.map

package/dist/tools/salesforce-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesforce-integration.js","sourceRoot":"","sources":["../../src/tools/salesforce-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAK5F,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,UAAU,kCAAkC,CAAC,MAAiB,EAAE,MAAoB;IACxF,sCAAsC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvD,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,iOAAiO;QACnO,WAAW,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,IAAI,EAAE;KACtE,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC,CACtF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,+IAA+I;QACjJ,WAAW,EAAE;YACX,eAAe,EAAE,CAAC;iBACf,MAAM,CAAC;gBACN,wBAAwB,EAAE,CAAC;qBACxB,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,gGAAgG,CAAC;gBAC7G,kBAAkB,EAAE,CAAC;qBAClB,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,EAAE;qBACV,QAAQ,CAAC,yGAAyG,CAAC;gBACtH,8BAA8B,EAAE,CAAC;qBAC9B,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,0EAA0E,CAAC;gBACvF,mCAAmC,EAAE,CAAC;qBACnC,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,oDAAoD,CAAC;gBACjE,yBAAyB,EAAE,CAAC;qBACzB,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,sDAAsD,CAAC;gBACnE,0BAA0B,EAAE,CAAC;qBAC1B,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,kFAAkF,CAAC;aAChG,CAAC;iBACD,QAAQ,EAAE;YACb,IAAI,EAAE,CAAC;iBACJ,MAAM,CAAC;gBACN,iBAAiB,EAAE,CAAC;qBACjB,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,EAAE;qBACV,QAAQ,CAAC,iEAAiE,CAAC;gBAC9E,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;aACzF,CAAC;iBACD,QAAQ,EAAE;SACd;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,eAAe,EAAE,IAAI,EAAE;KAC5E,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAe,KAAK,CAAC;QAC/B,OAAO,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/F,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oCAAoC,EACpC;QACE,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,YAAY,EAAE,IAAI,EAAE;KACjF,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC,IAAI,CAAC,CAChG,CAAC;AACJ,CAAC"}

package/dist/tools/team-settings.d.ts

@@ -13,6 +13,8 @@ export declare const teamSettingsShape: {
     phone_sla_policy_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     support_assignment_strategy: z.ZodOptional<z.ZodEnum<["least-busy", "round-robin", "unassigned"]>>;
     auto_assign_interval_seconds: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, number>>;
+    call_recording_enabled: z.ZodOptional<z.ZodBoolean>;
+    call_languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 };
 export declare function registerTeamSettingsTools(server: McpServer, client: OpenCXClient): void;
 //# sourceMappingURL=team-settings.d.ts.map

package/dist/tools/team-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team-settings.d.ts","sourceRoot":"","sources":["../../src/tools/team-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CA2E7B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA2BhF"}
+{"version":3,"file":"team-settings.d.ts","sourceRoot":"","sources":["../../src/tools/team-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAuF7B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA2BhF"}

package/dist/tools/team-settings.js

@@ -74,6 +74,14 @@ export const teamSettingsShape = {
         .refine((value) => value === 0 || value >= 15, 'Use 0 to disable pacing, or 15 to 3600 seconds')
         .optional()
         .describe('Seconds between assignments to the same agent under least-busy: 0 disables pacing'),
+    call_recording_enabled: z
+        .boolean()
+        .optional()
+        .describe('Record calls answered by this team. When off, answering does not start a recording; one the phone agent or call flow already started keeps running.'),
+    call_languages: z
+        .array(z.string())
+        .optional()
+        .describe('Languages spoken on calls this team answers (language codes). Live transcripts of those calls stay in these languages; empty uses the organization default.'),
 };
 export function registerTeamSettingsTools(server, client) {
     server.registerTool('update_team_settings', {

package/dist/tools/team-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"team-settings.js","sourceRoot":"","sources":["../../src/tools/team-settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"team-settings.js","sourceRoot":"","sources":["../../src/tools/team-settings.ts"],"names":[],"mappings":"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"}

package/dist/tools/twilio-flex-integration.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OpenCXClient } from '../api-client.js';
+export declare function registerTwilioFlexIntegrationTools(server: McpServer, client: OpenCXClient): void;
+//# sourceMappingURL=twilio-flex-integration.d.ts.map

package/dist/tools/twilio-flex-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-flex-integration.d.ts","sourceRoot":"","sources":["../../src/tools/twilio-flex-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QAgEzF"}

package/dist/tools/twilio-flex-integration.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { jsonContent } from '../api-client.js';
+// Registered by createServer only when the org has this integration connected.
+export function registerTwilioFlexIntegrationTools(server, client) {
+    server.registerTool('get_twilio_flex_settings', {
+        description: 'Read the Twilio Flex integration settings: account and workspace, AI queue and workers, handoff toggles and contact-synced task attributes. The auth token is never returned.',
+        annotations: { title: 'Get Twilio Flex settings', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/twilio-flex/settings')).data));
+    server.registerTool('update_twilio_flex_settings', {
+        description: 'Change Twilio Flex integration settings. Only the fields you pass change. Credentials cannot be changed here, and the workspace is not re-provisioned. The response lists synced attribute names that will never match.',
+        inputSchema: {
+            ai_queue_sid: z
+                .string()
+                .optional()
+                .describe('TaskRouter queue SID for AI-handled conversations; empty string clears it'),
+            ai_worker_email_domain: z
+                .string()
+                .nullable()
+                .optional()
+                .describe('Domain (e.g. example.com) used to give each AI worker an email; null clears it'),
+            internal_notes_enabled: z
+                .boolean()
+                .optional()
+                .describe('Post the handoff summary into the conversation. Twilio has no private notes, so the customer sees it too.'),
+            interactions_handoff_enabled: z
+                .boolean()
+                .optional()
+                .describe('OpenCX routes the handoff itself through Flex Interactions. Leave off if their Flex flow already handles the handoff webhook — both on means duplicate chat requests.'),
+            contact_synced_task_attributes: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Task attribute names copied onto the contact (e.g. "user_id", "customers.name"); replaces the list. See list_twilio_flex_task_attributes.'),
+        },
+        annotations: { title: 'Update Twilio Flex settings', destructiveHint: false },
+    }, async (args) => {
+        const body = args;
+        return jsonContent((await client.PATCH('/integrations/twilio-flex/settings', { body })).data);
+    });
+    server.registerTool('list_twilio_flex_task_attributes', {
+        description: "List the task attribute names the org's Flex workflow actually sends, sampled from recent tasks. Empty means unknown, not none.",
+        annotations: { title: 'List Twilio Flex task attributes', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/twilio-flex/task-attributes')).data));
+}
+//# sourceMappingURL=twilio-flex-integration.js.map

package/dist/tools/twilio-flex-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-flex-integration.js","sourceRoot":"","sources":["../../src/tools/twilio-flex-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAO/C,+EAA+E;AAC/E,MAAM,UAAU,kCAAkC,CAAC,MAAiB,EAAE,MAAoB;IACxF,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,WAAW,EACT,+KAA+K;QACjL,WAAW,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,YAAY,EAAE,IAAI,EAAE;KACvE,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,CACvF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,WAAW,EACT,yNAAyN;QAC3N,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;YACxF,sBAAsB,EAAE,CAAC;iBACtB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF,CACjF;YACH,sBAAsB,EAAE,CAAC;iBACtB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,2GAA2G,CAC5G;YACH,4BAA4B,EAAE,CAAC;iBAC5B,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,uKAAuK,CACxK;YACH,8BAA8B,EAAE,CAAC;iBAC9B,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBACxB,QAAQ,EAAE;iBACV,QAAQ,CACP,2IAA2I,CAC5I;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,eAAe,EAAE,KAAK,EAAE;KAC9E,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAe,IAAI,CAAC;QAC9B,OAAO,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChG,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kCAAkC,EAClC;QACE,WAAW,EACT,iIAAiI;QACnI,WAAW,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,YAAY,EAAE,IAAI,EAAE;KAC/E,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/tools/zendesk-integration.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OpenCXClient } from '../api-client.js';
+export declare function registerZendeskIntegrationTools(server: McpServer, client: OpenCXClient): void;
+//# sourceMappingURL=zendesk-integration.d.ts.map

package/dist/tools/zendesk-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zendesk-integration.d.ts","sourceRoot":"","sources":["../../src/tools/zendesk-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA6EtF"}

package/dist/tools/zendesk-integration.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { jsonContent } from '../api-client.js';
+// Registered by createServer only when the org has this integration connected.
+export function registerZendeskIntegrationTools(server, client) {
+    server.registerTool('get_zendesk_settings', {
+        description: 'Get the Zendesk integration settings: ticket creation and assignment defaults, web/email handoff behaviour, internal notes, the handoff note and recipient editing. Credentials are never returned; connected:false means Zendesk is not connected.',
+        annotations: { title: 'Get Zendesk settings', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/zendesk/settings')).data));
+    server.registerTool('update_zendesk_settings', {
+        description: 'Change Zendesk integration settings. Pass only the fields to change; the rest stay as they are. Credentials and the subdomain cannot be changed here (the dashboard connects Zendesk).',
+        inputSchema: {
+            default_agent_id: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Zendesk user id new tickets are assigned to when no team mapping applies'),
+            default_agent_group_id: z
+                .string()
+                .nullable()
+                .optional()
+                .describe('Zendesk group id for new tickets when no team mapping applies (see list_zendesk_groups); null = none'),
+            create_ticket_only_on_handoff: z
+                .boolean()
+                .optional()
+                .describe('true = create the Zendesk ticket only when the session is handed off'),
+            skip_handoff_for_web: z
+                .boolean()
+                .optional()
+                .describe('true = web handoffs stay in OpenCX and never reach Zendesk'),
+            skip_ticket_creation_for_web: z
+                .boolean()
+                .optional()
+                .describe('true = no Zendesk ticket for web sessions at all'),
+            sync_automated_sender_tickets: z
+                .boolean()
+                .optional()
+                .describe('true = tickets from noreply@-style senders still get a session (the AI never replies)'),
+            create_tickets_for_email_sessions: z
+                .boolean()
+                .optional()
+                .describe('true = every email session opens a ticket up front; false = only on handoff'),
+            ai_reads_private_notes: z
+                .boolean()
+                .optional()
+                .describe('true = internal notes are given to the AI as private context; false also stops earlier notes reaching it'),
+            post_handoff_note: z
+                .boolean()
+                .optional()
+                .describe('true = a handoff posts a "Handoff Summary" internal note on the ticket'),
+            email_recipient_sync_enabled: z
+                .boolean()
+                .optional()
+                .describe('true = agents may edit To/Cc in OpenCX and the edits sync to Zendesk (verifies the connection first)'),
+        },
+        annotations: { title: 'Update Zendesk settings', destructiveHint: true },
+    }, async (input) => {
+        const body = input;
+        return jsonContent((await client.PATCH('/integrations/zendesk/settings', { body })).data);
+    });
+    server.registerTool('list_zendesk_groups', {
+        description: 'List the Zendesk groups synced from the connected account — the valid values for default_agent_group_id.',
+        annotations: { title: 'List Zendesk groups', readOnlyHint: true },
+    }, async () => jsonContent((await client.GET('/integrations/zendesk/groups')).data));
+}
+//# sourceMappingURL=zendesk-integration.js.map

package/dist/tools/zendesk-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zendesk-integration.js","sourceRoot":"","sources":["../../src/tools/zendesk-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAO/C,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAoB;IACrF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,qPAAqP;QACvP,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,IAAI,EAAE;KACnE,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC,IAAI,CAAC,CACnF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,wLAAwL;QAC1L,WAAW,EAAE;YACX,gBAAgB,EAAE,CAAC;iBAChB,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,0EAA0E,CAAC;YACvF,sBAAsB,EAAE,CAAC;iBACtB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,sGAAsG,CAAC;YACnH,6BAA6B,EAAE,CAAC;iBAC7B,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,sEAAsE,CAAC;YACnF,oBAAoB,EAAE,CAAC;iBACpB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACzE,4BAA4B,EAAE,CAAC;iBAC5B,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,6BAA6B,EAAE,CAAC;iBAC7B,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,uFAAuF,CAAC;YACpG,iCAAiC,EAAE,CAAC;iBACjC,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,6EAA6E,CAAC;YAC1F,sBAAsB,EAAE,CAAC;iBACtB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,0GAA0G,CAAC;YACvH,iBAAiB,EAAE,CAAC;iBACjB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,wEAAwE,CAAC;YACrF,4BAA4B,EAAE,CAAC;iBAC5B,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,sGAAsG,CAAC;SACpH;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,eAAe,EAAE,IAAI,EAAE;KACzE,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAe,KAAK,CAAC;QAC/B,OAAO,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,0GAA0G;QAC5G,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,IAAI,EAAE;KAClE,EACD,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAAC,CACjF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencx/mcp",
-  "version": "1.15.75",
+  "version": "1.15.77",
   "private": false,
   "description": "MCP server for OpenCX — manage contacts, sessions, training, and more from Claude Desktop, Cursor, or any MCP client.",
   "type": "module",
@@ -21,6 +21,10 @@
       "types": "./dist/http.d.ts",
       "default": "./dist/http.js"
     },
+    "./integrations": {
+      "types": "./dist/integrations.d.ts",
+      "default": "./dist/integrations.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [