Real-Time Hacker News Context for Your LLMs, Agents, and Apps

🚀 Announcing hacker-news-mcp v1.0.0

I'm thrilled to announce the first public release of hacker-news-mcp—the easiest way to bring live Hacker News data and discussion into your LLM, agent, or app workflows!

What does this do for you?

• Instantly connect your LLM, agent, or chatbot to the pulse of the tech world: hacker-news-mcp acts as a bridge between the Hacker News API and the Model Context Protocol (MCP), letting your AI tools reference real-time stories, comments, and trends from Hacker News—using natural language or keywords.
• No more hunting for story IDs: Just ask for stories by topic, title, or plain English (“What are people saying about quantum computing?”) and get structured, actionable results.
• Plug-and-play integration: Use as a local tool, REST API, or drop-in containerized microservice—works out of the box with Claude Desktop, Windsurf, Cursor IDE, and any MCP-compatible environment. Open WebUI user? This runs as an OpenAPI tool server too, so you can easily configure Open WebUI to use it, just drop in the http url for instance access to all the tools.

Why should you bother using this?

• Supercharge your AI’s context awareness: Give your LLMs access to what’s trending, what developers are discussing, or the latest opinions on any topic—direct from the HN community.
• Rich prompt templates & advanced analysis: Summarize stories, analyze discussions or user activity, extract code/examples from articles, compare perspectives, and more—using built-in natural language prompts.
• Flexible deployment: Run locally, in the cloud, or via Docker. Supports both STDIO (for direct LLM integration) and SSE (for web/remote use).
• Production-ready: Robust error handling, health checks, CORS, OpenAPI docs, and easy environment-based configuration.

Who is this for?

• LLM/AI Agent Developers: Give your agents timely news, discussions, and context.
• Chatbot Builders: Power bots with real-world data and community insights.
• Researchers & Data Scientists: Analyze trends, user activity, or topic sentiment.
• Anyone building productivity tools, dashboards, or notification bots—or anyone who wants to make Hacker News programmable!

Example: How easy is it?

Ask for top stories, search by topic, fetch comments, or retrieve article content (even as Markdown!)—all via REST or MCP. Example:

curl "http://localhost:8000/api/stories/search?query=AI+ethics&limit=3"

Or, in your Claude Desktop config:

{
  "mcpServers": {
    "hackerNews": {
      "command": "python",
      "args": ["/path/to/hacker-news-mcp/run.py", "--transport", "stdio"],
      "env": { "LOG_LEVEL": "info" }
    }
  }
}

Documentation?

Loads of it. As well as the detailed in-repository documentation, more documentation is ready to consume the moment you run the service, including:-

• OpenAPI Documentation via /openapi.json
• Swagger via /docs
• Redoc via /redoc

Get Started

• GitHub: rawveg/hacker-news-mcp
• Quick install: pip install -r requirements.txt, then python run.py --transport sse
• Docs & OpenAPI: Available at /docs after starting the server.
• Docker & cloud ready —see the README for deployment examples.

Give your LLMs, agents, or apps live access to Hacker News today. Questions, issues, or ideas? Contributions and feedback are very welcome!