hn-mcp

Hacker News MCP Server

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.

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:

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@devabdultech/hn-mcp-server"]
    }
  }
}

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. It uses the official Hacker News API and Algolia Search API to provide comprehensive access to Hacker News data through the Model Context Protocol.