Skip to main content
Glama
@isteam/hackernews-mcp

@isteam/hackernews-mcp

by isteamhq

@isteam/hackernews-mcp

npm version License: MIT

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

top_stories

Get current top stories on Hacker News

new_stories

Get newest stories

best_stories

Get highest-voted stories

ask_stories

Get Ask HN stories

show_stories

Get Show HN stories

job_stories

Get job postings

get_story

Get a specific story by ID (title, URL, score, text)

Tool

Description

search

Full-text search across stories and comments (powered by Algolia)

Users & Comments

Tool

Description

get_user

Get a user's profile (karma, about, member since)

get_comments

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 X-RateLimit-* headers

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:

License

MIT

Available Tools

10 tools
ask_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.

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

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      An MCP server that enables AI assistants to access real-time Hacker News data including top stories, story details, comments, and search functionality.
      1
      48 npm
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      6
      35 PyPI
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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 npm
      MIT