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
`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);
    }
  },
);

src/generated/models/CreateVoicememoMessage.ts:80-89 (schema)

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;
}

src/generated/carbon-voice-api.ts:382-395 (helper)

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,
  );
};

Carbon Voice