
reddit-research-mcp
io.github.king-of-the-grackles/reddit-research-mcp
Turn Reddit's chaos into structured insights with full citations - MCP server for Reddit research
Documentation
mcp-name: io.github.king-of-the-grackles/reddit-research-mcp
π Reddit Research MCP Server
Turn Reddit's chaos into structured insights with full citations
Your customers are on Reddit right now, comparing you to competitors, sharing pain points, requesting features. But finding those insights means hours of manual searching with no way to cite your sources.
This MCP server turns Reddit into a queryable research database that generates reports with links to every claim. Get comprehensive market research, competitive analysis, and customer insights in minutes instead of hours.
π Quick Setup (60 Seconds)
No credentials or configuration needed! Connect to our hosted server:
Claude Code
claude mcp add --scope local --transport http reddit-research-mcp https://reddit-research-mcp.fastmcp.app/mcp
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=reddit-research-mcp&config=eyJ1cmwiOiJodHRwczovL3JlZGRpdC1yZXNlYXJjaC1tY3AuZmFzdG1jcC5hcHAvbWNwIn0%3D
OpenAI Codex CLI
codex mcp add reddit-research-mcp \
npx -y mcp-remote \
https://reddit-research-mcp.fastmcp.app/mcp \
--auth-timeout 120 \
--allow-http \
Gemini CLI
gemini mcp add reddit-research-mcp \
npx -y mcp-remote \
https://reddit-research-mcp.fastmcp.app/mcp \
--auth-timeout 120 \
--allow-http
Direct MCP Server URL
For other AI assistants: https://reddit-research-mcp.fastmcp.app/mcp
π― What You Can Do
Competitive Analysis
"What are developers saying about Next.js vs Remix?"
β Get a comprehensive report comparing sentiment, feature requests, pain points, and migration experiences with links to every mentioned discussion.
Customer Discovery
"Find the top complaints about existing CRM tools in small business communities"
β Discover unmet needs, feature gaps, and pricing concerns directly from your target market with citations to real user feedback.
Market Research
"Analyze sentiment about AI coding assistants across developer communities"
β Track adoption trends, concerns, success stories, and emerging use cases with temporal analysis showing how opinions evolved.
Product Validation
"What problems are SaaS founders having with subscription billing?"
β Identify pain points and validate your solution with evidence from actual discussions, not assumptions.
β¨ Why This Server?
Built for decision-makers who need evidence-based insights. Every report links back to actual Reddit posts and comments. When you say "users are complaining about X," you'll have the receipts to prove it. Check the /reports
folder for examples of deep-research reports with full citation trails.
Zero-friction setup designed for non-technical users. Most MCP servers require cloning repos, managing Python environments, and hunting for API keys in developer dashboards. This one? Just paste the URL into Claude and start researching. Our hosted solution means no terminal commands, no credential management, no setup headaches.
Semantic search across 20,000+ active subreddits. Reddit's API caps at 250 search results - useless for comprehensive research. We pre-indexed every active subreddit (2k+ members, active in last 7 days) with vector embeddings. Now you search conceptually across all of Reddit, finding relevant communities you didn't even know existed. Built with the layered abstraction pattern for scalability.
π Specifications
Some of the AI-generated specs that were used to build this project with Claude Code:
- π Architecture Overview - System design and component interaction
- π€ Research Agent Details - Agent implementation patterns
- π Deep Research Architecture - Research workflow and citation system
- ποΈ ChromaDB Proxy Architecture - Vector search and authentication layer
Technical Details
π οΈ Core MCP Tools
Discover Communities
execute_operation("discover_subreddits", {
"topic": "machine learning",
"limit": 15
})
Search Across Reddit
execute_operation("search_all", {
"query": "ChatGPT experiences",
"time_filter": "week",
"limit": 25
})
Batch Fetch Posts
execute_operation("fetch_multiple", {
"subreddit_names": ["technology", "programming"],
"limit_per_subreddit": 10,
"time_filter": "day"
})
Deep Dive with Comments
execute_operation("fetch_comments", {
"submission_id": "abc123",
"comment_limit": 200,
"sort": "best"
})
π Project Structure
reddit-research-mcp/
βββ src/
β βββ server.py # FastMCP server
β βββ config.py # Reddit configuration
β βββ chroma_client.py # Vector database proxy
β βββ resources.py # MCP resources
β βββ models.py # Data models
β βββ tools/
β βββ search.py # Search operations
β βββ posts.py # Post fetching
β βββ comments.py # Comment retrieval
β βββ discover.py # Subreddit discovery
βββ tests/ # Test suite
βββ reports/ # Example reports
βββ specs/ # Architecture docs
π Contributing & Tech Stack
This project uses:
- Python 3.11+ with type hints
- FastMCP for the server framework
- Vector search via authenticated proxy (Render.com)
- ChromaDB for semantic search
- PRAW for Reddit API interaction
Stop guessing. Start knowing what your market actually thinks.
GitHub β’ Report Issues β’ Request Features
reddit-research-mcp
pip install reddit-research-mcp
Related Servers
ai.shawndurrani/mcp-registry
Search the public MCP Registry; discover servers and copy SSE URLs.
ai.smithery/IlyaGusev-academia_mcp
Search arXiv and ACL Anthology, retrieve citations and references, and browse web sources to accelβ¦
ai.smithery/aamangeldi-dad-jokes-mcp
Get a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for reβ¦