mcp-reddit

# mcp-reddit MCP server for scraping Reddit - **no API keys required**. Scrapes posts and comments from subreddits and user profiles using Reddit's public RSS/Atom feeds. > [!IMPORTANT] > **What changed in v0.4.0:** Reddit shut down unauthenticated `.json` access in May 2026, > which broke this project (and every other keyless Reddit scraper). v0.4.0 pivots to > Reddit's still-public `.rss` feeds. Still zero API keys - but RSS exposes less data: > **no scores, upvote ratios, comment counts, NSFW flags, or comment threading.** > Those fields were removed from the data model. Comments are flat, up to 100 per post. ## Features - **No API keys** - Uses public RSS feeds, no Reddit API credentials needed - **Posts & comments** - Titles, authors, timestamps, selftext, flat comment bodies - **Image previews** - Downloads preview images (videos unavailable via RSS) - **Local persistence** - Query scraped data offline - **Filtering** - By post type and keywords ## Installation ```bash pip install mcp-reddit ``` Or with uvx: ```bash uvx mcp-reddit ``` ## Usage Modes ### Local (stdio) - Default For local MCP clients like Claude Desktop and Claude Code: ```bash uvx mcp-reddit ``` ### Remote (HTTP/SSE) For remote MCP clients that connect via URL: ```bash uvx mcp-reddit --http --port 8000 ``` Options: - `--http` - Run in HTTP/SSE mode instead of stdio - `--host` - Host to bind to (default: 0.0.0.0) - `--port` - Port to listen on (default: 8000, or `PORT` env var) The server exposes: - `GET /sse` - SSE endpoint for MCP connection - `POST /messages/` - Message endpoint - `GET /health` - Health check ## Configuration Add to your Claude Desktop or Claude Code settings: ### Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`) Claude Desktop doesn't inherit your shell PATH, so you need the full path to `uvx`: ```bash # Find your uvx path which uvx ``` Then use the full path in your config: ```json { "mcpServers": { "reddit": …