@carbonvoice/cv-mcp-server 1.1.3 → 2.1.0

package/dist/auth/auth.service.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCarbonVoiceAuthHeader = exports.createOAuthTokenVerifier = void 0;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const errors_js_1 = require("@modelcontextprotocol/sdk/server/auth/errors.js");
+const config_1 = require("../config");
+const utils_1 = require("../utils");
+const createOAuthTokenVerifier = () => ({
+    async verifyAccessToken(token) {
+        var _a;
+        if (!token) {
+            throw new errors_js_1.InvalidTokenError('No token provided');
+        }
+        try {
+            const decoded = jsonwebtoken_1.default.decode(token);
+            // Basic validation
+            if (!decoded) {
+                throw new errors_js_1.InvalidTokenError('Invalid token format');
+            }
+            if (!decoded.sub || !decoded.client_id) {
+                throw new errors_js_1.InvalidTokenError('Token missing required claims');
+            }
+            // Check expiration
+            // We don't need, since it's validate in requireBearerAuth middleware
+            // if (decoded.exp && decoded.exp < Date.now() / 1000) {
+            //   throw new InvalidTokenError('Token expired');
+            // }
+            return {
+                token,
+                clientId: decoded.client_id,
+                scopes: ((_a = decoded.scope) === null || _a === void 0 ? void 0 : _a.split(' ')) || [],
+                expiresAt: decoded.exp,
+                extra: {
+                    user: {
+                        id: decoded.sub,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            utils_1.logger.error('Error verifying access token', {
+                error: {
+                    error_message: error.message,
+                    stack: error.stack,
+                },
+                token: (0, utils_1.removeLastChars)(token),
+            });
+            if (error instanceof errors_js_1.InvalidTokenError) {
+                throw error;
+            }
+            throw new errors_js_1.InvalidTokenError('Token verification failed');
+        }
+    },
+});
+exports.createOAuthTokenVerifier = createOAuthTokenVerifier;
+const setCarbonVoiceAuthHeader = (token) => {
+    if (!token && !config_1.env.CARBON_VOICE_API_KEY) {
+        throw new utils_1.UnauthorizedException('No Bearer token or API key provided');
+    }
+    // http-transport
+    if (token) {
+        return {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        };
+    }
+    // Default to API key for Stdio transport
+    return {
+        headers: {
+            'x-api-key': `${config_1.env.CARBON_VOICE_API_KEY}`,
+        },
+    };
+};
+exports.setCarbonVoiceAuthHeader = setCarbonVoiceAuthHeader;
+//# sourceMappingURL=auth.service.js.map

package/dist/auth/auth.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.js","sourceRoot":"","sources":["../../src/auth/auth.service.ts"],"names":[],"mappings":";;;;;;AAAA,gEAA+B;AAE/B,+EAAoF;AAMpF,sCAAgC;AAChC,oCAA0E;AAEnE,MAAM,wBAAwB,GAAG,GAAuB,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,iBAAiB,CAAC,KAAa;;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,6BAAiB,CAAC,mBAAmB,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,sBAAG,CAAC,MAAM,CAAC,KAAK,CAA+B,CAAC;YAEhE,mBAAmB;YACnB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,6BAAiB,CAAC,sBAAsB,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,6BAAiB,CAAC,+BAA+B,CAAC,CAAC;YAC/D,CAAC;YAED,mBAAmB;YACnB,qEAAqE;YACrE,wDAAwD;YACxD,kDAAkD;YAClD,IAAI;YAEJ,OAAO;gBACL,KAAK;gBACL,QAAQ,EAAE,OAAO,CAAC,SAAS;gBAC3B,MAAM,EAAE,CAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,KAAK,CAAC,GAAG,CAAC,KAAI,EAAE;gBACvC,SAAS,EAAE,OAAO,CAAC,GAAG;gBACtB,KAAK,EAAE;oBACL,IAAI,EAAE;wBACJ,EAAE,EAAE,OAAO,CAAC,GAAG;qBAChB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,cAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAC3C,KAAK,EAAE;oBACL,aAAa,EAAG,KAAe,CAAC,OAAO;oBACvC,KAAK,EAAG,KAAe,CAAC,KAAK;iBAC9B;gBACD,KAAK,EAAE,IAAA,uBAAe,EAAC,KAAK,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,KAAK,YAAY,6BAAiB,EAAE,CAAC;gBACvC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,6BAAiB,CAAC,2BAA2B,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAnDU,QAAA,wBAAwB,4BAmDlC;AAEI,MAAM,wBAAwB,GAAG,CACtC,KAAc,EACuB,EAAE;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAG,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,6BAAqB,CAAC,qCAAqC,CAAC,CAAC;IACzE,CAAC;IAED,iBAAiB;IACjB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;SACF,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,OAAO;QACL,OAAO,EAAE;YACP,WAAW,EAAE,GAAG,YAAG,CAAC,oBAAoB,EAAE;SAC3C;KACF,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,wBAAwB,4BAsBnC"}

package/dist/auth/index.js

@@ -1,3 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth.service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/auth/interfaces/auth.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auth.types.js.map

package/dist/auth/interfaces/auth.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.js","sourceRoot":"","sources":["../../../src/auth/interfaces/auth.types.ts"],"names":[],"mappings":""}

package/dist/auth/interfaces/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./user.interface"), exports);
+__exportStar(require("./auth.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/auth/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,+CAA6B"}

package/dist/cv-api.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCarbonVoiceApiWorking = exports.getCarbonVoiceAPI = void 0;
+exports.getCarbonVoiceApiStatus = exports.getCarbonVoiceAPI = void 0;
+const config_1 = require("./config");
 const utils_1 = require("./utils");
 const axios_instance_1 = require("./utils/axios-instance");
 const getCarbonVoiceAPI = () => {
@@ -11,15 +12,22 @@ const getCarbonVoiceAPI = () => {
     };
 };
 exports.getCarbonVoiceAPI = getCarbonVoiceAPI;
-const isCarbonVoiceApiWorking = async () => {
+const getCarbonVoiceApiStatus = async () => {
     try {
         const response = await (0, axios_instance_1.mutator)({ url: `/health`, method: 'GET' });
-        return response.status === 'ok';
+        return {
+            isHealthy: response.status === 'ok',
+            apiUrl: config_1.env.CARBON_VOICE_BASE_URL,
+        };
     }
     catch (error) {
         utils_1.logger.error('Error getting backend status:', error);
-        return false;
+        return {
+            isHealthy: false,
+            apiUrl: config_1.env.CARBON_VOICE_BASE_URL,
+            error: error instanceof Error ? error.message : 'UNKNOWN_ERROR',
+        };
     }
 };
-exports.isCarbonVoiceApiWorking = isCarbonVoiceApiWorking;
+exports.getCarbonVoiceApiStatus = getCarbonVoiceApiStatus;
 //# sourceMappingURL=cv-api.js.map

package/dist/cv-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"cv-api.js","sourceRoot":"","sources":["../src/cv-api.ts"],"names":[],"mappings":";;;AAEA,mCAAiC;AACjC,2DAAiD;AAE1C,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,OAA4B,EAAoB,EAAE;YAClE,OAAO,IAAA,wBAAO,EAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B;AAEK,MAAM,uBAAuB,GAAG,KAAK,IAAsB,EAAE;IAClE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAO,EAE3B,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtC,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,uBAAuB,2BAWlC"}
+{"version":3,"file":"cv-api.js","sourceRoot":"","sources":["../src/cv-api.ts"],"names":[],"mappings":";;;AAEA,qCAA+B;AAC/B,mCAAiC;AACjC,2DAAiD;AAE1C,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,OAA4B,EAAoB,EAAE;YAClE,OAAO,IAAA,wBAAO,EAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B;AAEK,MAAM,uBAAuB,GAAG,KAAK,IAIzC,EAAE;IACH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAO,EAE3B,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;YACnC,MAAM,EAAE,YAAG,CAAC,qBAAqB;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,YAAG,CAAC,qBAAqB;YACjC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAtBW,QAAA,uBAAuB,2BAsBlC"}

package/dist/server.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const zod_1 = require("zod");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const auth_middleware_1 = require("./auth/auth-middleware");
+const auth_1 = require("./auth");
 const constants_1 = require("./constants");
 const cv_api_1 = require("./cv-api");
 const generated_1 = require("./generated");
@@ -36,10 +36,14 @@ server.registerTool('list_messages', {
         'If you want to get messages from a specific workspace, you can use the "workspace_id" parameter. ' +
         'If you want to get messages for a particular language, you can use the "language" parameter. ',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.listMessagesQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (params, { authInfo }) => {
     try {
         // Fallback to regular API
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.listMessages(params, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.listMessages(params, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error listing messages:', { params, error });
@@ -49,10 +53,14 @@ server.registerTool('list_messages', {
 server.registerTool('get_message', {
     description: 'Get a message by its ID.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getMessageByIdParams.merge(CarbonVoiceSimplifiedAPI_zod_1.getMessageByIdQueryParams).shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
         const { id, ...queryParams } = args;
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getMessageById(id, queryParams, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getMessageById(id, queryParams, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting message by id:', { args, error });
@@ -63,9 +71,13 @@ server.registerTool('get_recent_messages', {
     description: 'Get most recent messages, including their associated Conversation, Creator, and Labels information. ' +
         'Returns a maximum of 10 messages.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getTenRecentMessagesResponseQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getTenRecentMessagesResponse(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getTenRecentMessagesResponse(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting recent messages:', { args, error });
@@ -76,9 +88,13 @@ server.registerTool('create_conversation_message', {
     description: 'Sends a message to an existing conversation or any type with a conversation_id. ' +
         'To reply as a thread, included a message_id for "parent_id". You must provide a transcript or attachment.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.createConversationMessageParams.merge(CarbonVoiceSimplifiedAPI_zod_1.createConversationMessageBody).shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createConversationMessage(args.id, args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createConversationMessage(args.id, args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error creating conversation message:', { args, error });
@@ -89,9 +105,13 @@ server.registerTool('create_direct_message', {
     description: 'Send a Direct Message (DM) to a User or a Group of Users. ' +
         'In order to create a Direct Message, you must provide transcript or link attachments.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.sendDirectMessageBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.sendDirectMessage(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.sendDirectMessage(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error creating direct message:', { args, error });
@@ -101,9 +121,13 @@ server.registerTool('create_direct_message', {
 server.registerTool('create_voicememo_message', {
     description: 'Create a VoiceMemo Message. In order to create a VoiceMemo Message, you must provide a transcript or link attachments.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.createVoiceMemoMessageBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createVoiceMemoMessage(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createVoiceMemoMessage(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error creating voicememo message:', { args, error });
@@ -113,11 +137,15 @@ server.registerTool('create_voicememo_message', {
 server.registerTool('add_attachments_to_message', {
     description: 'Add attachments to a message. In order to add attachments to a message, you must provide a message id and the attachments.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.addLinkAttachmentsToMessageParams.merge(CarbonVoiceSimplifiedAPI_zod_1.addLinkAttachmentsToMessageBody).shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
         return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.addLinkAttachmentsToMessage(args.id, {
             links: args.links,
-        }, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        }, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error adding attachments to message:', { args, error });
@@ -128,9 +156,13 @@ server.registerTool('add_attachments_to_message', {
 server.registerTool('get_user', {
     description: 'Get a User by their ID.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getUserByIdParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getUserById(args.id, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getUserById(args.id, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting user by id:', { args, error });
@@ -141,9 +173,13 @@ server.registerTool('search_user', {
     description: 'Search for a User by their phone number or email address. ' +
         '(In order to search for a User, you must provide a phone number or email address.)',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.searchUserQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.searchUser(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.searchUser(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error searching for user:', { args, error });
@@ -154,21 +190,29 @@ server.registerTool('search_users', {
     description: 'Search multiple Users by their phone numbers, email addresses or ids. ' +
         '(In order to search Users, you must provide phone numbers, email addresses or ids.)',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.searchUsersBody.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.searchUsers(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.searchUsers(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error searching users:', { args, error });
         return (0, utils_1.formatToMCPToolResponse)(error);
     }
 });
-server.registerTool('me', {
+server.registerTool('get_current_user', {
     description: 'Get the current user information. ',
     inputSchema: zod_1.z.object({}).shape, // Needed in order to have access to authInfo
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (params, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await cvApi.getWhoAmI((0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await cvApi.getWhoAmI((0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error searching users:', { params, error });
@@ -180,9 +224,13 @@ server.registerTool('list_conversations', {
     description: 'List all conversations. ' +
         'Returns a simplified view of user conversations that have had messages sent or received within the last 6 months.',
     inputSchema: zod_1.z.object({}).shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllConversations((0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllConversations((0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error listing conversations:', { error });
@@ -192,9 +240,13 @@ server.registerTool('list_conversations', {
 server.registerTool('get_conversation', {
     description: 'Get a conversation by its ID.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getConversationByIdParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getConversationById(args.id, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getConversationById(args.id, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting conversation by id:', { error });
@@ -204,9 +256,13 @@ server.registerTool('get_conversation', {
 server.registerTool('get_conversation_users', {
     description: 'Get users in a conversation.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getConversationByIdParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getConversationUsers(args.id, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getConversationUsers(args.id, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting conversation users:', { error });
@@ -216,13 +272,17 @@ server.registerTool('get_conversation_users', {
 server.registerTool('summarize_conversation', {
     description: 'Summarize a conversation.',
     inputSchema: schemas_1.summarizeConversationParams.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     var _a;
     try {
         let message_ids = args.message_ids || [];
         // If no message ids are provided, get couple of messages from the conversation
         if (!args.message_ids) {
-            const messages = await simplifiedApi.listMessages(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token));
+            const messages = await simplifiedApi.listMessages(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token));
             message_ids = ((_a = messages.results) === null || _a === void 0 ? void 0 : _a.map((message) => message.id)) || [];
         }
         const aiResponse = await simplifiedApi.aIResponseControllerCreateResponse({
@@ -230,7 +290,7 @@ server.registerTool('summarize_conversation', {
             message_ids: message_ids,
             channel_id: args.conversation_id,
             language: args.language,
-        }, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token));
+        }, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token));
         return (0, utils_1.formatToMCPToolResponse)(aiResponse);
     }
     catch (error) {
@@ -290,9 +350,13 @@ server.registerTool('get_root_folders', {
     description: 'Lists all root folders for a given workspace, including their names, IDs, and basic structure, ' +
         'but does not provide aggregate counts.(Required to inform message type:voicememo,prerecorded)',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getAllRootFoldersQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllRootFolders(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllRootFolders(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error listing root folders:', { error });
@@ -302,9 +366,13 @@ server.registerTool('get_root_folders', {
 server.registerTool('create_folder', {
     description: 'Create a new folder.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.createFolderBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createFolder(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createFolder(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error creating folder:', { error });
@@ -314,9 +382,13 @@ server.registerTool('create_folder', {
 server.registerTool('get_folder', {
     description: 'Get a folder by its ID.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getFolderByIdParams.merge(CarbonVoiceSimplifiedAPI_zod_1.getFolderByIdQueryParams).shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getFolderById(args.id, args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getFolderById(args.id, args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting folder by id:', { error });
@@ -326,9 +398,13 @@ server.registerTool('get_folder', {
 server.registerTool('get_folder_with_messages', {
     description: 'Get a folder including its messages by its ID. (Only messages at folder level are returned.)',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.getFolderMessagesParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getFolderMessages(args.id, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getFolderMessages(args.id, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting folder with messages:', { error });
@@ -338,9 +414,13 @@ server.registerTool('get_folder_with_messages', {
 server.registerTool('update_folder_name', {
     description: 'Update a folder name by its ID.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.updateFolderNameParams.merge(CarbonVoiceSimplifiedAPI_zod_1.updateFolderNameBody).shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.updateFolderName(args.id, args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.updateFolderName(args.id, args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error updating folder name:', { error });
@@ -351,9 +431,13 @@ server.registerTool('delete_folder', {
     description: 'Delete a folder by its ID. Deleting a folder will also delete nested folders and all the messages in referenced folders. ' +
         '(This is a destructive action and cannot be undone, so please be careful.)',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.deleteFolderParams.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.deleteFolder(args.id, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.deleteFolder(args.id, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error deleting folder:', { error });
@@ -363,9 +447,13 @@ server.registerTool('delete_folder', {
 server.registerTool('move_folder', {
     description: 'Move a folder by its ID. Move a Folder into another Folder or into a Workspace.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.moveFolderParams.merge(CarbonVoiceSimplifiedAPI_zod_1.moveFolderBody).shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.moveFolder(args.id, args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.moveFolder(args.id, args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error moving folder:', { error });
@@ -376,9 +464,13 @@ server.registerTool('move_message_to_folder', {
     description: 'Move a message to a folder by its ID. Move a Message into another Folder or into a Workspace. ' +
         'Only allowed to move messages of type: voicememo,prerecorded.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.addMessageToFolderOrWorkspaceBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.addMessageToFolderOrWorkspace(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.addMessageToFolderOrWorkspace(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error moving message to folder:', { error });
@@ -389,9 +481,13 @@ server.registerTool('move_message_to_folder', {
 server.registerTool('get_workspaces_basic_info', {
     description: 'Get basic information about a workspace.',
     inputSchema: zod_1.z.object({}).shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (params, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllWorkspacesWithBasicInfo((0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.getAllWorkspacesWithBasicInfo((0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting workspaces basic info:', { error });
@@ -404,9 +500,13 @@ server.registerTool('list_ai_actions', {
         'Filtering by owner type, Possible values: "user", "workspace", "system". ' +
         'Do not use unless the user explicitly requests it.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.aIPromptControllerGetPromptsQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIPromptControllerGetPrompts(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIPromptControllerGetPrompts(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error listing ai actions:', { error });
@@ -416,9 +516,13 @@ server.registerTool('list_ai_actions', {
 server.registerTool('run_ai_action', {
     description: 'Run an AI Action (Prompt) for a message. You can run an AI Action for a message by its ID or a list of message IDs.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.aIResponseControllerCreateResponseBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIResponseControllerCreateResponse(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIResponseControllerCreateResponse(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error running ai action:', { error });
@@ -429,9 +533,13 @@ server.registerTool('run_ai_action_for_shared_link', {
     description: 'Run an AI Action (Prompt) for a shared link. You can run an AI Action for a shared link by its ID or a list of shared link IDs. ' +
         'You can also provide the language of the response.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.createShareLinkAIResponseBody.shape,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createShareLinkAIResponse(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.createShareLinkAIResponse(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error running ai action for shared link:', { error });
@@ -442,9 +550,13 @@ server.registerTool('get_ai_action_responses', {
     description: 'Retrieve previously generated AI Action (Prompt) responses by filtering for a specific prompt, message, or conversation ID. ' +
         'Combine filters to narrow results and view all AI-generated responses related to a particular prompt, message, or conversation.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.aIResponseControllerGetAllResponsesQueryParams.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+    },
 }, async (args, { authInfo }) => {
     try {
-        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIResponseControllerGetAllResponses(args, (0, auth_middleware_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
+        return (0, utils_1.formatToMCPToolResponse)(await simplifiedApi.aIResponseControllerGetAllResponses(args, (0, auth_1.setCarbonVoiceAuthHeader)(authInfo === null || authInfo === void 0 ? void 0 : authInfo.token)));
     }
     catch (error) {
         utils_1.logger.error('Error getting ai action responses:', { error });