Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HN_MCP_HTTP | No | Run as HTTP server instead of stdio | false |
| HN_MCP_PORT | No | HTTP server port | 3000 |
| HN_MCP_NO_CACHE | No | Disable caching for real-time data | false |
| HN_MCP_RATE_LIMIT | No | Override rate limit (requests/minute) | 300 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| browse_stories | Browse Hacker News stories by type. Returns story list with scores, comments, and metadata. |
| search_hn | Search Hacker News stories and comments. Returns matching content with relevance scores. |
| get_story_details | Get a Hacker News story with its comments. Fetches full story content and comment threads. |
| user_analysis | Analyze a Hacker News user's profile, karma, and recent submissions. |
| hn_explain | Get explanations of Hacker News terms, culture, and conventions. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |