MCP.Market

Reddit Ads MCP server

by mharnett·io.github.mharnett/reddit-ads·v1.0.1·3 stars
No reviews yet

Reddit Ads MCP: campaigns, ad groups, ads, reporting, and audience targeting.

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

full report

Adoption
Growing

3 stars77 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 (18, 6 write)

write = sends, deletes, buys or posts

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

  • reddit_ads_create_adwrite action

    Create a new Reddit ad within an ad group. Created as PAUSED by default.

  • reddit_ads_create_ad_groupwrite action

    Create an ad group within a campaign. Created as PAUSED by default.

  • reddit_ads_create_campaignwrite action

    Create a new Reddit ad campaign. Created as PAUSED by default for safety.

  • reddit_ads_enable_items

    Enable (unpause) one or more campaigns, ad groups, or ads.

  • reddit_ads_get_accounts

    List all Reddit ad accounts accessible to this user.

  • reddit_ads_get_ad_groups

    List ad groups for a Reddit ad account, optionally filtered by campaign.

  • reddit_ads_get_ads

    List ads for a Reddit ad account, optionally filtered by ad group.

  • reddit_ads_get_campaigns

    List all campaigns for a Reddit ad account.

  • reddit_ads_get_client_context

    Get a quick overview of the Reddit Ads account. Returns account info and active campaign count.

  • reddit_ads_get_daily_performance

    Get daily performance breakdown for the last N days. Convenience tool with date breakdown.

  • reddit_ads_get_interest_categories

    Get available interest categories for ad group targeting.

  • reddit_ads_get_performance_report

    Get a performance report for Reddit ads. Spend values are in microcurrency (divide by 1,000,000 for dollars).

  • reddit_ads_pause_items

    Pause one or more campaigns, ad groups, or ads.

  • reddit_ads_search_geo_targets

    Search geographic targeting options (countries, regions).

  • reddit_ads_search_subreddits

    Search for subreddits to use as targeting in ad groups.

  • reddit_ads_update_adwrite action

    Update an existing ad. Only pass fields you want to change.

  • reddit_ads_update_ad_groupwrite action

    Update an existing ad group. Only pass fields you want to change.

  • reddit_ads_update_campaignwrite action

    Update an existing Reddit campaign. Only pass fields you want to change.

Public scan report

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

no findings
  • Code scan11 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 19 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,255 servers
Tools
18
the typical server has 7
Tools that change things
33%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 80% of 28,688 servers
Downloads a week
77
more than 56% of 12,191 servers with a package

What its tools let an agent do: 12 read · 6 change

Install Reddit Ads in Claude Code, Cursor or VS Code

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

claude mcp add reddit-ads -- npx -y mcp-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-reddit-ads

MCP server for Reddit Ads API v3 -- campaign management, ad creation, performance reporting, and audience targeting via Claude.

Features

  • 18 tools covering full CRUD for campaigns, ad groups, and ads
  • Performance reports with daily breakdowns
  • Subreddit, interest, and geographic targeting
  • Bulk pause/enable operations
  • Safe by default: all new entities created in PAUSED status
  • Budget inputs in dollars (auto-converts to Reddit's microcurrency format)

Installation

npm install mcp-reddit-ads

Or clone the repository:

git clone https://github.com/mharnett/mcp-reddit-ads.git
cd mcp-reddit-ads
npm install
npm run build

Configuration

Security: Never share your .mcp.json file or commit it to git -- it may contain API credentials. Add .mcp.json to your .gitignore.

1. Reddit OAuth App

Create a Reddit OAuth app at reddit.com/prefs/apps:

  • Select "script" type
  • Note the client ID and client secret
  • Obtain a refresh token with adsread adsedit read scopes

2. Environment Variables

Set credentials via environment variables:

Read-only by default

As of v1.1.0 the MCP starts in read-only mode. The 10 read/report/targeting tools are always exposed, but the 8 mutating tools (create/update campaigns, ad groups, ads, and bulk pause/enable) are hidden from the tool list and refused at call time unless REDDITADSMCP_WRITE=true is set in the server's environment. This guards against a casual chat message accidentally mutating live ad spend. Enable writes deliberately, for the sessions where you actually intend to ship changes.

3. Config File

Copy config.example.json to config.json and fill in defaults:

{
  "reddit_api": {
    "base_url": "https://ads-api.reddit.com/api/v3",
    "auth": {
      "client_id": "",
      "client_secret": "",
      "refresh_token": "",
      "user_agent": "reddit-ad-mcp/1.0"
    }
  },
  "defaults": {
    "account_id": "",
    "business_id": "",
    "report_metrics": ["impressions", "clicks", "spend", "ctr", "cpc", "ecpm"],
    "date_range_days": 7
  }
}

Environment variables take precedence over config file values.

Usage

Claude Code (.mcp.json)

{
  "mcpServers": {
    "reddit-ads": {
      "command": "node",
      "args": ["/path/to/mcp-reddit-ads/dist/index.js"],
      "env": {
        "REDDIT_CLIENT_ID": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_CLIENT_ID -w)",
        "REDDIT_CLIENT_SECRET": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_CLIENT_SECRET -w)",
        "REDDIT_REFRESH_TOKEN": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_REFRESH_TOKEN -w)"
      }
    }
  }
}

Claude Desktop: Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows).

Tools

Context

Read

Write: Campaigns

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_SECRET, REDDIT_REFRESH_TOKEN.
Is Reddit Ads maintained?
The last commit was 56 days ago (2026-09-09). The latest release is v1.0.1.
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,255 servers); tools 18 (the typical server has 7); tools that change things 33% (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

More from mharnett →