/**
* get_front_page MCP Tool
*/
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import { HNError } from '../lib/errors.js';
import type { HNClient } from '../lib/hn-client.js';
import { createChildLogger } from '../lib/logger.js';
export function registerGetFrontPage(server: McpServer, hnClient: HNClient): void {
server.registerTool(
'get_front_page',
{
title: 'Get Front Page Stories',
description: 'Retrieve stories currently on the Hacker News front page. Returns up to 30 stories.',
inputSchema: {
page: z.number().int().min(0).optional().default(0).describe('Page number (0-indexed)'),
hitsPerPage: z.number().int().min(1).max(100).optional().default(30).describe('Results per page'),
},
outputSchema: { hits: z.array(z.any()), nbHits: z.number(), nbPages: z.number() },
},
async ({ page = 0, hitsPerPage = 30 }) => {
const correlationId = crypto.randomUUID();
const toolLogger = createChildLogger({ correlationId, tool: 'get_front_page' });
try {
toolLogger.info({ page, hitsPerPage }, 'Getting front page');
const result = await hnClient.search({ query: '', tags: 'front_page', page, hitsPerPage });
toolLogger.info({ nbHits: result.nbHits }, 'Retrieved front page');
return {
content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
structuredContent: result as unknown as Record<string, unknown>,
};
} catch (error) {
toolLogger.error({ error }, 'Failed to get front page');
if (error instanceof HNError) {
const errorContent = { error: error.message };
return {
content: [{ type: 'text', text: JSON.stringify(errorContent) }],
isError: true,
};
}
throw error;
}
}
);
}
