Hacker News MCP Server

An MCP server implementation that enables Claude to interact with Hacker News content through the official and Algolia APIs.

Installation

npm install @microagents/server-hackernews
# or
yarn add @microagents/server-hackernews

Usage

Direct Execution

# No environment variables needed
npx @microagents/server-hackernews

With Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["@microagents/server-hackernews"]
    }
  }
}

Features

• Search: Search stories and comments using Algolia's HN Search API
• Story Retrieval: Get stories by type (top, new, best, ask, show, job)
• Comment Threads: Get a story with its full comment thread
• User Profiles: Get user information and submission history

Tools

search

Search stories and comments using Algolia's HN Search API.

Inputs:

• query (string): Search terms
• type (string, optional): Type of content to search ("story", "comment", or "all")
• sortBy (string, optional): Sort method ("relevance", "date", "points", or "comments")
• page (number, optional): Page number for pagination

getStories

Get stories by type.

Inputs:

• type (string): Type of stories to retrieve ("top", "new", "best", "ask", "show", "job")
• limit (number, optional): Number of stories to retrieve (max 500)

getStoryWithComments

Get a story with its comment thread.

Inputs:

• id (number): ID of the story

getCommentTree

Get the full comment tree for a story.

Inputs:

• id (number): ID of the story

getUser

Get user profile information.

Inputs:

• username (string): Username to retrieve

getUserSubmissions

Get user's submissions (stories and comments).

Inputs:

• username (string): Username to retrieve submissions for
• limit (number, optional): Number of submissions to retrieve

License

MIT

Credits

Based on the original MCP server by Abdul Rahman.