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
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
🚀 Quick Start
Other Clients
Add the following MCP server configuration to your client's MCP settings:
📚 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