MCP server for searching Hacker News stories via Algolia
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"hacker-news-mcp-py","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Hacker News MCP MCP server for searching Hacker News stories through the Algolia Hacker News Search API. The server is read-only and is designed to run through `uvx`. The PyPI distribution name is `mcp-hacker-news` (the name `hacker-news-mcp` is rejected as too similar to existing projects). ## Install and Run Install from PyPI with pip: ```bash pip install mcp-hacker-news hacker-news-mcp ``` (`mcp-hacker-news` is also installed as a command.) Or run with uv: ```bash uvx mcp-hacker-news ``` During local development: ```bash uv run hacker-news-mcp ``` ## MCP Configuration ```json { "mcpServers": { "hacker-news": { "command": "uvx", "args": ["mcp-hacker-news"] } } } ``` ## Running from a Local Source Copy If you want to run a local copy of this repository instead of resolving the package through `uvx`, clone the source code and install dependencies: ```bash git clone https://github.com/m-higuchi/hacker-news-mcp cd hacker-news-mcp uv sync ``` Then use the following MCP configuration: ```json { "mcpServers": { "hacker-news": { "command": "uv", "args": [ "--directory", "/path/to/hacker-news-mcp", "run", "hacker-news-mcp" ] } } } ``` Replace `/path/to/hacker-news-mcp` with the **absolute path** to the directory where you cloned this repository (the folder that contains `pyproject.toml`). ## Backend API This server uses Algolia's Hacker News Search API as the primary backend: ```text https://hn.algolia.com/api/v1 ``` Story searches always include `tags=story`. Date range searches call `/search_by_date` and convert ISO dates into Algolia `created_at_i` numeric filters. ## Tools ### `search_stories_by_date` Search stories within a date range. Input: ```json { "query": "AI", "start_date": "2026-04-01", "end_date": "2026-04-27", "limit": 20, "page": 0 } ``` Behavior: - `start_date` and `end_date` accept `YYYY-MM-DD` or ISO datetime strings. - Date-on…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.