@carbonvoice/cv-mcp-server 1.0.11 → 1.0.13

package/dist/generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod.js

@@ -599,13 +599,11 @@ exports.getMessageByIdResponse = zod_1.z.object({
     })).optional()
 });
 /**
- * By default return messages created in last 5 days.
-
-The **maximum** allowed range between dates is **31 days**.
+ * By default return most recent messages. The **maximum** allowed range between dates is **31 days**.
  * @summary List Messages
  */
 exports.listMessagesQueryPageDefault = 1;
-exports.listMessagesQuerySizeDefault = 10;
+exports.listMessagesQuerySizeDefault = 20;
 exports.listMessagesQuerySizeMax = 50;
 exports.listMessagesQuerySortDirectionDefault = "DESC";
 exports.listMessagesQueryParams = zod_1.z.object({
@@ -622,7 +620,7 @@ exports.listMessagesQueryParams = zod_1.z.object({
     "user_ids": zod_1.z.array(zod_1.z.string()).optional().describe('User IDs (optional). List of user IDs to filter messages by. If not provided, all users will be included.')
 });
 exports.listMessagesResponsePageDefault = 1;
-exports.listMessagesResponseSizeDefault = 10;
+exports.listMessagesResponseSizeDefault = 20;
 exports.listMessagesResponseSizeMax = 50;
 exports.listMessagesResponseSortDirectionDefault = "DESC";
 exports.listMessagesResponseResultsItemLanguageDefault = "english";

package/dist/generated/carbon-voice-api.js

@@ -99,11 +99,9 @@ const getCarbonVoiceSimplifiedAPI = () => {
         });
     };
     /**
-   * By default return messages created in last 5 days.
-  
-  The **maximum** allowed range between dates is **31 days**.
-   * @summary List Messages
-   */
+     * By default return most recent messages. The **maximum** allowed range between dates is **31 days**.
+     * @summary List Messages
+     */
     const listMessages = (params) => {
         return (0, axios_instance_1.mutator)({
             url: `/simplified/messages`,

package/dist/interfaces/conversation.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/schemas/conversation.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.catchUpConversationParams = exports.summarizeConversationParams = void 0;
+const zod_1 = require("zod");
+exports.summarizeConversationParams = zod_1.z.object({
+    conversation_id: zod_1.z.string().nonempty(),
+    prompt_id: zod_1.z.string().nonempty(),
+    message_ids: zod_1.z.array(zod_1.z.string()).optional(),
+    language: zod_1.z.string().optional(),
+    start_date: zod_1.z.string().datetime().optional(),
+    end_date: zod_1.z.string().datetime().optional(),
+    limit: zod_1.z.number().optional().default(50),
+});
+exports.catchUpConversationParams = zod_1.z.object({
+    ...exports.summarizeConversationParams.shape,
+    include_only_unread_messages: zod_1.z.boolean().optional().default(true),
+});

package/dist/schemas/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./message"), exports);
+__exportStar(require("./conversation"), exports);

package/dist/server.js

@@ -4,6 +4,7 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const constants_1 = require("./constants");
 const generated_1 = require("./generated");
 const CarbonVoiceSimplifiedAPI_zod_1 = require("./generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod");
+const schemas_1 = require("./schemas");
 const utils_1 = require("./utils");
 // Create server instance
 const server = new mcp_js_1.McpServer({
@@ -20,7 +21,7 @@ const api = (0, generated_1.getCarbonVoiceSimplifiedAPI)();
  *********************/
 // Messages
 server.registerTool('list_messages', {
-    description: 'List Messages. By default returns messages created in last 5 days. The maximum allowed range between dates is 31 days.',
+    description: 'List Messages. By default returns latest 20 messages. The maximum allowed range between dates is 31 days.',
     inputSchema: CarbonVoiceSimplifiedAPI_zod_1.listMessagesQueryParams.shape,
 }, async (params) => {
     try {
@@ -58,7 +59,8 @@ server.registerTool('get_recent_messages', {
     }
 });
 server.registerTool('create_conversation_message', {
-    description: 'Send a message to a conversation. In order to create a Message, you must provide transcript or link attachments.',
+    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,
 }, async (args) => {
     try {
@@ -182,6 +184,59 @@ server.registerTool('get_conversation_users', {
         return (0, utils_1.formatToMCPToolResponse)(error);
     }
 });
+server.registerTool('summarize_conversation', {
+    description: 'Summarize a conversation.',
+    inputSchema: schemas_1.summarizeConversationParams.shape,
+}, async (args) => {
+    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 api.listMessages(args);
+            message_ids = ((_a = messages.results) === null || _a === void 0 ? void 0 : _a.map((message) => message.id)) || [];
+        }
+        const aiResponse = await api.aIResponseControllerCreateResponse({
+            prompt_id: args.prompt_id,
+            message_ids: message_ids,
+            channel_id: args.conversation_id,
+            language: args.language,
+        });
+        return (0, utils_1.formatToMCPToolResponse)(aiResponse);
+    }
+    catch (error) {
+        utils_1.logger.error('Error summarizing conversation:', { error });
+        return (0, utils_1.formatToMCPToolResponse)(error);
+    }
+});
+// TODO: First we need to implement List messages filtered by unread messages
+// server.registerTool(
+//   'catch_up_conversation',
+//   {
+//     description: 'Catch up a conversation.',
+//     inputSchema: catchUpConversationParams.shape,
+//   },
+//   async (args: CatchUpConversationParams): Promise<McpToolResponse> => {
+//     try {
+//       let message_ids: string[] = args.message_ids || [];
+//       // If no message ids are provided, get couple of messages from the conversation
+//       if (!args.message_ids?.length) {
+//         const messages = await api.listMessages(args);
+//         message_ids = messages.results?.map((message) => message.id) || [];
+//       }
+//       const aiResponse = await api.aIResponseControllerCreateResponse({
+//         prompt_id: args.prompt_id,
+//         message_ids: message_ids,
+//         channel_id: args.conversation_id,
+//         language: args.language,
+//       });
+//       return formatToMCPToolResponse(aiResponse);
+//     } catch (error) {
+//       logger.error('Error catching up conversation:', { error });
+//       return formatToMCPToolResponse(error);
+//     }
+//   },
+// );
 // Folders
 server.registerTool('get_workspace_folders_and_message_counts', {
     description: 'Returns, for each workspace, the total number of folders and messages, as well as a breakdown of folders, ' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carbonvoice/cv-mcp-server",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Server implementation for integrating with Carbon Voice's API, providing tools and endpoints for voice messaging, conversations, and workspace management through MCP (Model Context Protocol)",
   "author": "Carbon Voice",
   "license": "ISC",

package/readme.md

@@ -0,0 +1,198 @@
+# Carbon Voice MCP Server
+
+A Model Context Protocol (MCP) server implementation for integrating with Carbon Voice's API, providing AI assistants with comprehensive tools for voice messaging, conversations, and workspace management.
+
+## Features
+
+- **Message Management**: Create, list, and retrieve voice messages, conversation messages, and direct messages
+- **User Operations**: Search and retrieve user information
+- **Conversation Management**: Access and manage conversations and their participants
+- **Folder Operations**: Create, organize, move, and manage folders and their contents
+- **Workspace Administration**: Get workspace information
+- **AI Actions**: Run AI prompts and retrieve AI-generated responses
+- **Attachment Support**: Add link attachments to messages
+
+## Prerequisites
+
+### API Key Required
+
+To use this MCP server, you need a Carbon Voice API key. Please contact the Carbon Voice development team to request your API key:
+
+**📧 Contact**: devsupport@phononx.com
+
+## Configuration
+
+### For Cursor
+
+1. Open Cursor
+2. Go to **Cursor Settings** > **Features** > **Model Context Protocol**
+3. Add a new MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "Carbon-Voice": {
+      "command": "npx",
+      "env": {
+        "CARBON_VOICE_API_KEY": "your_api_key_here"
+      },
+      "args": ["-y", "@carbonvoice/cv-mcp-server"]
+    }
+  }
+}
+```
+
+4. Replace `"your_api_key_here"` with your actual Carbon Voice API key
+5. Save and restart Cursor
+
+### For Claude Desktop
+
+1. Open your Claude Desktop configuration file:
+
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. Add the Carbon Voice MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "Carbon-Voice": {
+      "command": "npx",
+      "env": {
+        "CARBON_VOICE_API_KEY": "your_api_key_here"
+      },
+      "args": ["-y", "@carbonvoice/cv-mcp-server"]
+    }
+  }
+}
+```
+
+3. Replace `"your_api_key_here"` with your actual Carbon Voice API key
+4. Save the file and restart Claude Desktop
+
+## Available Tools
+
+### Messages
+
+- **`list_messages`** - List messages with date filtering (max 31-day range)
+- **`get_message`** - Retrieve a specific message by ID
+- **`get_recent_messages`** - Get the 10 most recent messages with full context
+- **`create_conversation_message`** - Send a message to a conversation
+- **`create_direct_message`** - Send direct messages to users or groups
+- **`create_voicememo_message`** - Create voice memo messages
+- **`add_attachments_to_message`** - Add link attachments to existing messages
+
+### Users
+
+- **`get_user`** - Retrieve user information by ID
+- **`search_user`** - Find a user by phone number or email
+- **`search_users`** - Search multiple users by various identifiers
+
+### Conversations
+
+- **`list_conversations`** - Get all conversations from the last 6 months
+- **`get_conversation`** - Retrieve conversation details by ID
+- **`get_conversation_users`** - Get all users in a conversation
+
+### Folders
+
+- **`get_workspace_folders_and_message_counts`** - Get folder and message statistics
+- **`get_root_folders`** - List root folders for a workspace
+- **`create_folder`** - Create new folders
+- **`get_folder`** - Retrieve folder information
+- **`get_folder_with_messages`** - Get folder with its messages
+- **`update_folder_name`** - Rename folders
+- **`delete_folder`** - Delete folders (⚠️ destructive operation)
+- **`move_folder`** - Move folders between locations
+- **`move_message_to_folder`** - Organize messages into folders
+
+### Workspace
+
+- **`get_workspaces_basic_info`** - Get basic workspace information
+
+### AI Actions
+
+- **`list_ai_actions`** - List available AI prompts/actions
+- **`run_ai_action`** - Execute AI actions on messages
+- **`run_ai_action_for_shared_link`** - Run AI actions on shared content
+- **`get_ai_action_responses`** - Retrieve AI-generated responses
+
+## Usage Examples
+
+### Getting Started
+
+After configuration, you can interact with Carbon Voice through your AI assistant. Here are some example requests:
+
+```
+"Show me my recent messages"
+"Create a voice memo about today's meeting"
+"Search for user john@example.com"
+"Show me my workspace information"
+"List my conversations from this week"
+```
+
+### Working with Folders
+
+```
+"Create a folder called 'Project Updates'"
+"Move message ID 12345 to the Project Updates folder"
+"Show me all messages in the Marketing folder"
+```
+
+### AI Actions
+
+```
+"Run a summary AI action on message ID 67890"
+"List all available AI prompts"
+"Get AI responses for conversation ID 123"
+```
+
+## Error Handling
+
+The server includes comprehensive error handling and logging. Errors are returned in a structured format that includes:
+
+- Error messages
+- HTTP status codes
+- Request context
+- Debugging information
+
+## Development
+
+### Building from Source
+
+```bash
+npm run build
+```
+
+### Running in Development Mode
+
+```bash
+npm run auto:build  # Watch mode with auto-rebuild
+```
+
+### Linting
+
+```bash
+npm run lint:fix
+```
+
+### Testing with MCP Inspector
+
+```bash
+npm run mcp:inspector
+```
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/PhononX/cv-mcp-server/issues)
+- **API Key Requests**: devsupport@phononx.com
+- **Website**: [https://getcarbon.app](https://getcarbon.app)
+
+## License
+
+ISC License - See LICENSE file for details.
+
+---
+
+**Note**: This MCP server requires a valid Carbon Voice API key to function. Please ensure you have obtained your API key from the Carbon Voice team before attempting to use the server.