Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/documents.ts:600-611 (handler)

  The main execution handler for the 'get_document' tool. Parses input with GetDocumentSchema, fetches the document using supabaseService.getDocument, and returns the document with a success message.

  export const getDocument = requireAuth(async (args: any) => {
    const { document_id } = GetDocumentSchema.parse(args)
    
    logger.info('Getting document', { document_id })
    
    const document = await supabaseService.getDocument(document_id)
    
    return {
      document,
      message: `Document "${document.title}" retrieved successfully`
    }
  })

• src/tools/documents.ts:584-598 (schema)

  The MCPTool definition providing the tool name, description, and input schema for 'get_document'.

  export const getDocumentTool: MCPTool = {
    name: 'get_document',
    description: 'Get a document by ID with basic information',
    inputSchema: {
      type: 'object',
      properties: {
        document_id: {
          type: 'string',
          format: 'uuid',
          description: 'The unique identifier of the document'
        }
      },
      required: ['document_id']
    }
  }

• src/tools/documents.ts:25-27 (schema)

  Zod validation schema used by the get_document handler to parse and validate the document_id input.

  const GetDocumentSchema = z.object({
    document_id: z.string().uuid()
  })

• src/tools/documents.ts:1346-1358 (registration)

  Maps the 'get_document' name to its handler function getDocument, which is imported and spread into the main allHandlers in src/index.ts.

  export const documentHandlers = {
    list_documents: listDocuments,
    create_document: createDocument,
    get_document: getDocument,
    update_document: updateDocument,
    search_documents: searchDocuments,
    get_document_context: getDocumentContext,
    add_document_collaborator: addDocumentCollaborator,
    analyze_document_content: analyzeDocumentContent,
    get_document_collaboration: getDocumentCollaboration,
    generate_document_template: generateDocumentTemplate,
    bulk_document_operations: bulkDocumentOperations
  }

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

  The main server combines all module handlers including documentHandlers (containing get_document) into the central allHandlers object used for tool execution.

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