Webvizio MCP Server

Instructions

Implementation Reference

• src/server.ts:290-326 (registration)

  Registration of the 'get_task_action_logs' MCP tool, including input schema (uuid: string), description, annotations, and inline handler function that calls the client method and formats the response.

  this.server.registerTool(
    'get_task_action_logs',
    {
      description: 'Fetches the task action logs (Repro steps) which have been added to the task. Use this tool if the task prompt lacks sufficient information for execution. Do not use this tool if the task and its solution methods are entirely clear from the task prompt ', 
      inputSchema: {
        uuid: z.string().describe('The uuid of the task to get the action logs for')
      },
      annotations: {
        title: 'Get Task Action Logs'
      }
    },
    async (args: { uuid: string }) => {
      try {
        const actionLogs = await this.webvizioClient.getTaskActionLogs({ uuid: args.uuid });
        if (!actionLogs) {
          return {
            content: [
              {
                type: 'text' as const,
                text: 'No action logs found'
              }
            ] 
          };
        }
        return {
          content: [
            {
              type: 'text' as const,
              text: `Task action logs:\n\n${actionLogs}`
            }
          ]
        };
      } catch (error) {
        return this.handleError(error, 'get_task_action_logs'); 
      }
    }
  );

• src/webvizio-client.ts:162-174 (helper)

  Supporting method in WebvizioClient that executes the core logic: GET request to `/task/{uuid}/action-logs` API endpoint and returns the prompt data.

  async getTaskActionLogs(request: WebvizioGetTaskRequest): Promise<string> {
    try {
      const response = await this.client.get(`/task/${request.uuid}/action-logs`);
      if (!response.data?.prompt) {
        throw new Error('Failed to get action logs prompt');
      }
  
      return response.data.prompt;
    } catch (error) {
      console.error('[Webvizio API] Error getting action logs prompt:', error);
      throw error;
    }
  }

• src/types.ts:20-22 (schema)

  TypeScript interface defining the input request structure (uuid: string) used by the client getTaskActionLogs method.

  export interface WebvizioGetTaskRequest {
    uuid: string;
  }