Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/initiatives.ts:517-523 (handler)

  The primary handler function for the 'get_workspace_context' tool. It requires authentication, logs the request, fetches the workspace context using supabaseService (API client), and returns the context wrapped in an object.
  export const getWorkspaceContext = requireAuth(async (args: any) => { logger.info('Getting workspace context') const context = await supabaseService.getWorkspaceContext() return { context } })
• src/tools/initiatives.ts:508-515 (schema)

  The tool schema definition including the exact name 'get_workspace_context', description, and input schema (empty object since no parameters are required). This is used in tool listing.
  export const getWorkspaceContextTool: MCPTool = { name: 'get_workspace_context', description: 'Get complete workspace hierarchy and insights', inputSchema: { type: 'object', properties: {} } }
• src/tools/initiatives.ts:630-642 (registration)

  Local registration mapping the tool name 'get_workspace_context' to its handler function getWorkspaceContext. This object is imported and spread into the central handlers registry.
  export const initiativeHandlers = { list_initiatives: listInitiatives, get_initiative: getInitiative, create_initiative: createInitiative, update_initiative: updateInitiative, get_initiative_context: getInitiativeContext, get_initiative_insights: getInitiativeInsights, search_workspace: searchWorkspace, get_enhanced_project_context: getEnhancedProjectContext, get_workspace_context: getWorkspaceContext, associate_document_with_initiative: associateDocumentWithInitiative, disassociate_document_from_initiative: disassociateDocumentFromInitiative }
• src/index.ts:143-155 (registration)

  Central MCP server registration where initiativeHandlers (including get_workspace_context) is spread into the master allHandlers object used by the MCP Server to dispatch tool 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:598-601 (helper)

  Supporting API client method (supabaseService.getWorkspaceContext) that makes the actual HTTP request to the Helios API endpoint '/api/mcp/workspace/context' to retrieve the workspace context data.
  async getWorkspaceContext(): Promise<any> { const response = await this.request<{ context: any }>('/api/mcp/workspace/context') return response.context }