Reddit Ads

io.github.mharnettPublished by GitHub account mharnettv1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

MCP server for the Reddit Ads API v3 that lets an assistant read campaigns, ad groups, ads and performance reports, and optionally create or pause them.

What you can do
  • Check account context and list accessible ad accounts
  • List campaigns, ad groups and ads, with optional status filters
  • Pull aggregated and day-by-day performance reports
  • Create and update campaigns, ad groups and ads, including targeting and creative
  • Bulk pause or enable multiple campaigns, ad groups or ads
  • Search subreddits, interest categories and geographic targets for targeting
When to use it
Useful when you manage Reddit advertising and want an assistant to inspect account structure, summarize spend and performance, or prepare and adjust campaigns and targeting from a chat session.
Requirements
Runs locally as an npm package (mcp-reddit-ads) on Node.js, configured in the MCP client config file. Needs a Reddit OAuth app of type script plus REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET and REDDIT_REFRESH_TOKEN with adsread, adsedit and read scopes. Optional config.json holds account and business defaults; environment variables take precedence.
Before you install
Requires Reddit OAuth credentials, including the client secret and refresh token; the README warns not to share or commit the config file. Mutating tools are hidden and refused unless REDDIT_ADS_MCP_WRITE is set to true, so enabling writes lets the assistant change live campaigns and ad spend. New entities are created paused by default, but updates and bulk pause/enable act immediately.

Installation

In SourceWeft

  1. Open Reddit Ads in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npm install mcp-reddit-ads

Or clone the repository:

bash
git clone https://github.com/mharnett/mcp-reddit-ads.gitcd mcp-reddit-adsnpm installnpm 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:

VariableDescription
REDDIT_CLIENT_IDOAuth app client ID
REDDIT_CLIENT_SECRETOAuth app client secret
REDDIT_REFRESH_TOKENOAuth refresh token with ads scopes
REDDIT_ADS_MCP_WRITESet to true to enable mutating tools (create/update/pause/enable). Unset = read-only (default).

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 REDDIT_ADS_MCP_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:

json
{  "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)

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/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Tools

Context

ToolDescription
reddit_ads_get_client_contextGet account info and verify API connectivity
reddit_ads_get_accountsList all ad accounts accessible to the authenticated user

Read

ToolDescription
reddit_ads_get_campaignsList campaigns with optional status filter
reddit_ads_get_ad_groupsList ad groups for a campaign
reddit_ads_get_adsList ads for an ad group
reddit_ads_get_performance_reportAggregated performance metrics for campaigns/ad groups/ads
reddit_ads_get_daily_performanceDay-by-day performance breakdown

Write: Campaigns

ToolDescription
reddit_ads_create_campaignCreate a new campaign (PAUSED by default)
reddit_ads_update_campaignUpdate campaign name, budget, objective, or status

Write: Ad Groups

ToolDescription
reddit_ads_create_ad_groupCreate a new ad group with targeting (PAUSED by default)
reddit_ads_update_ad_groupUpdate ad group bid, targeting, or status

Write: Ads

ToolDescription
reddit_ads_create_adCreate a new ad with headline, body, URL, and media (PAUSED by default)
reddit_ads_update_adUpdate ad creative or status

Bulk Operations

ToolDescription
reddit_ads_pause_itemsPause multiple campaigns, ad groups, or ads at once
reddit_ads_enable_itemsEnable multiple campaigns, ad groups, or ads at once

Targeting

ToolDescription
reddit_ads_search_subredditsSearch for subreddits by keyword for targeting
reddit_ads_get_interest_categoriesList available interest categories for targeting
reddit_ads_search_geo_targetsSearch for geographic targeting options (countries, regions, metros)

Key Conventions

  • Spend values are returned from the API in microcurrency (1 dollar = 1,000,000 microcurrency units). Divide by 1,000,000 to get dollar amounts. Budget inputs accept dollars and auto-convert.
  • Dates and times use ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
  • New entities default to PAUSED status. Explicitly set status to ACTIVE to go live.
  • Report metrics default to the set configured in config.json but can be overridden per request.

Architecture

  • Resilience: Uses cockatiel for retry policies and circuit breaking on API calls
  • Logging: Structured logging via pino
  • Response truncation: Large API responses are truncated at 200KB to stay within MCP message limits
  • Auth: OAuth 2.0 refresh token flow with automatic access token renewal

License

MIT -- see LICENSE.

Author

Built by Mark Harnett / drak-marketing.

Source: README.md at commit 55f2f3c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts