Carbon Voice

Instructions

Implementation Reference

• src/server.ts:411-435 (registration)

  Registration of the MCP tool 'list_conversations' including its description, empty input schema (z.object({}).shape), annotations, and inline handler function that calls simplifiedApi.getAllConversations with authentication.
  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: z.object({}).shape, annotations: { readOnlyHint: true, destructiveHint: false, }, }, async (args: unknown, { authInfo }): Promise<McpToolResponse> => { try { return formatToMCPToolResponse( await simplifiedApi.getAllConversations( setCarbonVoiceAuthHeader(authInfo?.token), ), ); } catch (error) { logger.error('Error listing conversations:', { error }); return formatToMCPToolResponse(error); } }, );
• src/server.ts:423-433 (handler)

  The handler function for the 'list_conversations' tool. It takes no input args, uses authInfo to set headers, calls the generated simplifiedApi.getAllConversations(), formats the response, and handles errors.
  async (args: unknown, { authInfo }): Promise<McpToolResponse> => { try { return formatToMCPToolResponse( await simplifiedApi.getAllConversations( setCarbonVoiceAuthHeader(authInfo?.token), ), ); } catch (error) { logger.error('Error listing conversations:', { error }); return formatToMCPToolResponse(error); }
• src/server.ts:417-417 (schema)

  Inline Zod input schema for the tool, which is empty object since no parameters are required.
  inputSchema: z.object({}).shape,
• src/generated/carbon-voice-api.ts:442-450 (helper)

  Generated helper function getAllConversations in the simplified API client that performs a GET request to /simplified/conversations/all to retrieve conversations.
  /** * @summary Get all user conversations (Only _id and name available */ const getAllConversations = (options?: SecondParameter<typeof mutator>) => { return mutator<AllConversationsResponse>( { url: `/simplified/conversations/all`, method: 'GET' }, options, ); };