Model Context Protocol server for HackerNews API access
npm install hn-mcp-server



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.
- 🔍 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


Add the following MCP server configuration to your client's MCP settings:
``json``
{
"hn-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "hn-mcp-server"]
}
}
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.
Example prompts:
- "Search for stories about TypeScript"
- "Find posts about AI with more than 200 points"
- "Search for comments by author 'dang'"
Example prompts:
- "What's trending on HackerNews?"
- "Show me the HN front page"
Example prompts:
- "What are the newest HackerNews stories?"
- "Show me recent Ask HN posts"
Example prompts:
- "Get HN item 38456789"
- "Show me the discussion for this story"
Example prompts:
- "Tell me about HN user 'pg'"
- "What's the karma for user 'tptacek'?"
- Node.js 18.0.0 or higher
- MCP Client - Any application that supports MCP:
- VS Code with GitHub Copilot
- Cursor
- And many more...
Contributions are welcome! Please see CONTRIBUTING.md for details.
- API Reference - Detailed API documentation
- Architecture - System design and architecture
MIT License - See LICENSE for details
- 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