get_ai_action_responses

Retrieve AI-generated responses by filtering for specific prompts, messages, or conversations to review previous interactions and outputs.

Instructions

Retrieve previously generated AI Action (Prompt) responses by filtering for a specific prompt, message, or conversation ID. Combine filters to narrow results and view all AI-generated responses related to a particular prompt, message, or conversation.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`message_id`	No
`prompt_id`	No
`channel_id`	No
`limit`	No
`direction`	No
`date`	No

Implementation Reference

src/server.ts:929-944 (handler)

The inline handler function that executes the 'get_ai_action_responses' tool logic by calling the Carbon Voice simplified API to retrieve AI action responses based on provided parameters.

async (
  args: AIResponseControllerGetAllResponsesParams,
  { authInfo },
): Promise<McpToolResponse> => {
  try {
    return formatToMCPToolResponse(
      await simplifiedApi.aIResponseControllerGetAllResponses(
        args,
        setCarbonVoiceAuthHeader(authInfo?.token),
      ),
    );
  } catch (error) {
    logger.error('Error getting ai action responses:', { error });
    return formatToMCPToolResponse(error);
  }
},

src/generated/models/AIResponseControllerGetAllResponsesParams.ts:81-88 (schema)

TypeScript type definition for the input parameters of the 'get_ai_action_responses' tool, used for validation and typing.

export type AIResponseControllerGetAllResponsesParams = {
  message_id?: string;
  prompt_id?: string;
  channel_id?: string;
  limit?: number;
  direction?: AIResponseControllerGetAllResponsesDirection;
  date?: string;
};

src/server.ts:917-928 (registration)

MCP server registration of the 'get_ai_action_responses' tool, including description, input schema reference, and annotations.

server.registerTool(
  'get_ai_action_responses',
  {
    description:
      'Retrieve previously generated AI Action (Prompt) responses by filtering for a specific prompt, message, or conversation ID. ' +
      'Combine filters to narrow results and view all AI-generated responses related to a particular prompt, message, or conversation.',
    inputSchema: aIResponseControllerGetAllResponsesQueryParams.shape,
    annotations: {
      readOnlyHint: true,
      destructiveHint: false,
    },
  },

Carbon Voice