RAT MCP Server

Instructions

Implementation Reference

• src/index.ts:327-357 (handler)

  Handler for 'check_response_status' tool: validates input, retrieves task status from activeTasks Map, and returns formatted status JSON.

  } else if (request.params.name === 'check_response_status') {
    if (!isValidCheckResponseStatusArgs(request.params.arguments)) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Invalid check_response_status arguments'
      );
    }
  
    const taskId = request.params.arguments.taskId;
    const task = this.activeTasks.get(taskId);
  
    if (!task) {
      throw new McpError(
        ErrorCode.InvalidRequest,
        `No task found with ID: ${taskId}`
      );
    }
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            status: task.status,
            reasoning: task.showReasoning ? task.reasoning : undefined,
            response: task.status === 'complete' ? task.response : undefined,
            error: task.error
          })
        }
      ]
    };

• src/index.ts:271-284 (registration)

  Registration of the 'check_response_status' tool in the ListTools handler, including name, description, and input schema.

  {
    name: 'check_response_status',
    description: 'Check the status of a response generation task',
    inputSchema: {
      type: 'object',
      properties: {
        taskId: {
          type: 'string',
          description: 'The task ID returned by generate_response'
        }
      },
      required: ['taskId']
    }
  }

• src/index.ts:52-54 (schema)

  TypeScript interface defining the expected input shape for check_response_status arguments.

  interface CheckResponseStatusArgs {
    taskId: string;
  }

• src/index.ts:66-69 (schema)

  Runtime validator function for CheckResponseStatusArgs type.

  const isValidCheckResponseStatusArgs = (args: any): args is CheckResponseStatusArgs =>
    typeof args === 'object' &&
    args !== null &&
    typeof args.taskId === 'string';

• src/index.ts:56-64 (helper)

  Interface defining the structure of task status objects stored in activeTasks Map, used by the handler.

  interface TaskStatus {
    status: 'pending' | 'reasoning' | 'responding' | 'complete' | 'error';
    prompt: string;
    showReasoning?: boolean;
    reasoning?: string;
    response?: string;
    error?: string;
    timestamp: number;
  }