@isteam/hackernews-mcp
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., "@@isteam/hackernews-mcp What are 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.
@isteam/hackernews-mcp
MCP server for Hacker News — search stories, read comments, and track tech trends via AI agents.
Built by is.team — the AI-native project management platform.
Quick Start
Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):
{
"mcpServers": {
"hackernews": {
"command": "npx",
"args": ["-y", "@isteam/hackernews-mcp"]
}
}
}No API keys required — uses the public Hacker News API and Algolia HN Search.
Related MCP server: hn-mcp
Tools (10)
Stories
Tool | Description |
| Get current top stories on Hacker News |
| Get newest stories |
| Get highest-voted stories |
| Get Ask HN stories |
| Get Show HN stories |
| Get job postings |
| Get a specific story by ID (title, URL, score, text) |
Search
Tool | Description |
| Full-text search across stories and comments (powered by Algolia) |
Users & Comments
Tool | Description |
| Get a user's profile (karma, about, member since) |
| Get threaded comments on a story (depth-limited) |
Rate Limits & Agent Safety
Both APIs used by this server are public and have generous limits:
API | Limit | Notes |
HN Firebase API | ~500 req/sec per IP | No auth required, very lenient |
Algolia HN Search | ~1,000 req/min per IP | Returns |
This server is read-only — there are no write operations, so idempotency and duplicate posting are not a concern.
Backoff: If you hit Algolia's rate limit, it returns 429 with X-RateLimit-Reset header. Add a brief delay before retrying.
Usage Examples
Track tech trends:
"What are the top 10 stories on Hacker News right now?"
Research a topic:
"Search Hacker News for discussions about 'MCP protocol' sorted by date"
Analyze community sentiment:
"Get the comments on story 12345678 and summarize the main opinions"
Monitor Show HN:
"Show me the latest Show HN posts — are any related to AI project management?"
Competitive research:
"Search HN for mentions of Linear, Jira, and Asana in the past month"
Data Sources
This MCP server uses two public APIs:
Hacker News API — Official Firebase-based API for stories, comments, and user profiles
Algolia HN Search — Full-text search with relevance ranking and date filtering
Both APIs are free, require no authentication, and have generous rate limits.
About is.team
is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.
Part of the is.team open-source MCP ecosystem:
@isteam/mcp — Project management
@isteam/google-ads-mcp — Google Ads
@isteam/twitter-mcp — Twitter/X
@isteam/bluesky-mcp — Bluesky
@isteam/linkedin-mcp — LinkedIn
@isteam/hackernews-mcp — Hacker News
License
MIT
Available Tools
10 toolsask_storiesC
Get Ask HN stories
Inputs: limit.
best_storiesB
Get highest-voted stories on Hacker News
Inputs: limit.
get_commentsA
Get comments on a Hacker News story (threaded, depth-limited)
Inputs: story_id (required), depth, limit.
get_storyA
Get a specific Hacker News story by ID (title, URL, score, text)
Inputs: id (required).
get_userA
Get a Hacker News user profile (karma, about, member since)
Inputs: username (required).
job_storiesA
Get job postings from Hacker News
Inputs: limit.
new_storiesA
Get newest stories on Hacker News
Inputs: limit.
searchA
Search Hacker News stories and comments via Algolia (full-text search with relevance or date sorting)
Inputs: query (required), sort, type, limit.
show_storiesC
Get Show HN stories
Inputs: limit.
top_storiesB
Get current top stories on Hacker News
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource: story lists by category, individual story retrieval, search, user profiles, and comments. Even with multiple story list tools, the category names (top, new, best, ask, show, job) clearly differentiate them.
All tool names use snake_case, but there is a slight inconsistency: list tools are noun phrases (e.g., top_stories) while retrieval tools use get_ (e.g., get_story). However, the pattern is predictable and readable, with no mixed conventions.
10 tools is well-scoped for a Hacker News reader. Each tool serves a clear purpose in covering story lists, individual stories, comments, user profiles, and search, without unnecessary duplication.
The read-only surface is fairly complete: it offers all major story categories, specific story retrieval, comments, user info, and search. Minor gaps include lack of direct item retrieval for non-story items or user submission history, but these are not critical for the core use case.
Maintenance
Related MCP Connectors
Dive into the latest and greatest from the tech world with our Hacker News MCP server.
Hacker News MCP — search and retrieve stories from Hacker News
Hosted MCP server for live public-data APIs and Skills for AI agents.
Search Hacker News, Bluesky, and Substack from a single MCP interface
Related MCP Servers
- AlicenseDqualityDmaintenanceAn MCP server that enables AI assistants to access real-time Hacker News data including top stories, story details, comments, and search functionality.148 npm3MIT
- AlicenseAqualityBmaintenanceMCP server enabling AI agents to interact with Hacker News, including fetching full comment trees with depth control, searching stories and comments, and retrieving user profiles.635 PyPI5MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access Hacker News data including stories, items, users, and comments via MCP tools.-
- AlicenseNot gradedqualityDmaintenanceMCP server for Hacker News research. Enables AI agents to search stories and comments, browse listings, read discussion threads, and look up users via structured tools.36 npmMIT