MCP.Market

Reddit Ads MCP server

by camlowe·io.github.camlowe/mcp-server-reddit-ads·v0.5.5·1 stars
No reviews yet

Reddit Ads API v3: campaigns, ad groups, ads, reports, plus working writes with safety tiers.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

1 stars36 downloads/wk

Reviews

Write one

Nobody has reviewed Reddit Ads yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Reddit Ads tools (30, 9 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compare_ads

    Per-ad performance within one ad group, joined with each ad's name and creative headline and

  • compare_periods

    Compare account performance over the trailing N days against the N days immediately before

  • copy_ads

    Duplicate a set of ads into another ad group. Each copy is created PAUSED. Reddit creates a new

  • create_adwrite action

    Create an ad. Always created PAUSED. Either promote an existing post (post_url) or build a link ad

  • create_ad_groupwrite action

    Create an ad group. Always created PAUSED. A conversion pixel id is required (Reddit mandate since

  • create_campaignwrite action

    Create a campaign. Always created PAUSED. If campaign budget optimization is on, a conversion

  • enable_items

    Resume delivery on one or more entities of a single type (set configured_status ACTIVE). This

  • find_entity

    Find campaigns, ad groups, or ads by name (case-insensitive substring match). Use this to turn a

  • get_account_overview

    One-glance health of an account: campaign/ad-group/ad counts by effective status, and this-week

  • get_accounts

    List every Reddit ad account these credentials can reach, across all businesses. Use this

  • get_ad

    Get one ad by id: status, ad group, and click-through URL, but not the creative copy. Use

  • get_ad_creative

    Read the creative behind an ad: headline, body text, media, thumbnail, and post URL. The creative

  • get_ad_group

    Get one ad group by id, with budget and bid fields in USD. This is where budget, bid, and

  • get_ad_groups

    List ad groups in an account, optionally filtered to one campaign, with budget and bid

  • get_ads

    List ads in an account, optionally filtered to one ad group. Returns ad records only, not

  • get_campaign

    Get one campaign by id, with budget fields converted to USD. Use get_campaigns to browse or

  • get_campaigns

    List all campaigns in a Reddit ad account, with budget fields converted to USD (*_usd siblings).

  • get_daily_performance

    Day-by-day performance for the trailing N days, broken down by date, with money metrics in

  • get_interest_categories

    List Reddit's interest targeting categories. Returns the ids to pass as interests to

  • get_performance_report

    Performance totals for an ad account over a date window. Accepts friendly lowercase metric names

  • get_server_status

    Diagnose the server: Reddit Ads API connectivity, configured write tier, how many tools that tier

  • pause_items

    Pause one or more entities of a single type (campaigns, ad groups, or ads), stopping their spend.

  • search_geo_targets

    Search geographic targets (countries, regions, and metros) by name. Returns the ids to pass

  • search_subreddits

    Search targetable subreddits (communities) by name or keyword. Returns the ids to pass as

  • update_ad_commentswrite action

    Turn commenting on an ad's promoted post on or off. This is the only property of a post the Reddit

  • update_ad_urlwrite action

    Change an existing ad's click-through URL. Pass a full replacement click_url, or set_query_params

  • update_bidwrite action

    Set an ad group's bid in USD, echoing the previous and new value. Overwrites the prior bid

  • update_budgetwrite action

    Set an ad group's daily spend budget in USD, echoing the previous and new value. Overwrites

  • update_namewrite action

    Rename one entity (campaign, ad group, or ad). Cosmetic only: delivery, budget, and

  • update_targetingwrite action

    Update an ad group's targeting. Only the fields you pass are changed; every other targeting key

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan49 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 17 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Reddit Ads compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,273 servers
Tools
30
the typical server has 7
Tools that change things
30%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,534 servers
Downloads a week
36
more than 28% of 11,915 servers with a package

What its tools let an agent do: 20 read · 3 create · 7 change

Install Reddit Ads in Claude Code, Cursor or VS Code

Runs npx -y mcp-server-reddit-ads on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-server-reddit-ads -- npx -y mcp-server-reddit-ads
Add to Cursor

What the publisher says

From the Reddit Ads repository's README, as published. We do not edit it. Read it on GitHub

MCP Server for Reddit Ads (mcp-server-reddit-ads)

A Reddit Ads API v3 MCP server with working write operations and tiered safety controls, built and dogfooded by an actual Reddit advertiser. It gives an MCP client read access to campaigns, ad groups, ads, and performance reports, plus gated write tools for pausing, creating, budget and bid changes, targeting edits, and copying ads between ad groups.

Requirements

  • A Reddit Ads account, with business-admin access so you can register an app.
  • Node.js 20 or newer.
  • An MCP client (Claude Code, Claude Desktop, or any other).

Getting started

Pick the path that matches your setup: a paste-one-prompt route for Claude Code or Claude Desktop, or the manual steps for any other client. Every path installs read-only and cannot change anything in your account until you deliberately turn on writes (the last step).

Simple setup with Claude Code (recommended)

If you use Claude Code, let it do the mechanical work. Copy this whole prompt and paste it into Claude Code:

Set up the mcp-server-reddit-ads MCP server for me so I can manage my Reddit Ads
account from here. Install it read-only for now - no write access. Please:

1. Read the setup instructions at https://github.com/camlowe/mcp-server-reddit-ads
2. Check I'm on Node.js 20 or newer.
3. Walk me through registering a Reddit app, since only I can do that part. Tell me
   exactly where to click and which two values (client ID and client secret) to copy.
4. Run `npx mcp-server-reddit-ads auth` and guide me through the browser login.
5. Add the server to my .mcp.json using the credentials from the auth step, with the
   write tier set to read-only.
6. Confirm the server loads and list my Reddit ad accounts to prove it works.

Do not enable any write access yet. I'll ask for that later when I'm ready.

Claude reads this README, tells you exactly what to do for the parts only you can do, runs npx mcp-server-reddit-ads auth, writes your .mcp.json, and confirms the server loads. Later, when you want to make changes, just ask it to raise the write tier.

Simple setup with Claude Desktop

Claude Desktop can't run terminal commands for you, so this prompt has it act as a patient guide while you run one command and edit one config file. Paste it into a new Claude Desktop chat:

I want to set up the mcp-server-reddit-ads MCP server so I can manage my Reddit Ads
account with you. I'm not a developer, so please guide me one step at a time with
simple, copy-pasteable instructions, and wait for me to confirm each step before
moving to the next.

Look up the setup details at https://github.com/camlowe/mcp-server-reddit-ads. The
main steps are: register a Reddit app to get a client ID and secret, run a one-time
`npx mcp-server-reddit-ads auth` command in my terminal to log in, and add the server
to my Claude Desktop config file. Set it up read-only so nothing in my account can
change until I decide to turn writes on.

Either way, you still register the Reddit app (step 1 below) and approve the browser login yourself - those cannot be automated.

Advanced setup (manual)

The full process, for other MCP clients or if you prefer to do it by hand. It takes about five minutes.

1. Register a Reddit app

  1. Open the Reddit Ads dashboard at ads.reddit.com and sign in with an account that has business-admin access.
  2. Open Business settings (the gear / settings menu, top right), then Developer Applications, then Create App.
  3. Give the app a name, set the redirect URI to exactly http://localhost:8080, and choose a primary contact (a business admin). Save it.

Reddit then shows the two values you need in step 2:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Reddit Ads: common questions

Is Reddit Ads MCP server safe?
Mostly: it is graded B (83/100). Read the Reddit Ads safety report
How do I install Reddit Ads?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Reddit Ads need an API key?
Yes. The registry entry asks for REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN.
Is Reddit Ads maintained?
The last commit was 56 days ago (2026-09-07). The latest release is v0.5.5.
What can I use instead of Reddit Ads?
Servers from other publishers that do the same job: AdLoop MCP server.
How does Reddit Ads compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,273 servers); tools 30 (the typical server has 7); tools that change things 30% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Reddit Ads

Same job from other publishers: the closest match first, then the best rated.

  • AdLoop
    Google Ads, Reddit Ads, GA4 and Tag Manager in your AI client, with a preview before every change.
    A