# hackernews-mcp

mcp-name: io.github.pratham-jain33/hackernews-mcp

Give any AI assistant a Hacker News button. Three tools, no API key:

- `top_stories(limit)` — what's on HN's front page right now
- `search_stories(query, limit)` — search all of HN history
- `get_story(story_id, max_comments)` — a story in full, with top comments

## Install

```bash
uvx hackernews-mcp
```

No API key. Hacker News' public APIs are free and open.

## Use with Claude Desktop

Add to your MCP config:

```json
{
  "mcpServers": {
    "hackernews": {
      "command": "uvx",
      "args": ["hackernews-mcp"]
    }
  }
}
```

Then ask: "What's on Hacker News today?" or "What did HN say about MCP servers?"

## How it works

Your assistant calls one of the three tools. This server fetches from
Hacker News' free public APIs (the official Firebase API for stories and
comments, the Algolia API for search), formats the result as plain text,
and hands it back. Nothing is stored, nothing needs a key.

## Development

```bash
python -m venv .venv && source .venv/bin/activate
pip install -e .
python test_local.py
```

Unofficial community project. Not affiliated with Y Combinator or Hacker News.