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

# Install dependencies
pip install -r requirements.txt

# Run the server
python src/server.py

🚢 Deployment

Option 1: One-Click Deploy to Render

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
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

# 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)