Hacker News MCP Server

# Hacker News MCP Server A FastMCP server that provides access to Hacker News data for Poke integration. ## 🚀 Features - **get_top_stories**: Fetch top stories from Hacker News - **get_story**: Get details of a specific story by ID - **get_new_stories**: Fetch newest stories - **search_stories**: Search for stories using Algolia API ## 🛠️ Local Development ```bash # Install dependencies pip install -r requirements.txt # Run the server python src/server.py ``` ## 🚢 Deployment ### Option 1: One-Click Deploy to Render [](https://render.com/deploy) ### Option 2: Manual Deployment 1. Fork this repository 2. Connect your GitHub account to Render 3. Create a new Web Service on Render 4. Connect your forked repository 5. Render will automatically detect the render.yaml configuration Your server will be available at `https://hackernews-mcp.onrender.com/mcp` ## 🎯 Poke Integration 1. Go to [poke.com/settings/connections](https://poke.com/settings/connections) 2. Add the MCP URL: `https://hackernews-mcp.onrender.com/mcp` 3. Give it a name like "Hacker News" 4. Test with: "Tell the subagent to use the Hacker News integration's get_top_stories tool" ## 🔧 Available Tools - `get_top_stories(limit=10)`: Get top stories (max 30) - `get_story(story_id)`: Get specific story details - `get_new_stories(limit=10)`: Get newest stories (max 30) - `search_stories(query, limit=10)`: Search stories (max 20) ## 📝 Example Usage ```python # Get top 5 stories get_top_stories(limit=5) # Get story details get_story(story_id=12345) # Search for Python stories search_stories(query="python", limit=5) ```