MCP Hacker News Server

Provides real-time Hacker News data via MCP endpoints for Claude, Cursor, and other AI tools.

typescript

29

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "paablolc-mcp-hacker-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hacker-news"
      ]
    }
  }
}

You can run this MCP server to bridge the official Hacker News data with AI tools that support the Model Context Protocol. It exposes standardized endpoints so you can fetch live posts, comments, and user information from Hacker News and use it in your AI workflows.

How to use

You interact with the server through a compatible MCP client. Configure the client to point to the included MCP server entry named mcp-hacker-news, which runs as a local stdio process. Once started, you can query top, new, and best stories, along with additional item-, user-, and comment-specific data, for downstream AI tools and automation.

To connect your client, use the following for your MCP configuration. This creates a local stdio connection using npx to run the MCP server package.

{
  "mcpServers": {
    "mcp-hacker-news": {
      "command": "npx",
      "args": ["-y", "mcp-hacker-news"]
    }
  }
}

Available tools

getTopStories

Fetch top stories with an adjustable limit to tailor results for your workflow.

getBestStories

Retrieve the best algorithmic stories based on the site's internal ranking.

getNewStories

Obtain the newest stories posted on Hacker News.

getAskHNStories

Fetch posts categorized as Ask HN.

getShowHNStories

Fetch posts categorized as Show HN.

getJobStories

Retrieve current job postings from Hacker News.

getItem

Retrieve a specific item such as a story or a comment by its ID.

getUser

Retrieve a user profile by username.

getComments

Fetch comments for a specific item.

getMaxItemId

Get the current maximum item ID known to the API.

getUpdates

Fetch recently updated items and profiles.