Reddit Growth MCP
The Reddit Growth MCP server helps you find where to post, understand subreddit dynamics, and evaluate content before publishing — no Reddit API credentials required for most features.
Discover subreddits: Find and rank subreddits for a given topic by estimated traffic, subscriber count, and daily visitors (requires Reddit credentials).
Analyze subreddit activity: Estimate posts-per-day velocity and activity level from the public archive.
Analyze acceptance/removal rates: Measure how often posts get removed, common removal reasons, and (with credentials) fetch official rules.
Uncover post patterns: Identify what makes posts succeed — optimal timing, title style, media type, flair, and keywords — ranked by score, comments, or discussion depth.
Evaluate a draft post: Score a draft title/body against a subreddit's patterns, predict acceptance risk and engagement potential (0–100), and get actionable improvement suggestions.
Score a draft across multiple subreddits: Compare how one draft fits several subreddits simultaneously, ranked by size-fair percentile fit and raw expected reach.
Compare subreddits: Rank communities by growth potential, viral ceiling, discussion depth, removal risk, and safety — helping you avoid high-removal communities.
Analyze discussion insight: Measure comment substance and depth, plus heuristic sentiment (supportive/mixed/critical).
Build a full growth plan: One-call workflow that picks the safest high-traffic target, lists cross-post options, and returns a viral recipe with best posting times.
Fetch raw posts (requires Reddit credentials): Pull live posts from one or multiple subreddits by listing type (hot/new/top/rising).
Search subreddit posts (requires Reddit credentials): Search posts within a subreddit by keyword and sort order.
Fetch post comments (requires Reddit credentials): Retrieve a post and its full comment tree by URL or submission ID.
Provides tools for analyzing subreddits, post patterns, acceptance rates, growth opportunities, and evaluating draft performance using Reddit data from both the live API and a public historical archive.
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 Growth MCP Plan where to post about AI: analyze r/singularity and r/LocalLLaMA"
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 Growth MCP turns a list of subreddits into a plan — where to post, what to post, and when — by reading each community's format, flair, timing, and keyword recipe from a public historical archive. The whole core workflow runs with no account or API key. It works as an MCP server (for Claude, Cursor, and other MCP clients) and as a standalone command-line tool.
Built by a Top 1% Poster in r/ClaudeAI — the heuristics here encode what actually gets upvoted and what gets removed, not guesswork.
Quick start
Requirements: Python 3.11+ and uv. No Reddit account or API keys are needed to get started.
Install from PyPI:
uvx reddit-growth-mcp # run the MCP server instantly
pipx install reddit-growth-mcp # or install the CLI + server
reddit-growth plan singularity LocalLLaMA mcp # your first growth planOr from a clone (for development):
uv sync # install dependencies
uv run python -m src.cli plan singularity LocalLLaMA mcp # your first growth planThat prints where to post, what to post, and when — using only the public
archive. Every command has the form uv run python -m src.cli <command> [options]
(shown throughout as reddit-growth <command>, which is the installed alias).
Add -h to any command for help, e.g. uv run python -m src.cli plan -h.
If you activate the virtualenv directly (source .venv/bin/activate) and zsh
still reports command not found: reddit-growth, run rehash — zsh caches
command locations at startup and needs a nudge after the venv is added to PATH.
Opening a new terminal also works, or call the binary by path without activating:
.venv/bin/reddit-growth plan singularity LocalLLaMA mcp.
Interactive launcher
Prefer a menu to flags? Run:
bash scripts/menu.shPick a mode (plan, compare, patterns, draft, …), choose subreddits from a
searchable preset list, and it runs the command for you — all in one window.
With gum installed you get an arrow-key
TUI with fuzzy search; otherwise it falls back to a numbered menu. Type h for
a built-in guide.
Related MCP server: Reddit MCP Server
What it answers
Which subreddits fit my topic, and how much reach do they have?
Will my post survive here, or does this community remove a lot of posts?
What actually performs here: which format, title style, timing, and flair?
Given a specific draft, how is it likely to do, and how do I improve it?
See it work
compare ranks candidate subreddits by growth, viral ceiling, discussion, and
removal risk — so you post where you'll be seen and skip communities that remove
most submissions (note r/ClaudeAI below: 96% removed, strict):

patterns reads one community's viral recipe — the media types, hours, days,
flairs, and keywords that actually perform, ranked by median so a single lucky
post can't crown a category:

