Claude MarketplacesSubmit

Reddit Ads

mharnett/mcp-reddit-ads

Connects to Reddit's Ads API v3 and exposes 18 tools for managing campaigns, ad groups, and ads. Ships in read-only mode by default. Set REDDIT_ADS_MCP_WRITE=true to unlock mutating operations like creating campaigns or bulk pausing ads. Handles the full CRUD lifecycle plus performance reports with daily breakdowns, subreddit and interest targeting, and geographic filters. Budget inputs accept dollars and auto-convert to Reddit's microcurrency. New entities start paused, so you won't accidentally burn spend. Reach for this when you're managing Reddit advertising programmatically and want Claude to query metrics, draft campaigns, or adjust targeting without switching to the ads dashboard.

GitHub stars: 1
tools: 18
auth: Secret needed
transport: STDIO
env vars: 3
last updated: Apr 8, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

reddit_ads_get_client_contextGet account info and verify API connectivity

Get account info and verify API connectivity

No parameter schema in public metadata yet.

reddit_ads_get_accountsList all ad accounts accessible to the authenticated user

List all ad accounts accessible to the authenticated user

No parameter schema in public metadata yet.

reddit_ads_get_campaignsList campaigns with optional status filter

List campaigns with optional status filter

No parameter schema in public metadata yet.

reddit_ads_get_ad_groupsList ad groups for a campaign

List ad groups for a campaign

No parameter schema in public metadata yet.

reddit_ads_get_adsList ads for an ad group

List ads for an ad group

No parameter schema in public metadata yet.

reddit_ads_get_performance_reportAggregated performance metrics for campaigns/ad groups/ads

Aggregated performance metrics for campaigns/ad groups/ads

No parameter schema in public metadata yet.

reddit_ads_get_daily_performanceDay-by-day performance breakdown

Day-by-day performance breakdown

No parameter schema in public metadata yet.

reddit_ads_create_campaignCreate a new campaign (PAUSED by default)

Create a new campaign (PAUSED by default)

No parameter schema in public metadata yet.

reddit_ads_update_campaignUpdate campaign name, budget, objective, or status

Update campaign name, budget, objective, or status

No parameter schema in public metadata yet.

reddit_ads_create_ad_groupCreate a new ad group with targeting (PAUSED by default)

Create a new ad group with targeting (PAUSED by default)

No parameter schema in public metadata yet.

reddit_ads_update_ad_groupUpdate ad group bid, targeting, or status

Update ad group bid, targeting, or status

No parameter schema in public metadata yet.

reddit_ads_create_adCreate a new ad with headline, body, URL, and media (PAUSED by default)

Create a new ad with headline, body, URL, and media (PAUSED by default)

No parameter schema in public metadata yet.

reddit_ads_update_adUpdate ad creative or status

Update ad creative or status

No parameter schema in public metadata yet.

reddit_ads_pause_itemsPause multiple campaigns, ad groups, or ads at once

Pause multiple campaigns, ad groups, or ads at once

No parameter schema in public metadata yet.

reddit_ads_enable_itemsEnable multiple campaigns, ad groups, or ads at once

Enable multiple campaigns, ad groups, or ads at once

No parameter schema in public metadata yet.

reddit_ads_search_subredditsSearch for subreddits by keyword for targeting

Search for subreddits by keyword for targeting

No parameter schema in public metadata yet.

reddit_ads_get_interest_categoriesList available interest categories for targeting

List available interest categories for targeting

No parameter schema in public metadata yet.

reddit_ads_search_geo_targetsSearch for geographic targeting options (countries, regions, metros)

Search for geographic targeting options (countries, regions, metros)

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

REDDIT_CLIENT_ID*

Reddit OAuth app client ID

REDDIT_CLIENT_SECRET*secret

Reddit OAuth app client secret

REDDIT_REFRESH_TOKEN*secret

Reddit OAuth refresh token

Readme

mcp-reddit-ads

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

Quick install

Claude Code, one line (replace the placeholder values with your own; see Configuration for how to get them):

claude mcp add --env REDDIT_CLIENT_ID=YOUR_CLIENT_ID --env REDDIT_CLIENT_SECRET=YOUR_CLIENT_SECRET --env REDDIT_REFRESH_TOKEN=YOUR_REFRESH_TOKEN --transport stdio mcp-reddit-ads -- npx -y mcp-reddit-ads

The server starts read-only. Add --env REDDIT_ADS_MCP_WRITE=true to expose the tools that change an account; new items are always created PAUSED.

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), then fully quit and restart Claude Desktop:

{
  "mcpServers": {
    "mcp-reddit-ads": {
      "command": "npx",
      "args": ["-y", "mcp-reddit-ads"],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "REDDIT_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
      }
    }
  }
}

Codex CLI

View the full README on GitHub

Details

Repository: github.com/mharnett/mcp-reddit-ads
Categories: Data & Analytics, Finance & Commerce
Package: mcp-reddit-ads
Transport: STDIO
Auth: Required
Registry: MCP registry, active

More from mharnett

Related Data & Analytics MCP servers

1

OrbiAds — Google Ad Managerorbiads/orbiads-gam-mcpAutomate Google Ad Manager: campaigns, line items, creatives, inventory, reporting — 51 tools.1stars

2

Kitsupipeworx-io/mcp-kitsuKitsu MCP — anime + manga catalogue (JSON:API).1stars

3

Costcothehesiod/costco-mcpMCP server for Costco warehouse receipts and online orders1stars

4

Google Driveus-all/google-drive-mcp-serverGoogle Drive + Workspace MCP — Docs, Sheets, Slides, Shared Drives, Labels, Approvals, DWD1stars

5

Domain Monitorjasoncbraatz/domain-monitor-mcpQuery domain expiration data from domain-monitor.io via AI assistants like Claude.1stars

6

Jsc Typescript Ast Mcpjscoobyced/jsc-typescript-ast-mcpAST for TypeScript, supports creating JSON representations of React components1stars