A minimal, no-friction toolset for accessing Hacker News data inside AI agents and applications. Designed for fast retrieval, predictable responses, and straightforward integration.

---

What You Get

• Top stories from the Hacker News front page
• Full story details with top comments
• Latest Ask HN discussions
• Latest Show HN launches

All responses are structured for direct use in LLM pipelines.

---

Available Tools

get_top_stories

Fetches the current top stories from Hacker News.

Returns:

• Story ID
• Title
• URL
• Score
• Author

---

get_story

Fetches a specific story along with its top comments.

Input:

jsonCOPY
{
  "id": "number"
}

Returns:

• Story details (title, URL, score, author)
• Top-level comments

---

get_ask_hn

Fetches the latest Ask HN posts.

Returns:

• Post ID
• Title
• Author
• Discussion context

---

get_show_hn

Fetches the latest Show HN posts.

Returns:

• Project title
• URL
• Author
• Summary context

---

How to Use

List available tools

GET /tools

---

Call a tool

POST /tools/<tool_name>

---

Example

Request:

jsonCOPY
{
  "id": 123456
}

Endpoint:

POST /tools/get_story

---

Example Response

jsonCOPY
{
  "title": "Example Story",
  "url": "https://example.com",
  "score": 120,
  "author": "username",
  "comments": [
    {
      "author": "user1",
      "text": "Interesting take on this..."
    }
  ]
}

---

Where This Fits

• AI research assistants
• Developer-focused agents
• Trend analysis tools
• Startup discovery workflows

---

Notes

• Responses are optimized for readability and downstream processing
• Best suited for developer and tech-focused use cases
• Data reflects live Hacker News activity

---

Summary

A focused MCP toolset for plugging Hacker News directly into AI systems — clean, fast, and built for real usage.