Figures are live estimates from a sample and shift over time — run the commands yourself for current numbers.
Tools
Tool | Purpose | Needs credentials |
| What performs in a sub: timing, media, title style, flair, keywords, by a configurable metric | No |
| Removal rate and what tends to get removed; official rules when credentials are present | No |
| Rank subreddits by growth (typical reach + viral upside), with traffic (posts/day), discussion, removal risk, and a safety label; | No |
| Discussion depth (comment substance) plus a heuristic sentiment read (supportive/mixed/critical) — not just comment count | No |
| One call: safest strong target, cross-post options, viral recipe, and best posting times | No |
| Predict a draft's performance (0-100) and acceptance risk, with drivers and fixes | No |
| Score one draft across subs, ranked by size-fair fit (percentile) vs raw reach | No |
| Estimate a subreddit's activity (posts/day); uses the archive without credentials | No |
| Discover and rank subreddits for topics by estimated traffic | Yes |
| Raw data access | Yes |
The analysis tools are subreddit-agnostic — they work on any archived sub. The
launcher ships 40+ presets across AI, dev, and startup communities (ChatGPT,
DeepSeek, LocalLLaMA, StableDiffusion, SaaS, indiehackers, …).
Data sources
PRAW for live Reddit access (read-only). Requires API credentials.
Arctic Shift (https://github.com/ArthurHeitmann/arctic_shift), a public historical archive and the successor to Pushshift. Requires no credentials.
Removal detection follows the reveddit approach: the archive records what was
posted, and moderator removals are read from that record. When Reddit
credentials are available, analyze_acceptance performs an accurate live diff
(archive vs. current Reddit) to resolve ambiguous cases; without credentials it
runs archive-only and flags its confidence.
Reddit credentials (optional)
Everything above works with no account. Credentials only unlock the
credential-only tools (raw data access, find_target_subreddits_tool) and the
accurate live-removal check. Create a "script" app at
https://www.reddit.com/prefs/apps, then:
cp .env.sample .env
# REDDIT_CLIENT_ID=...
# REDDIT_CLIENT_SECRET=...
# REDDIT_USER_AGENT=reddit-growth-mcp/0.2.1 by u/your_usernameCommand-line usage
Every command runs credential-free from the archive. The commands are:
traffic, insight, patterns, acceptance, compare, plan, report,
draft, and fit (run -h on any of them for options).
uv run python -m src.cli traffic LocalLLaMA
uv run python -m src.cli insight mcp
uv run python -m src.cli patterns Fedora --time month
uv run python -m src.cli patterns commandline --metric discussion
uv run python -m src.cli acceptance technology
uv run python -m src.cli compare Fedora gnome linux
uv run python -m src.cli plan singularity LocalLLaMA mcp --tz 7
uv run python -m src.cli draft ClaudeAI --title "I built an ASCII art tool" --type image
uv run python -m src.cli fit singularity LocalLLaMA mcp --title "..." --type videofit scores one draft across several subreddits and ranks by a size-fair fit
(the draft's percentile within each sub's own score distribution) alongside raw
expected reach, so a small sub where the post lands in the top decile isn't
buried by a big sub's larger absolute numbers.
Add --json to any command for raw output.
Time-based commands (patterns, plan, draft, fit, report) accept
--time day|week|month|year|all — shorter is fresher but a smaller sample.
patterns accepts --metric:
score: upvotes (reach).comments: comment volume.discussion: comments per upvote, a proxy for genuine engagement rather than drive-by upvotes.quality: upvotes damped by a clickbait penalty.
Use as an MCP server
Register the server once (Claude Code shown):
claude mcp add reddit-growth-mcp -- uvx reddit-growth-mcpFor Cline, Cursor, Claude Desktop, and other clients, add it to the MCP
settings JSON (no separate install — uvx fetches it from PyPI):
{
"mcpServers": {
"reddit-growth": {
"command": "uvx",
"args": ["reddit-growth-mcp"]
}
}
}Then ask in natural language, for example "analyze what performs in r/Fedora" or "will this title get accepted in r/linux?" The client calls the tools.
For the full flow in one step, ask for a growth plan ("build a growth plan for
r/singularity, r/LocalLLaMA, r/mcp") to invoke growth_plan, or select the
reddit_growth prompt, which guides the assistant through finding a safe
high-traffic subreddit and crafting a post that fits its viral recipe.
To run the server directly over stdio:
uv run python -m src.serverDocker
The server also ships as a container (stdio transport):
docker build -t reddit-growth-mcp .
docker run -i --rm reddit-growth-mcp
# with credentials:
docker run -i --rm -e REDDIT_CLIENT_ID=... -e REDDIT_CLIENT_SECRET=... reddit-growth-mcpTargeting workflow
To find where to post for growth, compare_subreddits reports, per subreddit:
viral potential (90th-percentile reach adjusted for removal risk) and ceiling,
posts per day (a credential-free traffic proxy),
typical discussion (median comments),
removal rate and a safety label (safe / moderate / strict), so you can avoid communities that remove most posts.
A typical flow: compare to shortlist safe, high-traffic, high-ceiling subs,
then patterns to read the viral recipe, then evaluate_draft to score a draft
against it before posting.
Reach and insight are different goals. compare counts comments (volume);
analyze_insight measures their depth — median comment length and the share
of substantive comments. A sub can have many short one-line replies (high volume,
low insight) or fewer long technical comments (low volume, high insight). Use
reach-oriented ranking for visibility, and analyze_insight to find where
thoughtful discussion happens and reputation is built.
Accuracy and methodology
The tool is built to avoid the common failure modes of naive Reddit analytics.
Robust central tendency. Categories (media, flair, time) are ranked by the median, with the mean shown for reference, so a single viral post cannot crown a category.
Minimum-sample gating. A category or time bucket must contain enough posts to be reported as "best". Small buckets are not treated as reliable signals, and draft scoring ignores title signals whose with/without groups are too small, so a single lucky post cannot swing a projection or seed a bogus suggestion.
Confidence labelling. Each pattern report states a confidence level based on its sample size, and each acceptance report states a reliability level.
Settled scores. Archived scores stabilise after roughly 36 hours, so analysis excludes the most recent two days.
AutoMod awareness. Posts that were only AutoMod-filtered at capture time are treated as uncertain, not confirmed removals, because they are frequently approved later. On AutoMod-heavy subreddits this is flagged, and an accurate live check requires credentials.
Removal-aware verdicts. A draft's acceptance verdict folds in the sub's base removal rate, so a compliant post in a subreddit that removes most of what it gets is flagged risky rather than "likely accepted".
Anti-clickbait. Clickbait titles are detected (hype phrases, shouted words, emoji and punctuation spam), and each report states whether the community actually rewards or penalises clickbait, so guidance never pushes you toward it.
evaluate_draftpenalises a clickbaity draft only where the sub dislikes it.
Limitations
Traffic figures are estimates. Reddit does not expose true daily visitor counts through its public API.
Findings are correlations from a sample, not Reddit's ranking algorithm and not a guarantee of performance.
AutoModerator configuration is private. Karma and account-age gates are inferred from rule text and require credentials to read.
Development
uv sync --extra dev
uv run pytest -q # tests
uv run ruff check src tests # lint
uv run ruff format src tests # formatCI runs the lint, format check, and tests on every push and pull request.
The analysis logic lives in src/analysis/ (traffic, acceptance, patterns,
draft, compare, arctic, helpers). The MCP surface is src/server.py and the
CLI is src/cli.py.
License
MIT
mcp-name: io.github.latent-9/reddit-growth-mcp
Available Tools
8 toolsanalyze_insightARead-only
Measure a subreddit's discussion depth (insight): how substantive its comments are, plus a heuristic sentiment read. No creds needed.
Inputs: subreddit_name (required), after, sample. Returns: object
analyze_subredditARead-only
Estimate a subreddit's activity (posts/day velocity from the archive; subscribers and active users too when credentials are present)
Inputs: subreddit_name (required), sample_size. Returns: object
evaluate_draftARead-only
Evaluate a post draft for acceptance risk and engagement potential
Inputs: title (required), subreddit_name (required), body, flair, +2 more. Returns: object
evaluate_draft_acrossARead-only
Score one draft across several subreddits and rank by normalized fit (size-fair percentile) vs raw reach. No creds needed.
Inputs: title (required), subreddits (required), body, flair, +2 more. Returns: object
fetch_commentsARead-only
Fetch a post with its comment tree
Inputs: url, comment_sort, comment_limit, submission_id. Returns: object
fetch_postsARead-only
Fetch posts from a single subreddit
Inputs: subreddit_name (required), limit, time_filter, listing_type. Returns: object
find_target_subreddits_toolARead-only
Discover and rank subreddits for given topics by estimated traffic
Inputs: topics (required), include_nsfw, limit_per_topic, min_subscribers, +1 more. Returns: object
growth_planARead-only
Build a growth plan from candidate subreddits: pick the safest strong one, list cross-post targets, and return its viral recipe and best posting times. No credentials needed.
Inputs: subreddits (required), window, time_filter. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have clearly distinct purposes (discovery, activity stats, draft evaluation, discussion depth, planning, fetching). However, evaluate_draft and evaluate_draft_across are similar, though differentiated by scope (single vs. multi-subreddit).
The naming pattern is generally verb_noun, but inconsistent: 'find_target_subreddits_tool' includes a redundant '_tool' suffix, and 'analyze_insight' is slightly redundant. Others like 'growth_plan' and 'fetch_posts' follow the pattern better.
With 8 tools, the set is well-scoped for a Reddit growth assistant, covering discovery, analysis, evaluation, planning, and data retrieval without being bloated or too minimal.
The tool surface covers key aspects of Reddit growth analysis (subreddit discovery, activity, draft evaluation, fetching), but lacks a tool to actually post content, which could be considered a missing action for a growth-focused MCP.
Maintenance
Related MCP Connectors
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
Reddit analytics and audience research for AI assistants: find subreddits for a topic, see who is in them, the best time to post, posting rules and Reddit brand mentions. KissMyPost works as a subreddit finder and Reddit marketing tool: subreddit growth and audience stats, similar subreddits, trending topics, Reddit post and mention search, and threads worth a reply. 17 read-only tools. Free API key at kissmypost.com/mcp. Not affiliated with Reddit, Inc.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Reddit API as 69 MCP tools: search, subreddits, posts, comments, users, monitors, writes, feedback.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.71 npm10Apache 2.0
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.15302MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.83-
- FlicenseBqualityCmaintenanceMCP server for compact Reddit research packs. Enables Reddit data extraction, search, and trend analysis through a set of tools like reddit_search and reddit_thread.7-