@isteam/hackernews-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| top_storiesB | Get current top stories on Hacker News |
| new_storiesA | Get newest stories on Hacker News |
| best_storiesB | Get highest-voted stories on Hacker News |
| ask_storiesC | Get Ask HN stories |
| show_storiesC | Get Show HN stories |
| job_storiesA | Get job postings from Hacker News |
| get_storyA | Get a specific Hacker News story by ID (title, URL, score, text) |
| searchA | Search Hacker News stories and comments via Algolia (full-text search with relevance or date sorting) |
| get_userA | Get a Hacker News user profile (karma, about, member since) |
| get_commentsA | Get comments on a Hacker News story (threaded, depth-limited) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool targets a distinct resource: story lists by category, individual story retrieval, search, user profiles, and comments. Even with multiple story list tools, the category names (top, new, best, ask, show, job) clearly differentiate them.
All tool names use snake_case, but there is a slight inconsistency: list tools are noun phrases (e.g., top_stories) while retrieval tools use get_ (e.g., get_story). However, the pattern is predictable and readable, with no mixed conventions.
10 tools is well-scoped for a Hacker News reader. Each tool serves a clear purpose in covering story lists, individual stories, comments, user profiles, and search, without unnecessary duplication.
The read-only surface is fairly complete: it offers all major story categories, specific story retrieval, comments, user info, and search. Minor gaps include lack of direct item retrieval for non-story items or user submission history, but these are not critical for the core use case.