Back to Blog
AutomationApr 1, 202613 min read

How to Automate Reddit Ads with Claude AI and MCP — Subreddit Intelligence, Community Targeting, and Real Results

NT

Nikhil Tiwari

MCP Playground

📖 TL;DR — Key Takeaways

  • The Reddit Ads MCP server connects Claude directly to your Reddit Ads account via the Reddit Ads API v3 — live campaign data, community targeting, and performance reports via natural language
  • Reddit's eCPM averaged $2.29 in Q4 2024 versus Meta's $11.73 — significantly lower cost per thousand impressions with highly engaged niche audiences
  • Subreddit-level targeting is Reddit's most powerful differentiator — MCP lets Claude break down which communities are actually converting, not just driving impressions
  • Community-built servers on GitHub cover the Reddit Ads API v3 — no managed integration like Composio exists yet; setup requires a Reddit developer app and OAuth token
  • Reddit's native formats — Free-form Ads, Interactive Ads, and Carousel Ads — perform very differently by community and are hard to compare manually without Claude's help

⚠️ Community-Built Tools — Not Official Reddit Products

The MCP servers covered in this guide are built by independent developers — not by Reddit Inc. They connect via Reddit's public Ads API v3 but are independently maintained and not affiliated with, endorsed by, or supported by Reddit. Always review the source code and terms before connecting a production ad account.

Most platforms optimise for reach. Reddit optimises for relevance — and that changes everything about how you run paid media there.

On Meta or Google, your ad appears to a user profile. On Reddit, your ad appears inside a community. The same creative shown in r/personalfinance and r/wallstreetbets will perform completely differently — same audience age range, wildly different intent and culture. Getting this wrong means spending money on impressions from communities that will never convert.

The other thing Reddit does differently is comments. Promoted posts on Reddit get real organic comments — upvotes, replies, and the occasional brutal community verdict on your ad. That feedback is visible to every subsequent viewer and can make or break a campaign in a niche community.

The advertisers winning on Reddit in 2026 aren't the ones with the biggest budgets. They're the ones who understand which subreddits fit their product, which ad formats feel native to each community, and how to move budget quickly based on community-level signals — not just account-level ROAS. That's exactly what the Reddit Ads MCP server enables with Claude.


What Is the Reddit Ads MCP Server?

The Reddit Ads MCP server implements the Model Context Protocol — the open standard that lets AI models connect to external tools and data sources with live, authenticated access.

It connects Claude to the Reddit Ads API v3, giving it direct access to your campaigns, ad groups, ads, and performance reports. Ask which subreddits are converting — Claude queries live data. Ask how your video ads are performing compared to carousel — Claude pulls the comparison immediately. Ask to pause an underperforming ad group — Claude executes it.

What makes Reddit data uniquely hard to work with manually is its layered targeting. A single campaign might be running across 15 different subreddits, three ad formats, and two bidding strategies simultaneously. Identifying exactly where performance is coming from — and where money is being wasted — requires cross-referencing multiple dimensions in Reddit's Ads Manager. Claude with an MCP connection turns that into a single prompt.

📊 Community-Level Data

Break performance down by subreddit — not just account or campaign level

🎯 Campaign Control

Read campaigns, ad groups, and ads — pause or update via write-capable servers

💰 Cost Advantage

eCPM of $2.29 vs Meta's $11.73 — query where that spend is actually going

💬 Natural Language

Ask in plain English — Claude handles API calls, data synthesis, and recommendations


Server Options Compared

Unlike Meta or TikTok Ads, there is no managed Reddit Ads MCP integration yet (Composio only covers Reddit's organic API, not the Ads API). The current options are community-built open-source servers on GitHub — two are actively maintained.

1. sbmeaper/reddit-ad-mcp (Python)

Language: Python
Access: Read-only
API: Reddit Ads API v3
Cost: Free (open source)
Auth: Reddit OAuth (developer app)
Source: GitHub

Python-based MCP server connecting Claude to the Reddit Ads API v3. Covers campaign, ad group, ad, and reporting endpoints. Read-only — useful for performance analysis, auditing, and reporting workflows without risk of unintended changes.

Best for: Python-comfortable teams who want fast setup and read-only access for daily performance analysis.

2. mkerchenski/RedditAdsMcp (C# / .NET)

Language: C# / .NET 10
Access: Read-only
API: Reddit Ads API v3
Cost: Free (open source)
Auth: Reddit OAuth (developer app)
Source: GitHub

Built with the official ModelContextProtocol SDK and .NET 10. Exposes read-only tools for campaigns, ad groups, ads, and performance reports. Also listed on PulseMCP.

Best for: .NET shops or Windows-first teams who want an MCP server built on the official SDK.

Before committing to any setup: You can explore how MCP servers work and inspect their tool list at MCP Playground — paste any MCP server URL and run live requests in your browser, no install needed.


Tool Surface — What Claude Can Access

Reddit Ads MCP servers expose tools across Reddit's three-level campaign hierarchy — campaigns, ad groups, and ads — plus reporting. The Reddit Ads API v3 structures access around these resources:

Campaign Management

ToolWhat It Does
get_campaignsList all campaigns with status, objective, budget, and spend
get_campaignFull details for a specific campaign — budget type, objective, schedule
update_campaignModify budget, status, or campaign name (write servers only)

Ad Group Operations

ToolWhat It Does
get_ad_groupsRetrieve ad groups with targeting config — subreddits, interests, keywords, bids
get_ad_groupFull targeting and bidding configuration for a specific ad group
update_ad_groupAdjust bid, budget, targeting, or delivery status (write servers only)

Ad Management

ToolWhat It Does
get_adsList all ads with format type, headline, call-to-action, and status
get_adFull creative specs and delivery details for a specific ad
update_adModify ad status or creative reference (write servers only)

Performance Reporting

ToolWhat It Does
get_reportPull performance data at campaign, ad group, or ad level — impressions, clicks, CTR, CPC, CPM, spend, conversions, ROAS — with custom date ranges

Setup: Connecting Claude to Reddit Ads

Both servers require a Reddit developer app and an OAuth access token with Ads API permissions. Here's the path:

  1. Go to reddit.com/prefs/apps and create a new app (type: script)
  2. Note your client_id and client_secret
  3. Request Reddit Ads API access at business.reddithelp.com — API v3 has removed the previous whitelist requirement
  4. Generate an OAuth token scoped to ads:read (and ads:manage if you want write access)
  5. Clone your chosen server, configure the token as an environment variable, and add it to your MCP client config

For Claude Desktop, your claude_desktop_config.json entry will look similar to:

{
  "mcpServers": {
    "reddit-ads": {
      "command": "python",
      "args": ["/path/to/reddit-ad-mcp/server.py"],
      "env": {
        "REDDIT_CLIENT_ID": "<your_client_id>",
        "REDDIT_CLIENT_SECRET": "<your_client_secret>",
        "REDDIT_ACCESS_TOKEN": "<your_access_token>",
        "REDDIT_AD_ACCOUNT_ID": "<your_account_id>"
      }
    }
  }
}

Workflow 1: Morning Performance Audit

The same habit that works on Meta and TikTok works here — but Reddit's campaign data has a layer most advertisers skip: which ad groups are targeting which communities, and whether budget allocation reflects actual community-level performance.

Prompt:

"Pull yesterday's performance for all active campaigns. Show me spend, impressions, clicks, CTR, and CPC. Flag any ad group that spent more than $50 with a CTR below 0.3% or CPC above $4."

Claude calls get_campaigns, get_ad_groups, and get_report in sequence, then applies your threshold filters and returns a prioritised list — in under 30 seconds, without opening Ads Manager.


Workflow 2: Subreddit Breakdown Analysis

This is Reddit's killer feature — and it's the one most advertisers under-use. Two ad groups running the same creative with the same bid can have completely different CPCs because one is targeting r/SaaS and the other is targeting r/entrepreneur. The communities have different saturation, different user intent, and different attitudes toward ads.

Prompt:

"Show me performance broken down by subreddit targeting across all ad groups for the last 14 days. Rank by CPC ascending and flag any community with more than 1,000 impressions but zero clicks."

Claude fetches ad group targeting configuration and cross-references it with report data — surfacing exactly which communities are worth doubling down on and which are burning budget on the wrong audience. This analysis typically takes 45 minutes in Ads Manager. It takes 90 seconds with Claude.

Try it first: Before running this on your own account, test the Reddit Ads MCP server's reporting tools at MCP Playground to see exactly what data comes back from get_report — no setup needed.


Workflow 3: Ad Format Comparison

Reddit supports meaningfully different ad formats — Image Ads, Video Ads, Carousel Ads, and Free-form Ads (Reddit's unique long-form native format). Free-form Ads look like real posts with headings, body text, and embeds — they feel native enough that engaged communities respond to them differently than to a standard banner-style image ad.

Prompt:

"Compare performance by ad format across the last 30 days. Show me CTR, CPC, and total spend for image ads, video ads, carousel ads, and free-form ads. Which format has the lowest CPC in our top three subreddits?"

Claude pulls get_ads to identify format types, then calls get_report with ad-level granularity and groups the output by format. The cross-subreddit cut is what's hard to do manually — Claude does it in one pass.


Workflow 4: Budget Shift by Community

Once you know which subreddits are converting, the obvious next move is to shift budget toward them. On read-only servers, Claude builds a reallocation recommendation you execute manually. On write-capable servers, Claude can make the changes directly after you confirm.

Prompt (read-only):

"Look at the last 7 days. Identify ad groups where CPC is under $1.50 and CTR is above 0.5%. Then identify ad groups spending over $30/day with CPC above $3. Give me a reallocation plan — move budget from the underperformers to the top three."

Claude returns a table showing current daily budget, recommended budget, and expected CPC impact based on recent performance — a concrete decision you can approve and action in Ads Manager in under 5 minutes.


Workflow 5: Keyword vs Community Targeting Comparison

Reddit offers two primary targeting approaches: community targeting (show ads in specific subreddits) and keyword targeting (show ads when people use specific words in post titles and comments). Most campaigns run both — but rarely compare them properly.

Prompt:

"I have ad groups using community targeting and others using keyword targeting for the same product. Compare their CTR, CPC, and conversion rate over the last 30 days. Which approach is delivering better results and by how much?"

Claude reads ad group configuration to classify each by targeting type, then pulls report data for each group and produces the comparison side-by-side. This directly informs whether to consolidate budget into community targeting, keyword targeting, or keep both based on actual data — not gut feel.


What Claude Cannot Do

  • Read organic post comments on promoted posts — the Ads API does not expose comment sentiment or upvote counts on your promoted posts. You need to check those directly in Reddit.
  • Create new campaigns or ads — current community servers are read-only. Write operations (creating campaigns, launching new ads) aren't implemented yet in the publicly available servers.
  • Access Reddit's audience insights tool — Reddit's Ads Manager has an audience builder with interest and demographic data that isn't exposed through the Ads API v3.
  • Run Interactive Ad or First View reporting separately — premium formats don't always appear as a separate dimension in the reporting API.
  • Replace your judgment on community fit — Claude can tell you which subreddits are converting based on data, but deciding whether your product belongs in a community requires reading that community yourself.

Combining with Other MCP Servers

Reddit Ads MCP works best alongside other ad platform servers when you're running cross-channel campaigns. A few useful combinations:

Reddit + Meta Ads

Compare CPC and CTR across both platforms for the same creative — identify where your budget works harder

Reddit + Google Ads

Reddit drives top-of-funnel awareness in niche communities; Google captures the intent it generates — compare assisted conversions

Reddit + GitHub MCP

Developer-tool advertisers: correlate Reddit ad performance with GitHub repo traffic — see if ad spend is driving real developer interest


Getting Started Today

Reddit Ads MCP is earlier-stage than Meta or TikTok integrations — there's no managed option yet, and setup requires a Reddit developer app. But the data surface is real, the API is public, and the two community servers are functional.

  1. Create a Reddit developer app at reddit.com/prefs/apps
  2. Apply for Reddit Ads API v3 access at business.reddithelp.com
  3. Clone sbmeaper/reddit-ad-mcp (Python) or mkerchenski/RedditAdsMcp (.NET)
  4. Configure credentials as environment variables and add to your MCP client config
  5. Start with the Morning Performance Audit prompt — it's read-only and gives you immediate value

Want to understand MCP before setting it up?

MCP Playground lets you connect any MCP server in your browser — no install, no config — and run live tool calls to see exactly what data comes back.

Further Reading

NT

Written by Nikhil Tiwari

15+ years in product development. AI enthusiast building developer tools that make complex technologies accessible to everyone.