Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level | info |
| SERVER_NAME | No | Name of the server | hackernews-mcp-server |
| CACHE_MAX_SIZE | No | Maximum size of the cache | 1000 |
| SERVER_VERSION | No | Version of the server | 1.0.0 |
| CACHE_TTL_SECONDS | No | Cache time-to-live in seconds | 300 |
| HACKERNEWS_API_TIMEOUT | No | Timeout for HackerNews API requests in milliseconds | 10000 |
| HACKERNEWS_API_BASE_URL | No | Base URL for the HackerNews API | https://hacker-news.firebaseio.com/v0 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze-story | Generate a comprehensive analysis of a HackerNews story including content, engagement, and discussion patterns |
| analyze-user-profile | Generate insights about a HackerNews user's activity patterns, expertise, and community engagement |
| summarize-trending-topics | Generate a comprehensive summary of current trending topics and discussions on HackerNews |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| top-stories | Current top stories from HackerNews front page |
| new-stories | Latest new stories from HackerNews |
| best-stories | Best stories from HackerNews |
| ask-stories | Latest Ask HN stories and discussions |
| show-stories | Latest Show HN stories and projects |
| job-stories | Latest job postings from HackerNews |
| updates | Recently changed items and user profiles on HackerNews |
| max-item | The current maximum item ID on HackerNews |
| cache-stats | Current cache statistics and performance metrics |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_posts | Search and filter HackerNews posts by keywords, author, score, and date range |
| get_post | Get comprehensive details about a HackerNews post including metadata and comments |
| search_user | Get a HackerNews user's profile, activity, statistics, and contribution patterns |
| search_trending | Find current trending topics and keywords from top HackerNews posts |
| search_comments | Analyze the comment tree of a post for engagement patterns and statistics |