Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic

What is Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic?

A set of tools for AI agents to access Hacker News top stories, story details, comments threads, and full-text search via the public HN API. It requires no credentials, is zero‑config, and is built by NeCL – an AI engineering studio that uses it internally.

How to use Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic?

Install via uvx (recommended, no setup) or pip, then add the configuration to your MCP client’s mcp.json. Once configured, agents can call tools like hn_top_stories, hn_get_story, hn_get_comments, hn_search, and hn_category using natural language prompts.

Key features of Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic

• Zero credentials and zero configuration required.
• Five tools for top stories, story details, comments, search, and categories.
• Battle‑tested code extracted from NeCL’s internal content engine.
• Clean structured data output, designed for LLM chaining.
• Compatible with any MCP client (Claude Desktop, Claude Code, etc.).
• Uses the free public HN API with no rate limits worth worrying about.

Use cases of Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic

• Generate daily content briefs from top HN stories.
• Perform competitive research by searching HN for company mentions.
• Monitor trends by polling new and best categories on a cron.
• Build a newsletter pipeline that searches by keyword, clusters results, and creates editorial digests.
• Automate customer‑discovery by searching Ask HN for problems your product solves.

FAQ from Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic

mcp command not found or install errors?

Ensure Python 3.10+ is installed. If using uvx, install uv (pip install uv). For pip install, run pip install necl-hn-mcp and verify with python -m necl_hn_mcp --help.

Tool calls timeout?

HN’s Firebase API can be slow when fetching many items. For long‑window queries (e.g. hn_top_stories(limit=30, hours=168)), reduce the limit value. Default timeout is 10 seconds per request.

Algolia returns no hits for my search?

Algolia indexes HN content with a delay of about 5–15 minutes for fresh items. Use sort="date" to prioritise recent activity.

Why are comments threads empty for some stories?

hn_get_comments returns only top‑level comments to keep token costs predictable. The replies_count field on each comment indicates if deeper discussion exists, but replies are not recursively fetched.

Tools don’t show up in Claude after configuration?

Fully restart Claude Desktop or Claude Code (not just reload). Check the MCP logs under Settings → Developer to verify the server connects.