Hacker News

by devabdultech

6 stars

167 downloads

Not rated

GitHub

About

Integrates with the Hacker News API to provide real-time access to stories, comments, and user data for news aggregation, trend analysis, and custom client development.

Details

Author: devabdultech
Repository: devabdultech/hn-mcp
GitHub stars: 6
Downloads: 167
License: MIT License
Categories: Communication, Other, Design, Developer Tools, File Management, Search, API, Frontend, Infrastructure

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Hacker News

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @devabdultech/hn-mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

From the repository

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@devabdultech/hn-mcp-server"]
    }
  }
}

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

npx -y @smithery/cli install @devabdultech/hn-mcp --client claude

`search`

Search for stories and comments on Hacker News using Algolia's search API. Inputs: query (string), type (optional string), page (optional number), hitsPerPage (optional number). Returns: Search results with stories and comments.

`getStories`

Get multiple stories by type (top, new, best, ask, show, job). Inputs: type (string), limit (optional number). Returns: Array of story objects.

`getStoryWithComments`

Get a story along with its comment thread. Inputs: id (number). Returns: Story details with nested comments.

`getCommentTree`

Get the full comment tree for a story. Inputs: storyId (number). Returns: Hierarchical comment tree structure.

`getUser`

Get a user's profile information. Inputs: id (string). Returns: User profile details including karma, created date, and about text.

`getUserSubmissions`

Get a user's submissions (stories and comments). Inputs: id (string). Returns: Array of user's submitted stories and comments.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hacker news": {
            "env": {},
            "args": [
                "-y",
                "@devabdultech/hn-mcp-server"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@devabdultech/hn-mcp-server"
    ],
    "shell": false,
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@devabdultech/hn-mcp-server"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@devabdultech/hn-mcp-server"
    ],
    "shell": false,
    "command": "cmd"
}

Hacker News MCP Server

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.

Features

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

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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search

getStories

getStoryWithComments

getCommentTree

getUser

getUserSubmissions

Claude Desktop / Cursor

Linux

Macos

Windows

Hacker News MCP Server

Features

Set Up

Running on Claude Desktop

Installing via Smithery

Tools

Contributing

License

About

Install

More like this

Sequential Thinking

Slack

Filesystem

EverArt

Google Drive

Reactive Resume

`search`

`getStories`

`getStoryWithComments`

`getCommentTree`

`getUser`

`getUserSubmissions`