reddit-growth-mcp — Claude Code MCP server: how to install
Plans Reddit submissions, ranks communities by removal risk, and scores post drafts from 0 to 100 using public archives without Reddit API keys.
claude mcp add reddit-growth-mcp -- uvx reddit-growth-mcpWhat reddit-growth-mcp does
The server extracts posting patterns and moderation statistics from Arctic Shift, an open historical archive. It identifies optimal publication windows, effective flair tags, and typical discussion depth for target communities. The core tools run entirely without Reddit accounts or tokens.
Built-in commands let an agent score written drafts, inspect community removal trends, and compare multiple subreddits side by side. It ships with over 40 presets for AI and tech communities. Connecting Reddit API keys through PRAW remains optional, enabling direct searches and live data comparisons.
You need Python 3.11 or newer together with uv on your machine, or the uvx launch command will fail immediately.
What it helps with
- rank target subreddits by community engagement and removal likelihood
- score an unreleased post draft before sharing it publicly
- identify the best posting hours and active flair tags for a subreddit
- evaluate discussion sentiment and comment depth across niche communities
Example prompts for the agent
- Score this draft post for r/LocalLLaMA and highlight acceptance risks
- Compare singularity and mcp subreddits to see which has lower removal rates
- Build a posting schedule for an open-source AI project based on archive data
How to install reddit-growth-mcp
Platform CLI
claude mcp add reddit-growth-mcp -- uvx reddit-growth-mcpuvx runs the command named after the package; if the README names another one, use uvx --from reddit-growth-mcp <command>
Platform CLI
codex mcp add reddit-growth-mcp -- uvx reddit-growth-mcpuvx runs the command named after the package; if the README names another one, use uvx --from reddit-growth-mcp <command>
Config file
{
"mcpServers": {
"reddit-growth-mcp": {
"command": "uvx",
"args": [
"reddit-growth-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from reddit-growth-mcp <command>
Config file
{
"servers": {
"reddit-growth-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"reddit-growth-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from reddit-growth-mcp <command>
Platform CLI
gemini mcp add reddit-growth-mcp uvx reddit-growth-mcpuvx runs the command named after the package; if the README names another one, use uvx --from reddit-growth-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about reddit-growth-mcp
How do I install reddit-growth-mcp in Claude Code?
Run claude mcp add reddit-growth-mcp -- uvx reddit-growth-mcp in your terminal. You must have Python 3.11+ and uv installed on your machine.
What does reddit-growth-mcp do?
It provides MCP tools to study subreddit patterns, identify safe posting times, and score draft posts against historical moderation habits.
Are Reddit API credentials mandatory?
No credentials are required for core features. Historical analysis relies on Arctic Shift, while PRAW credentials are only needed for live raw fetches and subreddit discovery.
