HackerNews MCP Server

Search HackerNews for stories, comments, and other content by keyword.

Supports:

• Keyword search across titles, text, and authors

• Tag filtering (story, comment, poll, show_hn, ask_hn, front_page, author_USERNAME)

• Numeric filters for points, comments, and dates

• Pagination with customizable results per page

• Advanced filtering with OR logic and multiple conditions

Basic Examples:

• Search for AI stories: { "query": "AI", "tags": ["story"] }

• Find popular posts: { "query": "Python", "numericFilters": ["points>=100"] }

• Filter by author: { "query": "startup", "tags": ["author_pg"] }

• Date range: { "query": "startup", "numericFilters": ["created_at_i>1640000000"] }

Advanced Filtering Examples:

• High engagement posts: { "query": "programming", "numericFilters": ["points>=100", "num_comments>=50"] }

• OR logic for tags: { "query": "web", "tags": ["(story,poll)"] } - returns stories OR polls

• Author with filters: { "query": "", "tags": ["author_pg", "story"], "numericFilters": ["points>=50"] }

• Multiple conditions: { "query": "AI", "tags": ["story"], "numericFilters": ["points>=200", "num_comments>=100"] }

Numeric Filter Operators: < (less than), <= (less than or equal), = (equal), >= (greater than or equal), > (greater than) Numeric Filter Fields: points, num_comments, created_at_i (Unix timestamp)

Tag Syntax:

• Single tag: ["story"] - only stories

• Multiple tags (AND): ["story", "show_hn"] - stories that are also show_hn

• OR logic: ["(story,poll)"] - stories OR polls

• Author filter: ["author_USERNAME"] - posts by specific author

Returns paginated results with hits, total count, and page information.