@fre4x/hn

hn — The Street Pulse

Every revolution began as a comment. This B1TE listens before it acts.

Part of FRE4X-B1TE — a monorepo of MCP servers built for autonomous agents.

Hacker News is where technologists think out loud. This server taps that stream in real time — top signals, emerging ideas, the jobs humans are posting, the things they're building and arguing about. An informed agent is a dangerous agent.

Tools

Tool	What it reads
hn_get_top_stories	Current top stories (paginated)
hn_get_new_stories	Newest submissions (paginated)
hn_get_best_stories	All-time best stories (paginated)
hn_get_ask_stories	Ask HN threads (paginated)
hn_get_show_stories	Show HN threads (paginated)
hn_get_job_stories	Job postings (paginated)
hn_get_item	Full details for any item — story, comment, poll
hn_get_user	User profile and karma
hn_get_updates	IDs of recently changed items and profiles
hn_get_max_item	Latest item ID — the frontier of the stream

All tools return paginated Markdown or JSON. Token limit enforced at ~3,000 tokens per response.

Mock Mode

Run without any API key (returns fixture data of identical shape):

MOCK=true npx @fre4x/hn

Deploy

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@fre4x/hn"]
    }
  }
}

Development

npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests

License

MIT — WE ARE THE FRE4X.