HackerNews

MCP Server for HackerNews using Algolia HackerNews API

typescript

7

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": {
    "wei-hn-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hn-mcp-server"
      ]
    }
  }
}

Connect your AI assistant to HackerNews through a dedicated MCP server. This server lets your AI tools search posts, read discussions, and view user profiles on HackerNews, enabling natural language queries like finding top stories or getting item details directly from conversations.

How to use

You configure your MCP client to connect to the HackerNews MCP server, then ask your AI assistant questions in natural language. Use the available tools to perform searches, fetch front-page posts, monitor latest items, retrieve item details with nested comments, or view user profiles. The assistant will automatically select the appropriate tool to answer your question, so you can focus on your goals rather than MCP internals.

How to install

Prerequisites: ensure you have Node.js 18.0.0 or higher installed on your system.

Install the MCP server by running the following commands in your terminal. These steps assume you are using npm and npx to execute the local MCP server configuration.

Open a terminal and install the MCP server as a local command via npx when you are ready to run it.
Start the MCP server with the runtime command and arguments shown in the configuration example provided later in this guide.

Configuration and usage notes

The following MCP server configuration is used to run the HackerNews MCP Server locally as a stdio server. It uses npx to execute the package and passes the -y flag to skip prompts.

{
  "hn-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "hn-mcp-server"]
  }
}

Example prompts you can use with your AI assistant

"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'"

Additional details

Reliable access to the HN data is provided via the available MCP tools. Your AI assistant will invoke the appropriate tool to fulfill your questions, such as searching posts, fetching the front page, listing latest posts, retrieving item details with comments, or loading user profiles.

Available tools

search-posts

Search HackerNews by keyword with optional filters for content type, points, and date range.

get-front-page

Retrieve the current HackerNews front page posts.

get-latest-posts

Fetch the most recent HackerNews posts sorted by date.

get-item

Get complete item details, including nested comments, for a specific HackerNews post or discussion.

get-user

Load profile information for a HackerNews user, including karma and bio.