HackerNews MCP Server
This Model Context Protocol (MCP) server provides comprehensive access to HackerNews through the Algolia API, enabling AI assistants to search, browse, and analyze content via natural language queries.
Core Capabilities:
• Advanced Search - Find stories, comments, and polls by keyword with complex filtering: tag filtering (story, comment, poll, show_hn, ask_hn, author-specific), numeric operators (<, <=, =, >=, >) for points/comments/dates, AND/OR logic, and pagination (1-1000 results per page)
• Front Page Access - Retrieve currently trending posts ranked by HackerNews' algorithm
• Latest Posts - Monitor newest content in chronological order with optional content type filtering
• Item Details - Fetch complete metadata for any item ID including full nested comment trees, titles, URLs, text, points, authors, and timestamps
• User Profiles - View public profile information including karma scores, bios, account creation dates, and username validation
Key Features: Real-time data access, pagination support across all operations, date range queries using Unix timestamps, and the ability to combine multiple filters simultaneously.
Provides access to HackerNews content through the Algolia HackerNews API, enabling search of posts and comments, retrieval of front page stories, latest posts, item details with nested comment trees, and user profile information
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HackerNews MCP Server show me the top stories on HackerNews right now"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect your AI assistant to HackerNews! This Model Context Protocol server gives Claude, GitHub Copilot, and other AI assistants the ability to search HN, read discussions, and explore user profiles.
✨ Features
🔍 Search Posts - Find stories, comments, and discussions by keyword with advanced filters
📰 Front Page - Access currently trending posts
🆕 Latest Posts - Monitor newest content in real-time
💬 Item Details - Retrieve full posts with nested comment trees
👤 User Profiles - View author information, karma, and bios
Related MCP server: HackerNews MCP Server
🚀 Quick Start
Other Clients
Add the following MCP server configuration to your client's MCP settings:
{
"hn-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "hn-mcp-server"]
}
}📚 How to Use
Once configured, you can ask your AI assistant natural language questions like:
"What are the top stories on HackerNews right now?"
"Search HackerNews for discussions about Rust programming"
"Show me the latest AI-related posts with at least 100 points"
"Get the details and comments for HN item 38456789"
"What's the karma score for user 'pg'?"
The AI will automatically use the appropriate HackerNews tools to answer your questions.
🛠️ Available Tools
search-posts
Search HackerNews by keyword with filters for content type, points, and date range.
Example prompts:
"Search for stories about TypeScript"
"Find posts about AI with more than 200 points"
"Search for comments by author 'dang'"
get-front-page
Get the current HackerNews front page posts.
Example prompts:
"What's trending on HackerNews?"
"Show me the HN front page"
get-latest-posts
Get the most recent posts sorted by date.
Example prompts:
"What are the newest HackerNews stories?"
"Show me recent Ask HN posts"
get-item
Retrieve complete item details with nested comments.
Example prompts:
"Get HN item 38456789"
"Show me the discussion for this story"
get-user
View user profile information.
Example prompts:
"Tell me about HN user 'pg'"
"What's the karma for user 'tptacek'?"
🔧 Requirements
Node.js 18.0.0 or higher
MCP Client - Any application that supports MCP:
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
📖 Documentation
API Reference - Detailed API documentation
Architecture - System design and architecture
📄 License
MIT License - See LICENSE for details
🔗 Resources
npm Package: https://www.npmjs.com/package/hn-mcp-server
GitHub Repository: https://github.com/wei/hn-mcp-server
HackerNews API: https://hn.algolia.com/api
MCP Documentation: https://modelcontextprotocol.io
Report Issues: https://github.com/wei/hn-mcp-server/issues
Available Tools
5 toolsget-front-pageA
Retrieve posts currently on the HackerNews front page.
Returns stories sorted by HackerNews ranking algorithm. The front page typically contains the most popular and trending stories.
Supports:
Pagination to view beyond the first page
Customizable results per page (default: 30)
All posts are tagged with 'front_page'
Examples:
Get first page: { }
Get with custom page size: { "hitsPerPage": 50 }
Get second page: { "page": 1 }
Returns the same structure as search results with hits, pagination info, and metadata.
Inputs: page, hitsPerPage.
get-itemA
Retrieve detailed information about a specific HackerNews item by ID.
Returns complete item details including the full nested comment tree. Use this to:
View a story with all comments
Read a specific comment with its replies
Explore discussion threads in depth
Get complete metadata for any item
Features:
Full nested comment tree (all levels)
Complete item metadata (title, url, text, points, author, etc.)
Works for stories, comments, polls, and poll options
Includes creation time and item type
Examples:
Get story with comments: { "itemId": "38456789" }
Get specific comment: { "itemId": "38456790" }
Get poll: { "itemId": "126809" }
Note: Large comment threads (>500 comments) may take 2-3 seconds to load due to nested fetching. Returns error if item doesn't exist or has been deleted.
Inputs: itemId (required).
get-latest-postsA
Retrieve the most recent HackerNews posts sorted by date.
Returns posts in chronological order (newest first), including all types of content unless filtered.
Supports:
Filter by content type using tags (story, comment, poll, show_hn, ask_hn, etc.)
Pagination to view older posts
Customizable results per page (default: 20)
Empty query to get all recent posts
Examples:
Get latest stories: { "tags": ["story"] }
Get latest comments: { "tags": ["comment"] }
Get all recent activity: { }
Get with custom page size: { "hitsPerPage": 50 }
Use this to monitor real-time HackerNews activity or find the newest content.
Inputs: tags, page, hitsPerPage.
get-userA
Retrieve public profile information for a HackerNews user.
Returns user profile including karma, bio, and account creation date. Use this to:
Check user reputation (karma score)
Read user bio and about information
See when account was created
Verify user existence before searching their content
Features:
Username (case-sensitive)
Karma score (total upvotes received)
About/bio text (may contain HTML)
Account creation date (Unix timestamp)
Examples:
Get famous user: { "username": "pg" }
Check moderator: { "username": "dang" }
Verify author: { "username": "tptacek" }
Username validation:
Alphanumeric characters and underscores only
Case-sensitive
Must exist on HackerNews
Returns error if user doesn't exist or username format is invalid.
Inputs: username (required).
search-postsA
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.
Inputs: query (required), tags, numericFilters, page, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct purpose: get-front-page retrieves the front page, get-item fetches a specific item with comments, get-latest-posts shows recent posts, get-user provides user profiles, and search-posts enables keyword searches. There is no overlap or ambiguity in functionality.
All tool names follow a consistent verb_noun pattern with hyphens: get-front-page, get-item, get-latest-posts, get-user, and search-posts. This uniformity makes the set predictable and easy to understand.
With 5 tools, the server is well-scoped for interacting with HackerNews. It covers key areas like front page, items, recent posts, users, and search without being too sparse or overwhelming.
The tool set covers most essential HackerNews operations, including reading, searching, and user lookup. However, it lacks write operations (e.g., posting comments or stories), which might be a minor gap for full interaction, though not critical for a read-focused server.
Maintenance
Related MCP Connectors
Browse Hacker News feeds, threads, and user profiles with full-text search.
HN front-page, Algolia full-text search, and Show HN launch tracker.
Hacker News stories, search and Who is Hiring jobs via the official API. Runs on Apify.
Hacker News MCP — search and retrieve stories from Hacker News
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to search, retrieve, and interact with HackerNews content including stories, comments, polls, and user information. Provides comprehensive access to all HackerNews API endpoints with 15 specialized tools for content discovery and analysis.155MIT
- AlicenseAqualityDmaintenanceProvides programmatic access to Hacker News content via the HN Algolia API. It enables AI assistants to search stories, retrieve comments, access user profiles, and explore the front page in real-time.9MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to read and search Hacker News for top stories, comments, user profiles, and job listings using the Firebase and Algolia APIs. It facilitates natural language research into community discussions and technological trends across the HN platform.8-
- AlicenseAqualityCmaintenanceProvides AI agents with access to Hacker News data including top stories, story details, comment threads, and full-text search for content research and trend monitoring.5MIT