Reddit Marketing Agent

Turn Claude into a careful Reddit marketer. It finds the communities your audience lives in, spots conversations where your product genuinely helps, drafts replies worth upvoting, and publishes only what you approve. Guardrails keep you clear of the things that get accounts and domains banned.

It's an MCP server, so you control it from Claude Code, Claude Desktop, or any MCP client, in plain language:

"Find threads this week where freelancers are asking for invoicing tools, and draft replies for the best three."

What it does

The guardrails (why this won't get you banned)

Reddit punishes undisclosed promotion, link spam and copy-paste posting. The agent blocks:

• Product mentions without an affiliation disclosure ("I built this", "full disclosure: I work on X")

• Promotion in subreddits whose rules ban it

• Link shorteners, duplicate text, replies to locked or archived threads

• Exceeding the daily action cap, posting too fast, or promoting in the same subreddit within the cooldown

It warns about restricted-promo subreddits, too many links, low-effort replies, hype-y titles, and a promotional share above 10% (the classic 9:1 rule). Publishing is off by default and always needs a final confirm=true that Claude is instructed to send only after you approve.

Related MCP server: mcp-reddit-ads

How it works

flowchart LR
    You -->|chat| Claude
    Claude <-->|MCP tools| Agent["reddit-marketing-agent<br/>(this repo)"]
    Agent -->|"API credentials? → OAuth JSON API<br/>none? → public RSS feeds"| Reddit[(Reddit)]
    Agent <--> DB[("~/.reddit-marketing-agent<br/>campaigns · drafts · activity log")]

Two connection modes, picked automatically:

Install

You need uv (curl -LsSf https://astral.sh/uv/install.sh | sh).

Claude Code: as a plugin (tools + playbook skill)

/plugin marketplace add whyujjwal/reddit-marketing-agent
/plugin install reddit-marketing@reddit-marketing-agent

Claude Code: MCP server only

claude mcp add reddit-marketing -s user -- uvx --managed-python --from git+https://github.com/whyujjwal/reddit-marketing-agent reddit-marketing-agent

Claude Desktop

Add this to claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude:

{
  "mcpServers": {
    "reddit-marketing": {
      "command": "uvx",
      "args": ["--managed-python", "--from", "git+https://github.com/whyujjwal/reddit-marketing-agent", "reddit-marketing-agent"]
    }
  }
}

If Claude Desktop can't find uvx, use its full path (run which uvx).

--managed-python makes uv use its own native Python build. Without it, an active Conda or Intel (x86_64) Python on an Apple Silicon Mac can be picked instead, and installing cryptography (a dependency of the MCP SDK) then fails.

From source

git clone https://github.com/whyujjwal/reddit-marketing-agent
cd reddit-marketing-agent
uv sync
uv run reddit-marketing-agent doctor

Opening the cloned folder in Claude Code picks up the bundled .mcp.json automatically.

Configure

It works with zero configuration in rss mode. To unlock more, create a config file:

uvx --managed-python --from git+https://github.com/whyujjwal/reddit-marketing-agent reddit-marketing-agent init

That writes ~/.reddit-marketing-agent/.env (readable only by you). Fill in what you have:

Run reddit-marketing-agent doctor to check the setup.

Getting Reddit API access

As of 2026 Reddit requires approval for new API apps under its Responsible Builder Policy; creating an app at reddit.com/prefs/apps is no longer enough on its own. Request access through Reddit's developer support, describing the use case (personal community engagement, low volume, human-approved posting). Once approved, create a script app and put its id and secret in the config. Until then, rss mode covers research and drafting.

Reddit's Data API Terms and each subreddit's rules apply to you, not to this tool. Read them.

Use it

Just talk to Claude. A typical first session:

1. "Check the reddit status."

2. "Set up a campaign for my product: an invoicing app for freelancers at invoicely.example.com. I'm the founder." Claude interviews you, finds candidate subreddits, checks their promo rules, and calls save_campaign.

3. "Find today's best opportunities and draft replies for the top three."

4. Claude shows each draft verbatim with the thread, why it fits, and the check results. "Publish #2, change #1 to not mention the product, drop #3."

5. "How did this week go?"

Built-in prompts (slash commands in Claude Code, prompt picker in Claude Desktop): Set up a campaign, Daily scout, Weekly report. The plugin also installs the reddit-marketing skill, a playbook Claude follows for choosing threads and writing replies. Every client can read it as the MCP resource reddit-marketing://playbook.

Tools

Terminal commands

reddit-marketing-agent doctor          # check config + connectivity
reddit-marketing-agent drafts          # list pending drafts
reddit-marketing-agent approve 12      # approve draft #12 (for RMA_APPROVAL_MODE=terminal)
reddit-marketing-agent discard 12

Development

uv sync
uv run pytest            # 50 tests, no network needed
uv run ruff check . && uv run ruff format --check .

Layout:

src/reddit_marketing_agent/
  server.py       MCP tools, prompts, playbook resource
  service.py      core logic (campaigns, opportunities, drafts, publishing, reports)
  scoring.py      opportunity scoring heuristics
  guardrails.py   promo-policy detection, draft checks, pacing limits
  store.py        SQLite: campaigns, drafts, activity log, seen mentions
  reddit/         OAuth JSON backend, RSS backend, shared polite HTTP session
skills/reddit-marketing/SKILL.md   the playbook (plugin skill + MCP resource)
.claude-plugin/                    Claude Code plugin + marketplace manifests

PRs welcome, especially better opportunity heuristics, more promo-rule patterns, and support for other platforms.

Built on open source

• MCP Python SDK (MIT): the server framework

• httpx (BSD): HTTP client

• defusedxml (PSF): safe feed parsing

• python-dotenv (BSD): config files

• Prior art worth a look: Hawstein/mcp-server-reddit and Arindam200/reddit-mcp (both MIT) for Reddit read access over MCP, and PRAW (BSD-2), the standard Python Reddit API wrapper. This project adds the marketing workflow, scoring and guardrails on top of Reddit's own API rather than reusing their code.

Disclaimer

Not affiliated with or endorsed by Reddit. You are responsible for how you use it: follow Reddit's User Agreement, its API terms, and every community's rules. The guardrails reduce risk; they don't replace your judgment.

License

MIT