Hn-mcp-server MCP Server

Browse Hacker News feeds, threads, and user profiles with full-text search via MCP. STDIO or Streamable HTTP.

Local + remotestreamable-httpstdioApache-2.0

What is the Hn-mcp-server MCP Server?

Hn-mcp-server source profile. From the maintainer documentation: “Browse Hacker News feeds, threads, and user profiles with full-text search via MCP. STDIO or Streamable HTTP.”

Local setup

The project provides a local client configuration using bunx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
hn_get_storiesFetch stories from an HN feed (top, new, best, ask, show, jobs), with title, URL, score, author, and comment count
hn_get_threadGet an item and its comment tree as a threaded discussion, with depth and comment-count controls and a cursor to page through long threads
hn_get_userFetch a user profile with karma, about, and optionally a page of resolved submissions
hn_search_contentSearch stories, comments, polls, and jobs via Algolia by keyword, by filters alone, or both — type, author, parent story, date range, and minimum points

How to install the Hn-mcp-server MCP Server

{
  "mcpServers": {
    "hn-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": [
        "@cyanheads/hn-mcp-server@latest"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MCP_TRANSPORT_TYPEDeclared in the maintainer’s client configuration.Check documentation
MCP_LOG_LEVELDeclared in the maintainer’s client configuration.Check documentation