Carbon Voice

Instructions

Implementation Reference

• src/server.ts:437-460 (registration)

  Registration of the MCP tool 'get_conversation', including description, input schema, and the handler function that executes the logic by calling the simplified Carbon Voice API to fetch the conversation by ID.

  server.registerTool(
    'get_conversation',
    {
      description: 'Get a conversation by its ID.',
      inputSchema: getConversationByIdParams.shape,
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
      },
    },
    async (args: GetByIdParams, { authInfo }): Promise<McpToolResponse> => {
      try {
        return formatToMCPToolResponse(
          await simplifiedApi.getConversationById(
            args.id,
            setCarbonVoiceAuthHeader(authInfo?.token),
          ),
        );
      } catch (error) {
        logger.error('Error getting conversation by id:', { error });
        return formatToMCPToolResponse(error);
      }
    },
  );

• src/server.ts:447-459 (handler)

  The handler function for the 'get_conversation' tool, which takes conversation ID, authenticates, calls the API, formats response or error.

  async (args: GetByIdParams, { authInfo }): Promise<McpToolResponse> => {
    try {
      return formatToMCPToolResponse(
        await simplifiedApi.getConversationById(
          args.id,
          setCarbonVoiceAuthHeader(authInfo?.token),
        ),
      );
    } catch (error) {
      logger.error('Error getting conversation by id:', { error });
      return formatToMCPToolResponse(error);
    }
  },

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

  Zod schema definition for the input parameters of getConversationById, used as inputSchema: getConversationByIdParams.shape in the tool registration. Requires a conversation 'id' string.

  export const getConversationByIdParams = zod.object({
    "id": zod.string()
  })

• src/generated/carbon-voice-api.ts:455-463 (helper)

  Helper function getConversationById from the generated Carbon Voice Simplified API wrapper, which performs the actual HTTP GET request to retrieve conversation details by ID.

  const getConversationById = (
    id: string,
    options?: SecondParameter<typeof mutator>,
  ) => {
    return mutator<Conversation>(
      { url: `/simplified/conversations/${id}`, method: 'GET' },
      options,
    );
  };