Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/tasks.ts:446-478 (handler)

  The primary handler function for the 'get_task' tool. It validates input using GetTaskSchema, fetches the task via supabaseService.getTask(task_id), logs the operation, handles errors (especially not found), and returns the task details.

  export const getTask = requireAuth(async (args: any) => {
    const { task_id } = GetTaskSchema.parse(args)
    
    logger.info('Getting task', { task_id })
    
    try {
      // Use the direct getTask method instead of searching
      const task = await supabaseService.getTask(task_id)
      
      logger.info('Task retrieved successfully', { task_id, title: task.title })
      
      return {
        task,
        message: `Task "${task.title}" retrieved successfully`
      }
    } catch (error: any) {
      logger.error('Failed to get task', { 
        task_id, 
        error: error.message,
        errorCode: error.code,
        statusCode: error.statusCode,
        fullError: error
      })
      
      // Handle NotFoundError specifically
      if (error.code === 'NOT_FOUND' || error.statusCode === 404) {
        throw new Error(`Task with ID ${task_id} not found`)
      }
      
      // Re-throw other errors
      throw error
    }
  })

• src/tools/tasks.ts:22-24 (schema)

  Zod schema for validating the input parameters of the get_task tool, requiring a UUID task_id.

  const GetTaskSchema = z.object({
    task_id: z.string().uuid()
  })

• src/tools/tasks.ts:1157-1167 (registration)

  Export of taskHandlers object that maps 'get_task' to the getTask handler function, which gets imported and spread into the main allHandlers in index.ts.

  export const taskHandlers = {
    list_tasks: listTasks,
    create_task: createTask,
    get_task: getTask,
    update_task: updateTask,
    add_task_dependency: addTaskDependency,
    get_task_dependencies: getTaskDependencies,
    create_task_workflow: createTaskWorkflow,
    bulk_update_tasks: bulkUpdateTasks,
    get_task_workflow_status: getTaskWorkflowStatus
  }

• src/index.ts:143-155 (registration)

  Central registration in HeliosMCPServer constructor where taskHandlers (including get_task) are spread into allHandlers, making the tool available for MCP calls.

  this.allHandlers = {
    ...projectHandlers,
    ...taskHandlers,
    ...documentHandlers,
    ...conversationHandlers,
    ...contextAggregationHandlers,
    ...workflowAutomationHandlers,
    ...intelligentSearchHandlers,
    ...analyticsInsightsHandlers,
    ...initiativeHandlers,
    ...promptToProjectTools.reduce((acc, tool) => ({ ...acc, [tool.name]: tool.handler }), {}),
    ...debugHandlers,
  }

• src/lib/api-client.ts:422-425 (helper)

  The underlying API client method supabaseService.getTask used by the handler to fetch task data from the backend API.

  async getTask(taskId: string): Promise<Task> {
    const response = await this.request<{ task: Task }>(`/api/mcp/tasks/${taskId}`)
    return response.task
  }