hn-mcp-server

Four read-only tools for accessing Hacker News data:

Fetch stories from any HN feed with pagination support.

- Six feed types:top,new,best,ask,show,jobs
- Configurable count (1–100, default 30) and offset for pagination
- Returns enriched story objects with title, URL, score, author, comment count, and body text

Retrieve an item and its full comment tree via ranked breadth-first traversal.

- Depth control (0–10, default 3) — depth 0 doubles as a single-item lookup
- Comment limit (1–200, default 50) caps total comments across all levels
- Breadth-first traversal preserves HN's ranking order
- Flat comment list withdepth/parentIdfor tree reconstruction

Fetch a user profile with optional submission resolution.

- Profile includes karma, creation date, and about text (HTML stripped)
- Optionally resolves submissions into full items, up to 50 per page
- submissionOffsetpages through a long history; enrichment echoes the applied offset and the offset to request next
- Submission resolution filters out dead/deleted items

Full-text search via the Algolia HN Search API.

- Filter by content type:story,comment,ask_hn,show_hn,front_page
- Filter by author, date range (ISO 8601), and minimum points
- Sort by relevance or date
- Pagination with page/count controls
- view: "compact"drops the two body-text fields (text,highlights.text), which otherwise repeat a long comment twice per hit — pass a hit id tohn_get_threadto read the body

- Declarative tool definitions — single file per tool, framework handles registration and validation
- Unified error handling across all tools
- Structured logging with request correlation
- Runs locally (stdio/HTTP) from the same codebase

- Server-levelinstructionsorientation forwarded to LLM clients oninitialize— item types, ID reuse across tools, case-sensitive usernames, and field sparsity expectations
- Concurrent batch fetching with configurable parallelism for item resolution
- HTML entity decoding and tag stripping with code block and link preservation
- No API keys required — HN APIs are public

A public instance is available athttps://hn.caseyjhand.com/mcp— no installation required. Point any MCP client at it via Streamable HTTP:

{ "mcpServers": { "hn-mcp-server": { "type": "streamable-http", "url": "https://hn.caseyjhand.com/mcp" } } }

Add to your MCP client configuration file:

git clone https://github.com/cyanheads/hn-mcp-server.git cd hn-mcp-server bun install

All configuration is via environment variables. No API keys required — HN APIs are public.

MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts # Dev mode (stdio, auto-reload) MCP_TRANSPORT_TYPE=http bun --watch src/index.ts # Dev mode (HTTP, auto-reload) bun run test # Run test suite bun run devcheck # Lint + format + typecheck + audit

bun run build bun run start:stdio # or start:http

docker build -t hn-mcp-server . docker run -p 3010:3010 hn-mcp-server

- Handlers throw, framework catches — notry/catchin tool logic
- Usectx.logfor request-scoped logging
- All tools are read-only — no auth scopes required

Issues and pull requests are welcome. Run checks before submitting:

Objective-driven deep research paid per request via MPP - free daily quick search (news/arXiv), quote-first paid cloud-browser research with cross-source reports. MCP Streamable HTTP, no API key.

About Free multi-engine MCP search server — 8 free engines (DDG, Sogou, Bing, Baidu, Wikipedia, Startpage, Yandex, Mojeek), waterfall progressive search, multi-source verification, content enrichment, news search, language auto-detection, rate limit exposure. Zero API keys needed. Self-hostable.

Hosted MCP server for the APITube News API: search articles from 500,000+ sources in 60+ languages, filtered by sentiment, entities, topics and source quality.

A search engine for AI applications, providing world knowledge from web pages and various content sources like weather, news, and images.

Fetches the latest news headlines from the Boring News API.

An MCP (Model Context Protocol) server that gives AI assistants real-time news fetching, search, NLP analysis, and personalized news preferences — all accessible through natural language.

Comprehensive web, news, and social media search and analysis using xAI's Grok API.

Fetch and interact with Hacker News content, including top stories, comments, and search functionality.