Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/initiatives.ts:400-408 (handler)

  The core handler function that executes the get_initiative_insights tool logic. It validates the initiative_id argument, logs the operation, calls the API service to fetch insights, and returns the result.
  export const getInitiativeInsights = requireAuth(async (args: any) => { const { initiative_id } = GetInitiativeSchema.parse(args) logger.info('Getting initiative insights', { initiative_id }) const insights = await supabaseService.getInitiativeInsights(initiative_id) return { insights } })
• src/tools/initiatives.ts:384-398 (schema)

  The MCPTool metadata definition for get_initiative_insights, including the name, description, and JSON inputSchema used for tool listing and validation in the MCP server.
  export const getInitiativeInsightsTool: MCPTool = { name: 'get_initiative_insights', description: 'Get AI-powered insights and recommendations for an initiative', inputSchema: { type: 'object', properties: { initiative_id: { type: 'string', format: 'uuid', description: 'The unique identifier of the initiative' } }, required: ['initiative_id'] } }
• src/tools/initiatives.ts:630-642 (registration)

  Local registration export mapping tool name 'get_initiative_insights' to its handler function. This object is imported into the main server 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 registry where initiativeHandlers is spread into allHandlers. This registry is used by the CallToolRequestHandler to execute tools by name.
  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:548-551 (helper)

  Supporting API client method that makes the actual HTTP request to the backend /insights endpoint for a given initiative. Called by the tool handler.
  async getInitiativeInsights(initiativeId: string): Promise<any> { const response = await this.request<{ insights: any }>(`/api/mcp/initiatives/${initiativeId}/insights`) return response.insights }