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:
{
"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