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.

✨ 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:
  • VS Code with GitHub Copilot
  • Cursor
  • And many more...

🤝 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