Skip to content
MCP server

Reddit Ads

Report on Reddit ad accounts and find communities to target, with previewed changes

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally
Version
1.0.2
Listing updated
3 days ago

About Reddit Ads

Reddit Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Reddit has not published an MCP server for its ads (the product checked on October 24, 2026), so Get MCP Ads reaches the Reddit Ads API with your own Reddit sign-in. Only ad accounts your business owns are covered; accounts a partner shares with you are not.

Reporting reaches 416 metrics and 53 dimensions by campaign, ad group and ad. The distinctive part is targeting: it reads which communities, interests and locations an ad group uses and looks up new communities to add, such as running and sneaker subreddits. A creative gallery shows spend and results per creative with daily trends.

On the writing side, campaigns, ad groups, ads and posts can be created or updated and budgets changed, each with a preview, and anything created from files starts paused. The local npm server (31 read, 22 write tools) takes a Reddit OAuth token, or a refresh token with app credentials, and REDDIT_ADS_ACCOUNT_IDS (a2_ IDs) is required even for reads.

Install

Run in a terminal

claude mcp add reddit-ads --env REDDIT_ADS_ACCESS_TOKEN='<REDDIT_ADS_ACCESS_TOKEN>' --env REDDIT_ADS_REFRESH_TOKEN='<REDDIT_ADS_REFRESH_TOKEN>' --env REDDIT_ADS_CLIENT_SECRET='<REDDIT_ADS_CLIENT_SECRET>' --env REDDIT_ADS_ACCOUNT_IDS='<REDDIT_ADS_ACCOUNT_IDS>' -- npx -y @getmcpads/reddit-ads-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/reddit-ads-mcp-server"
      ],
      "env": {
        "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
        "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
        "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
        "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/reddit-ads-mcp-server"
      ],
      "env": {
        "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
        "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
        "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
        "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "reddit-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/reddit-ads-mcp-server"
      ],
      "env": {
        "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
        "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
        "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
        "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/reddit-ads-mcp-server"
      ],
      "env": {
        "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
        "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
        "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
        "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/reddit-ads-mcp-server"
      ],
      "env": {
        "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
        "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
        "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
        "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
      }
    }
  }
}

Configuration

  • REDDIT_ADS_ACCESS_TOKENReddit OAuth access token with adsread. Optional when the refresh credentials are set.
  • REDDIT_ADS_REFRESH_TOKENPermanent refresh token. With the app credentials, the server renews tokens in memory.
  • REDDIT_ADS_CLIENT_IDClient ID of your Reddit app, needed with the refresh token.
  • REDDIT_ADS_CLIENT_SECRETSecret of your Reddit app, needed with the refresh token.
  • REDDIT_ADS_ACCOUNT_IDSComma-separated Reddit ad account IDs (a2_...) the server may reach. Required even for reads.Required
  • REDDIT_ADS_ENABLE_WRITEStrue exposes 22 write tools, each previewing until confirm:true. Defaults to false.
  • REDDIT_ADS_USER_AGENTUser-Agent sent to Reddit, ideally naming your app and Reddit username.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

reddit_get_insights
Returns spend, CTR and conversions by campaign, ad group or ad.
reddit_get_targeting
Shows communities, interests and locations targeted by an ad group.
reddit_get_targeting_options
Finds communities and interests that could be added.
get_creative_performance
Shows creatives with spend and CTR.
reddit_update_ad_group
Changes an ad group, such as its daily budget.
reddit_create_campaign
Creates a paused campaign.
reddit_create_ad_group
Creates an ad group.
reddit_upload_creative_assets
Uploads creative files.
reddit_create_post
Creates a post for an ad.
reddit_create_ad
Creates an ad.

What it does

Community targeting
Reads and suggests subreddits, interests and locations for an ad group.
Wide reporting
416 metrics and 53 dimensions by campaign, ad group and ad.
Creative performance
Shows creatives with spend, CTR and daily movement.
Token refresh
Renews OAuth tokens in memory from a refresh token.
Account allowlist
Only listed a2_ ad accounts are reachable.
Paused uploads
Image, video, carousel and text ads from files are created paused.

Good for

  • Find sneaker and running communities to add to targeting
  • Compare CTR for the top ads over 14 days
  • Cut an ad group's daily budget after a preview
  • Build a paused holiday campaign from an image file
  • Inspect which subreddits a prospecting group targets

Pricing

Freemium, from $39 a month

Hosted: Free (1 ad account, 200 requests/month), Pro $39/mo, Team $99/mo; open-source npm server is Apache 2.0

Prices change. Check getmcpads.com before you buy.

Reddit Ads FAQ

Does Reddit have its own ads MCP server?

The product states there was none as of October 24, 2026.

Which accounts are covered?

Ad accounts your business owns; partner-shared accounts are not.

What credentials does the local server need?

A Reddit access token with adsread, or a refresh token plus app client ID and secret, and the account IDs.

Are writes on by default?

No, they need `REDDIT_ADS_ENABLE_WRITES` and explicit confirmation.

Is Reddit Ads free?

Reddit Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

How do I add Reddit Ads to Claude Code?

Run this command in your terminal: claude mcp add reddit-ads --env REDDIT_ADS_ACCESS_TOKEN='<REDDIT_ADS_ACCESS_TOKEN>' --env REDDIT_ADS_REFRESH_TOKEN='<REDDIT_ADS_REFRESH_TOKEN>' --env REDDIT_ADS_CLIENT_SECRET='<REDDIT_ADS_CLIENT_SECRET>' --env REDDIT_ADS_ACCOUNT_IDS='<REDDIT_ADS_ACCOUNT_IDS>' -- npx -y @getmcpads/reddit-ads-mcp-server

What are the best alternatives to Reddit Ads?

The closest alternatives to Reddit Ads are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to Reddit Ads

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO