README.md•3.24 kB
# Hacker News MCP Server
[](https://smithery.ai/server/@devabdultech/hn-mcp)
Official Hacker News MCP Server - Adds powerful Hacker News integration to Cursor, Claude, and any other LLM clients. Access stories, comments, user profiles, and search functionality through the Model Context Protocol.
<a href="https://glama.ai/mcp/servers/73uji99mwg">
<img width="380" height="200" src="https://glama.ai/mcp/servers/73uji99mwg/badge" alt="Hacker News Server MCP server" />
</a>
## Features
- Search stories and comments using Algolia's HN Search API
- Get stories by type (top, new, best, ask, show, job)
- Get individual stories with comments
- Get comment trees and user discussions
- Get user profiles and submissions
- Real-time access to Hacker News data
## Set Up
### Running on Claude Desktop
Add this to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"hackernews": {
"command": "npx",
"args": ["-y", "@devabdultech/hn-mcp-server"]
}
}
}
```
### Installing via Smithery
To install Hacker News MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@devabdultech/hn-mcp):
```bash
npx -y @smithery/cli install @devabdultech/hn-mcp --client claude
```
## Tools
1. `search`
* Search for stories and comments on Hacker News using Algolia's search API
* Inputs:
* `query` (string): Search query
* `type` (optional string): Filter by type ('story' or 'comment')
* `page` (optional number): Page number for pagination
* `hitsPerPage` (optional number): Results per page (max 100)
* Returns: Search results with stories and comments
2. `getStories`
* Get multiple stories by type (top, new, best, ask, show, job)
* Inputs:
* `type` (string): Type of stories to fetch ('top', 'new', 'best', 'ask', 'show', 'job')
* `limit` (optional number): Number of stories to fetch (max 100)
* Returns: Array of story objects
3. `getStoryWithComments`
* Get a story along with its comment thread
* Inputs:
* `id` (number): Story ID
* Returns: Story details with nested comments
4. `getCommentTree`
* Get the full comment tree for a story
* Inputs:
* `storyId` (number): ID of the story
* Returns: Hierarchical comment tree structure
5. `getUser`
* Get a user's profile information
* Inputs:
* `id` (string): Username
* Returns: User profile details including karma, created date, and about text
6. `getUserSubmissions`
* Get a user's submissions (stories and comments)
* Inputs:
* `id` (string): Username
* Returns: Array of user's submitted stories and comments
### Contributing
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request
## License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
## About
This MCP server is built and maintained by [devabdultech](https://github.com/devabdultech). It uses the official Hacker News API and Algolia Search API to provide comprehensive access to Hacker News data through the Model Context Protocol.