create_voicememo_message
Generate audio messages from text transcripts or attach links to voice memos within Carbon Voice conversations.
Instructions
Create a VoiceMemo Message. In order to create a VoiceMemo Message, you must provide a transcript or link attachments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| transcript | No | The Message transcript will be used to generate audio using text-to-speech | |
| links | No | Array of links to be attached to the message | |
| folder_id | No | Folder ID (not allowed when workspace_id specified is different from the folder_id) | |
| workspace_id | No | Workspace ID (not allowed when folder_id specified is different from the folder_id) |
Implementation Reference
- src/server.ts:243-270 (registration)MCP tool registration for 'create_voicememo_message' including inline handler function that proxies the request to the Carbon Voice Simplified API with authentication.
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: createVoiceMemoMessageBody.shape, annotations: { readOnlyHint: false, destructiveHint: false, }, }, async ( args: CreateVoicememoMessage, { authInfo }, ): Promise<McpToolResponse> => { try { return formatToMCPToolResponse( await simplifiedApi.createVoiceMemoMessage( args, setCarbonVoiceAuthHeader(authInfo?.token), ), ); } catch (error) { logger.error('Error creating voicememo message:', { args, error }); return formatToMCPToolResponse(error); } }, ); - Type definition for the input arguments to the create_voicememo_message tool.
export interface CreateVoicememoMessage { /** The Message transcript will be used to generate audio using text-to-speech */ transcript?: string; /** Array of links to be attached to the message */ links?: string[]; /** Folder ID (not allowed when workspace_id specified is different from the folder_id) */ folder_id?: string; /** Workspace ID (not allowed when folder_id specified is different from the folder_id) */ workspace_id?: string; } - Generated API client helper that sends POST request to Carbon Voice API endpoint `/simplified/messages/voicememo` to create the voicememo message.
const createVoiceMemoMessage = ( createVoicememoMessage: CreateVoicememoMessage, options?: SecondParameter<typeof mutator>, ) => { return mutator<GetMessageResponse>( { url: `/simplified/messages/voicememo`, method: 'POST', headers: { 'Content-Type': 'application/json' }, data: createVoicememoMessage, }, options, ); };