mcpField
H
Hacker News MCP Server

Hacker News MCP Server

Local
github.com/devabdultechSocial Media19Updated 82w ago
Repository

About Hacker News MCP Server

Hacker News MCP Server is an MCP server that lets Cursor, Claude and other LLM clients access Hacker News stories, comments, user profiles and search. It is intended for users who want Hacker News data inside their AI client.

Key features

  1. 01Searches stories and comments via Algolia
  2. 02Lists stories by type such as top, new and best
  3. 03Retrieves a story with its comment tree
  4. 04Looks up user profiles and submissions

Use cases

  1. 01Searching Hacker News discussions on a topic
  2. 02Fetching the current top or newest stories
  3. 03Reviewing a user's profile and past submissions

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hn": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Hacker News MCP Server

smithery badge 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.

Hacker News Server MCP server

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"]
    }
  }
}
Installing via Smithery

To install Hacker News MCP Server for Claude Desktop automatically via Smithery:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.