README

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

Fork this repository
Connect your GitHub account to Render
Create a new Web Service on Render
Connect your forked repository
Render will automatically detect the render.yaml configuration

Your server will be available at https://hackernews-mcp.onrender.com/mcp

🎯 Poke Integration

Go to poke.com/settings/connections
Add the MCP URL: https://hackernews-mcp.onrender.com/mcp
Give it a name like "Hacker News"
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)

Hacker News MCP Server

README

Hacker News MCP Server

🚀 Features

🛠️ Local Development

🚢 Deployment

Option 1: One-Click Deploy to Render

Option 2: Manual Deployment

🎯 Poke Integration

🔧 Available Tools

📝 Example Usage

Recommended Servers