Reddit MCP Server
Allows to search, browse, and analyze Reddit content in real-time. Provides tools for searching subreddits, full-text search, reading comments, getting post details, subreddit info, and analyzing business opportunities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Reddit MCP Server find business opportunities in r/Entrepreneur"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reddit MCP Server
Your AI, plugged into Reddit. No API key. No login. Just the raw feed.
Give Claude — or any MCP client — real-time access to Reddit: browse subreddits, pull comment threads, mine startup ideas and pain points. Built on FastMCP and Playwright, it scrapes the public web interface with a fast, headless browser. The result: live Reddit data, straight from the source, with zero setup cost.
You: "What are people complaining about in r/SaaS this week?"
AI: ▸ 214 posts scanned · 37 pain points found · score 1260 "Paying for
overpriced subscriptions is ridiculous" · 8 ideas over 1000 pointsWhat's inside
🔍 Search & browse — scan one or many subreddits with native sorting, time filters and keyword filtering
💬 Comments & details — threaded comment trees with authors, scores and depth, plus full post bodies
📊 Subreddit & user intel — description, active users, top posts; any user's public posts and karma
🚀 Business opportunity radar — scores posts for startup/pain-point potential (see the algorithm)
⚡ Built for speed — one shared browser reused across calls, an in-memory TTL cache, asset blocking, retries with backoff, anti-bot detection
Related MCP server: MCP Reddit Server
Table of Contents
10-second demo
Ask your assistant in plain language — it speaks MCP natively:
"Search Reddit for 'best mechanical keyboard 2025' from the last month."
{
"total_results": 25,
"query": "best mechanical keyboard 2025",
"posts": [
{
"title": "The Keychron Q3 is criminally underrated",
"score": 812,
"num_comments": 143,
"author": "keeblover42",
"url": "https://www.reddit.com/r/MechanicalKeyboards/comments/...",
"post_type": "self"
}
]
}"Analyze r/SaaS and r/Entrepreneur for startup pain points."
{
"total_posts_scanned": 214,
"high_score_ideas": 8,
"ideas": [
{
"title": "Paying for overpriced subscriptions is ridiculous — someone should make a smart subscription manager",
"opportunity_score": 1260,
"matched_keywords": ["pay", "subscription", "should exist", "problem"],
"url": "https://www.reddit.com/r/SaaS/comments/..."
}
]
}Available Tools
Tool | Parameters | Description |
|
| Browse posts from specific subreddits with sorting. |
|
| Perform a global keyword search across Reddit. |
|
| Extract threaded comments with hierarchical depth. |
|
| Get full details: selftext, link, flair, metadata. |
|
| Name, description, active users and top posts. |
|
| Browse a user's public posts and karma. |
|
| Get the current top posts of |
|
| Identify high-potential SaaS/startup pain points. |
| — | Verify the server is alive (no network access). |
Quick Start
git clone https://github.com/Simonc44/Reddit-MCP-Server.git
cd Reddit-MCP-Server
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium # one-time browser downloadThat's it — the server is ready. Point your MCP client at python /path/to/server.py.
Client Configuration
Claude Desktop
Add to claude_desktop_config.json (use absolute paths):
{
"mcpServers": {
"reddit-mcp": {
"command": "/path/to/your/virtualenv/bin/python",
"args": ["/path/to/reddit-mcp-server/server.py"]
}
}
}Windows: use double backslashes in your paths.
Claude Code
claude mcp add reddit-mcp -- python /path/to/reddit-mcp-server/server.pyOpportunity Scoring Algorithm
$$Score = (Upvotes \times 2) + (Comments \times 3)$$
With multipliers and bonuses:
High engagement — comments/upvotes ratio $> 0.3$ → ×1.3 (or ×1.15 if $> 0.15$)
Monetization keywords — $+15$ per match (
pay,subscription,SaaS,pricing, …)Pain-point keywords — $+20$ per match (
problem,frustrated,broken,wish,hate, …)Dual-category bonus — both categories detected → overall ×1.25
Keyword matching respects word boundaries (pay matches paying, not paywall), and every idea includes its matched_keywords so the AI can explain its reasoning.
Configuration
Every knob is an environment variable — no code changes needed:
Variable | Default | Description |
|
| Run Chromium headless ( |
|
| Browser viewport. |
| modern Chrome UA | User-agent sent to Reddit. |
|
| Navigation timeout (ms). |
|
| Content wait timeout (ms). |
|
| Pause (s) between subreddit requests — be polite to Reddit. |
|
| Scroll iterations to trigger lazy-loaded content. |
|
| Retry attempts per page load (exponential backoff). |
|
| Base backoff (s) between retries. |
|
| TTL (s) of the in-memory cache for listings ( |
|
| Log level ( |
Development
uv sync --extra dev # reproducible env in .venv/ (uv is optional — pip works too)
make lint # ruff
make typecheck # mypy (server + tests)
make test # pytest — 133 offline unit tests
make coverage # pytest + coverage gate (100 %)
make test-live # live tests against real reddit.com (needs Chromium)
make run # start the MCP serverTests are a first-class citizen here:
tests/test_server.py,tests/test_scraper.py,tests/test_browser.py— 133 offline tests using fake Playwright objects: 100 % coverage, no browser, no network.tests/test_integration.py— live end-to-end tests against the real Reddit website (opt-in:REDDIT_LIVE_TESTS=1 pytest -m integration).
CI (.github/workflows/ci.yml) runs ruff, mypy and the coverage gate on Python 3.10–3.12, plus an opt-in live job.
Docker
docker build -t reddit-mcp-server .
docker run -i --rm reddit-mcp-serverChromium is installed inside the image, and the server runs as an unprivileged user.
Troubleshooting & Limitations
Rate limits & IP blocks — heavy scraping can trigger Reddit's anti-bot (HTTP 429 / login redirects). The server retries with backoff and detects them; increase
REDDIT_REQUEST_DELAYif you get blocked.Dynamic DOM — this is a scraper, not an API: if Reddit changes its frontend, selectors may break. The live test suite exists to catch exactly that — run it before opening an issue.
Member counts — Reddit's anonymous UI no longer exposes a subreddit's total member count;
get_subreddit_inforeturnsmembers: nullwhen unavailable (other stats come from the structured page header and are reliable).Speed — first call of a session launches Chromium (5–30 s); subsequent calls reuse the shared browser and cache.
No private auth — public-facing pages only; no account login.
Contributing
Contributions are very welcome — improving selectors, adding tools, refining docs. See CONTRIBUTING.md.
Security
Found a vulnerability? Report it privately — see SECURITY.md.
License
MIT © 2026 Simon Chusseau
Available Tools
9 toolsanalyze_opportunitiesA
Scan subreddits for business opportunities (SaaS/startup pain points).
Scores posts with: popularity (upvotes), engagement (comments) and semantic relevance (monetization + pain-point keywords). See README for the formula.
Inputs: sort, limit, keywords, min_score, +2 more. Returns: object
get_post_commentsA
Extract the threaded comments of a Reddit post.
Inputs: post_url (required), limit. Returns: object
get_post_detailsA
Get the full content of a Reddit post: title, author, score, selftext, flair and metadata.
Inputs: post_url (required). Returns: object
get_subreddit_infoA
Get public info about a subreddit: description, stats and top posts.
Stats are read from the structured shreddit-subreddit-header element
(name, description, active users). Note: Reddit's anonymous UI no longer
displays the total member count, so members is only populated when the
current subreddit appears in the sidebar "Top communities" list.
Inputs: subreddit (required). Returns: object
get_trending_postsA
Get the currently trending posts across Reddit (r/popular).
Inputs: limit, time_filter. Returns: object
get_user_postsB
Browse the public posts of a Reddit user.
Inputs: username (required), sort, limit. Returns: object
health_checkA
Check that the server is alive and ready to scrape.
Returns: A dict with the server status and version.
Inputs: no named parameters. Returns: object
search_redditB
Browse posts from one or more subreddits, optionally filtered by keywords.
Inputs: subreddits (required), sort, limit, keywords, +1 more. Returns: object
search_reddit_queryB
Search Reddit by keywords through the search page.
Inputs: query (required), sort, limit, subreddit, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools are clearly separated by resource and action, but search_reddit and search_reddit_query overlap heavily in purpose and are easy to confuse. The rest of the tools, such as get_post_details and get_subreddit_info, are distinct.
Tool names mostly follow a consistent verb_noun pattern like get_post_details and get_user_posts. search_reddit_query is an awkward exception and health_check is more of a utility, but the overall naming is still readable and predictable.
Nine tools is a well-scoped count for a Reddit browsing and analysis server. Each tool has a clear role, and the number feels neither bloated nor too sparse.
The server covers the main read-only Reddit workflows: posts, comments, subreddits, users, search, and trending content. Minor gaps like explicit subreddit post listing or user comments exist, but they are not likely to block typical agent tasks.
Maintenance
Related MCP Connectors
Query Reddit communities, posts, brands and trends from your AI agent. OAuth 2.1.
Reddit posts, comments, keyword search and historical archives as tools. Runs on Apify.
Scrape subreddits, discussions & comments and score B2B buyer-intent leads on Reddit.
Search, monitor and measure Reddit posts and comments. Previews work with no API key.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.66,037 npm895MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Reddit by searching subreddits, retrieving hot posts, and fetching detailed post information with comments through the Reddit API.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search, read, and analyze Reddit content, including posts, comments, subreddits, and user profiles using natural language commands. It provides atomic tools for interacting with the Reddit API to retrieve trending topics and community metadata.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to browse Reddit, analyze stock buzz, and detect trending stocks with intelligent context analysis.MIT