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