hn-mcp
Utilizes Algolia Search to provide full-text search capabilities for Hacker News stories and comments, enabling users to query historical and current content.
Integrates with the official Hacker News API hosted on Firebase to retrieve real-time data, including top stories, detailed comment trees, and user profiles.
Click on "Install 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., "@hn-mcpSearch the monthly hiring thread for remote TypeScript roles"
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.
hn-mcp
An AI-powered reader for Hacker News. Like an RSS reader, but for HN — and your AI assistant does the reading for you.
HN hasn't changed in 18 years. No notifications. No way to follow threads. No digest. No way to filter the monthly "Who is hiring?" thread without Ctrl+F.
This MCP server wraps the official HN API and Algolia Search so your AI assistant (Claude, Cursor, Windsurf, etc.) can help you keep up with the conversations that matter to you.
Quick Start
Claude Code / Claude Desktop
claude mcp add hn-mcp -- npx hn-mcpManual (any MCP client)
{
"mcpServers": {
"hn-mcp": {
"command": "npx",
"args": ["hn-mcp"]
}
}
}That's it. No API keys, no accounts, no config required.
What Can It Do?
Reply Notifications
HN has no notifications. This is the most-requested feature in HN history. Now you have it.
> Check my HN replies
2 new replies for gbibas:
[sebmellen | 2h ago] on your comment about agent sandboxing:
"Interesting approach with the worktrees..."
https://news.ycombinator.com/item?id=12345
[dandaka | 1h ago] on your comment about MCP vs CLI:
"Good point about discovery..."
https://news.ycombinator.com/item?id=12346Personalized Digest
Define your interests in ~/.hn-profile.yaml and get a curated feed instead of scanning 60 stories.
> What's on HN for me today?
Matching Your Interests (4 stories):
- Claude Code Unpacked (994 pts, 353 comments) [ai-agents, mcp]
- Axios compromised on NPM (1900 pts, 780 comments) [supply-chain-security]
- Show HN: Zerobox – Sandbox any command (63 pts, 66 comments) [developer-tools]
Activity from People You Follow:
- tptacek commented on "Axios compromised" (3 comments)Who is Hiring? Filter
The monthly hiring thread has 500+ comments. Stop Ctrl+F'ing.
> Search Who is Hiring for remote TypeScript AI
Found 12 postings matching "remote TypeScript AI":
---
Acme Corp | Remote (US) | Senior Full-Stack Engineer | TypeScript, React, AI/ML
We're building AI-powered developer tools...
https://news.ycombinator.com/item?id=12347Thread Intelligence
Understand a 300-comment thread before diving in.
> Summarize the Claude Code thread
"Claude Code Unpacked" — 994 pts, 353 comments
Most Discussed Comments (by reply count):
- [amangsingh] (15 replies): "500K LOC proves LLMs struggle with determinism..."
- [troupo] (12 replies): "A TUI wrapper should need 20-50K LOC max..."
Most Active Participants:
- amangsingh (3 top-level comments)
- troupo (2 top-level comments)Everything Else
Tool | What It Does |
| Check for replies to your comments |
| Stories matching your interests + followed users' activity |
| Search the monthly hiring thread by keyword |
| Full comment tree for any story |
| Key participants and most-discussed comments |
| Search within a specific thread |
| Track threads for new comments |
| Recent activity from users you follow |
| Current top stories |
| Current Ask HN stories |
| Current Show HN stories |
| Get a single story's details |
| Look up a user's public profile |
| Your recent comments and submissions |
| Search stories or comments via Algolia |
Personalization
Create ~/.hn-profile.yaml to personalize your experience:
# Your HN username (used for replies and activity)
username: your-hn-username
# Topics you care about
topics:
- ai-agents
- developer-tools
- open-source
- saas
- startup-bootstrapping
# Specific keywords to match
keywords:
- "Claude Code"
- "MCP server"
- "Chrome extension"
- TypeScript
- Supabase
# Users whose comments you want to follow
follow:
- tptacek
- patio11
- dang
# Threads you're watching (add via hn_watch tool)
watching: []All data is stored locally in ~/.hn-mcp/. No server, no telemetry, no account required.
Why This Exists
I've had an HN account since 2011. In that time, the reading experience hasn't changed. I wanted to actually engage in conversations without spending an hour scanning threads and manually refreshing /threads to check for replies.
This gives my AI assistant read access to HN so I can focus on the conversations, not on finding them.
Tech
TypeScript, ~600 lines
HN Firebase API (no auth, no rate limits)
Algolia HN Search for full-text search
Zero config to start,
~/.hn-profile.yamlfor personalizationAll state stored locally in
~/.hn-mcp/
License
MIT
Built by Greg Bibas
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/UpGPT-ai/hn-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server