Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/projects.ts:326-354 (handler)

  The main handler function for the archive_project tool. Parses arguments using ArchiveProjectSchema, logs the action, updates the project status to 'archived' or 'active', and if archiving, marks all associated tasks as 'done'.
  export const archiveProject = requireAuth(async (args: any) => { const { project_id, archive, reason } = ArchiveProjectSchema.parse(args) logger.info(`${archive ? 'Archiving' : 'Unarchiving'} project`, { project_id, reason }) const updates: any = { status: archive ? 'archived' : 'active', updated_at: new Date().toISOString() } // metadata field doesn't exist in the database schema const result = await supabaseService.updateProject(project_id, updates) if (archive) { // Mark all associated tasks as done when archiving project await supabaseService.updateTasksByProject(project_id, { status: 'done', updated_at: new Date().toISOString() }) } return { success: true, action: archive ? 'archived' : 'unarchived', project: result, affected_tasks: archive ? 'All project tasks archived' : 'Tasks remain as-is' } })
• src/tools/projects.ts:320-324 (schema)

  Zod schema for validating input arguments to the archiveProject handler: project_id (required string), archive (boolean, default true), reason (optional string).
  const ArchiveProjectSchema = z.object({ project_id: z.string().min(1), archive: z.boolean().default(true), reason: z.string().optional() })
• src/tools/projects.ts:296-318 (registration)

  MCPTool registration for archive_project, including name, description, and inputSchema definition matching the zod schema.
  export const archiveProjectTool: MCPTool = { name: 'archive_project', description: 'Archive or unarchive a project', inputSchema: { type: 'object', properties: { project_id: { type: 'string', description: 'ID of the project to archive/unarchive' }, archive: { type: 'boolean', default: true, description: 'True to archive, false to unarchive' }, reason: { type: 'string', description: 'Reason for archiving/unarchiving' } }, required: ['project_id'] } }
• src/tools/projects.ts:778-788 (registration)

  Registration of the archiveProject handler function in the projectHandlers export object, mapping 'archive_project' to the handler.
  export const projectHandlers = { list_projects: listProjects, get_project: getProject, create_project: createProject, update_project: updateProject, get_project_context: getProjectContext, archive_project: archiveProject, duplicate_project: duplicateProject, get_project_timeline: getProjectTimeline, bulk_update_projects: bulkUpdateProjects }
• src/tools/projects.ts:766-776 (registration)

  Inclusion of archiveProjectTool in the projectTools export object.
  export const projectTools = { listProjectsTool, getProjectTool, createProjectTool, updateProjectTool, getProjectContextTool, archiveProjectTool, duplicateProjectTool, getProjectTimelineTool, bulkUpdateProjectsTool }