Carbon Voice

Instructions

Implementation Reference

• src/server.ts:126-151 (registration)

  Registration of the 'get_message' MCP tool, including description, input schema (merged zod schemas), annotations, and the inline handler function that delegates to simplifiedApi.getMessageById with authentication.

  server.registerTool(
    'get_message',
    {
      description: 'Get a message by its ID.',
      inputSchema: getMessageByIdParams.merge(getMessageByIdQueryParams).shape,
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
      },
    },
    async (args: GetMessageInput, { authInfo }): Promise<McpToolResponse> => {
      try {
        const { id, ...queryParams } = args;
        return formatToMCPToolResponse(
          await simplifiedApi.getMessageById(
            id,
            queryParams,
            setCarbonVoiceAuthHeader(authInfo?.token),
          ),
        );
      } catch (error) {
        logger.error('Error getting message by id:', { args, error });
        return formatToMCPToolResponse(error);
      }
    },
  );

• src/generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod.ts:539-547 (schema)

  Zod schemas defining the input parameters for getMessageById: path param 'id' and optional query params 'language' and 'fields'. These are merged for the tool's inputSchema.

  export const getMessageByIdParams = zod.object({
    "id": zod.string()
  })
  
  export const getMessageByIdQueryParams = zod.object({
    "language": zod.string().optional().describe('Language (optional) - Original language will be used if not provided or not found.'),
    "fields": zod.string().optional().describe('Fields (optional) - Additional fields to include in the response. Possible values: conversation, creator, labels.')
  })

• src/generated/carbon-voice-api.ts:294-303 (handler)

  The underlying API handler getMessageById that makes the HTTP GET request to retrieve the message by ID using the mutator function, called by the MCP tool handler.

  const getMessageById = (
    id: string,
    params?: GetMessageByIdParams,
    options?: SecondParameter<typeof mutator>,
  ) => {
    return mutator<GetMessageResponse>(
      { url: `/simplified/messages/${id}`, method: 'GET', params },
      options,
    );
  };

• src/generated/models/GetMessageResponse.ts:84-90 (schema)

  TypeScript interface for the GetMessageResponse, defining the structure of the tool's output including message, optional creator, conversation, and labels.

  export interface GetMessageResponse {
    message: Message;
    creator?: User;
    conversation?: Conversation;
    labels?: Label[];
  }