hackernews-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hackernews-mcp-server show me the top 10 stories on Hacker News right now"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hackernews-mcp-server
A Model Context Protocol server that lets AI assistants read Hacker News.
Plug it into Cursor, Claude Desktop or Claude Code and ask things like:
"What is on the front page of Hacker News right now?"
"Summarize the top 5 Show HN posts."
"Are there any Ask HN threads about Rust today?"
It uses the official Hacker News API. No API key or account is needed.
Tool
fetch_hacker_news
Fetches current stories with title, link, score, author and comment count.
Parameter | Type | Default | Description |
| string |
|
|
| integer |
| Number of stories, from 1 to 30 |
The result comes in two forms: a compact text list for the model to read, and structured content for clients that support it.
{
"category": "top",
"stories": [
{
"id": 12345678,
"title": "Show HN: An example project",
"url": "https://example.com/project",
"discussionUrl": "https://news.ycombinator.com/item?id=12345678",
"score": 347,
"author": "someuser",
"comments": 72,
"postedAt": "2026-01-15T12:00:00.000Z"
}
]
}Ask HN and similar posts also carry a text field with the body in plain text, truncated to 500 characters.
Related MCP server: HackerNews MCP Server
Setup guide
1. Build the server
Requires Node.js 18 or newer.
git clone https://github.com/wallaceluis/hackernews-mcp-server.git
cd hackernews-mcp-server
npm install
npm run buildTake note of the absolute path to dist/index.js; every client below needs it. Examples:
macOS / Linux:
/Users/you/hackernews-mcp-server/dist/index.jsWindows:
C:\\Users\\you\\hackernews-mcp-server\\dist\\index.js(backslashes doubled inside JSON)
2. Connect your client
Cursor
Create .cursor/mcp.json in your project (or ~/.cursor/mcp.json to enable it everywhere):
{
"mcpServers": {
"hackernews": {
"command": "node",
"args": ["/absolute/path/to/hackernews-mcp-server/dist/index.js"]
}
}
}Then open Cursor Settings > MCP and check that hackernews is listed and enabled. The tool is available to the agent in chat.
Claude Desktop
Open Settings > Developer > Edit Config, which opens claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the server:
{
"mcpServers": {
"hackernews": {
"command": "node",
"args": ["/absolute/path/to/hackernews-mcp-server/dist/index.js"]
}
}
}Quit and reopen Claude Desktop. The fetch_hacker_news tool shows up in the tools menu of the chat input.
Claude Code
claude mcp add hackernews -- node /absolute/path/to/hackernews-mcp-server/dist/index.jsRun /mcp inside Claude Code to confirm the server is connected.
3. Try it
Ask your assistant: "Use Hacker News to tell me what developers are talking about today."
Troubleshooting
Problem | Fix |
Server does not show up or fails to start | Check that the path is absolute and that |
| The client may not share your shell's |
"The Hacker News API is unreachable" | The machine needs outbound HTTPS access to |
Changes to the code have no effect | Rebuild with |
To test the server on its own, use the MCP Inspector:
npm run inspectDevelopment
npm run dev # compile in watch mode
npm run typecheck
npm run inspect # open the MCP Inspector against the built server
npm test # unit tests + end-to-end tests through an in-memory MCP clientFile | Responsibility |
| Entrypoint: connects the server to the stdio transport |
| MCP server and the |
| Hacker News API client and result formatting |
The server talks to the client over stdio, so stdout is reserved for the protocol. Log with console.error, never console.log.
How it works
The Hacker News API exposes a ranked list of ids per category and one endpoint per item. The server reads the list, loads the first limit items in parallel (10 second timeout each), drops deleted and dead posts, and converts HTML bodies to plain text. A story that fails to load is skipped instead of failing the whole call. Errors are returned as tool errors so the model can see what went wrong.
License
Available Tools
1 toolfetch_hacker_newsFetch Hacker NewsARead-onlyIdempotent
Fetch current stories from Hacker News (news.ycombinator.com) with title, link, score, author and comment count. Use it for questions about tech news, what is trending among developers, or recent Ask HN / Show HN posts.
Inputs: limit, category. Returns: stories, category
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of confusion or misselection between tools. Its purpose (fetching Hacker News stories) is unambiguous.
The single name 'fetch_hacker_news' follows a clear verb_noun convention with snake_case. With only one tool there is no pattern to validate against, so it cannot demonstrate full consistency across a set.
A single tool is too thin for a Hacker News domain server, which naturally spans stories, comments, users, jobs, and search. One generic fetch tool under-serves the apparent scope.
The surface covers only fetching current stories; there is no way to retrieve comments, look up users, search, or filter by category (top/new/best/ask/show). Agents asking about discussion threads or specific posts will hit dead ends.
Maintenance
Related MCP Connectors
Hacker News stories, search and Who is Hiring jobs via the official API. Runs on Apify.
Browse Hacker News from chat: top stories, search, read comment threads, and post or upvote when yo…
Browse Hacker News feeds, threads, and user profiles with full-text search.
Hacker News MCP — search and retrieve stories from Hacker News
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables access to Hacker News data including top stories, new stories, specific story details, and search functionality. Integrates with Poke to provide Hacker News content through natural language interactions.1-
- AlicenseAqualityDmaintenanceProvides programmatic access to Hacker News content via the HN Algolia API. It enables AI assistants to search stories, retrieve comments, access user profiles, and explore the front page in real-time.9MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to read and search Hacker News for top stories, comments, user profiles, and job listings using the Firebase and Algolia APIs. It facilitates natural language research into community discussions and technological trends across the HN platform.8-
- AlicenseAqualityCmaintenanceProvides AI agents with access to Hacker News data including top stories, story details, comment threads, and full-text search for content research and trend monitoring.5MIT