Marketing

Reddit Ads MCP Server

Connect your account, then chat with AI to run tools.

Reddit Ads is Reddit's advertising platform that enables businesses to create and manage advertising campaigns across Reddit's network. Access campaign performance metrics, ad group management, audience targeting, creative management, and detailed advertising insights through the Reddit Ads API v3.

Managed
33 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Reddit Ads — workflow patterns, data models, and gotchas for your AI agent.

Reddit Ads

Reddit Ads is account-scoped. Start every workflow by resolving the ad account, then work down the hierarchy:

Account → Campaign → Ad Group → Ad

Reports, custom audiences, saved audiences, lead gen forms, pixels, funding instruments, interests, communities, audit history, feature access, and time zones are account-level or planning surfaces. Profiles own posts and structured posts.

First Moves

  • Call the accounts getter first. Omit account_id to list accessible accounts; pass account_id to fetch one account.
  • Use the account returned by default_scope.account_id when there is exactly one valid account.
  • If a tool needs an ID, get it from the matching getter: campaigns from the campaign getter, ad groups from the ad group getter, ads from the ads getter, audiences from the custom audience getter, saved audiences from the saved audience getter, lead forms from the lead form getter, profiles from the profiles getter, posts from the posts getter, catalogs from the product catalog getter, and pixels from the pixels getter.
  • Respect the 60 calls/minute rate limit. Prefer list calls with filters over repeated single fetches.

Data Model

  • Accounts: ad accounts owned by a Reddit business profile. Most tools require account_id.
  • Campaigns: budget, objective, schedule, status, and funding instrument.
  • Ad Groups: bid settings, schedule, status, and targeting. Targeting lives here, not on campaigns.
  • Ads: creative, destination URL, review status, rejection reason, and media.
  • Custom Audiences: hashed customer lists and pixel-based retargeting audiences.
  • Saved Audiences: reusable targeting templates for campaign planning and ad group setup.
  • Lead Gen Forms: reusable forms for lead-generation ads.
  • Pixels: conversion tracking IDs used by browser pixel and server-side CAPI.
  • Reports: metrics by day, hour, campaign, ad group, or ad.
  • Profiles and Posts: creative inventory owned by Reddit profiles. Posts and structured posts can inform creative reuse and ad setup.
  • Product Catalogs: catalog-sales assets owned by a business, often tied to pixels and product feeds.

Planning & Targeting

  • Use channel planning reach before campaign creation to estimate reachable audience size by country, age bracket, gender, and 7- or 28-day duration.
  • This bundle does not currently expose bid-suggestion tools. Use community subscriber counts from community search as an additional audience sizing proxy.
  • Discover interest IDs with the interests tool; pass selected IDs into ad group targeting.
  • Discover targetable subreddit/community IDs with community search; use community suggestions from topics, websites, or seed communities to expand targeting ideas.
  • Reuse saved audiences when they already match the targeting plan instead of rebuilding targeting JSON from scratch.
  • Search inspiration creatives to benchmark copy, objectives, placements, calls to action, and media patterns before creating new ads.
  • List funding instruments before campaign creation. funding_instrument_id is required to create a campaign.
  • Create in this order: campaign, ad group, ad. Do not create an ad until the destination URL, creative copy, and ad group targeting are ready.

Reporting

  • Use the campaign performance tool for a fast campaign health snapshot with standard KPIs and ranking by spend.
  • Use the report tool for custom metric sets, grains, date ranges, and exports.
  • Spend values are returned in cents when the upstream API supplies cents.

Audiences and Conversions

  • Use SHA256 hashes only for audience members. Normalize emails by lowercasing and trimming before hashing.
  • Audience membership updates can add or remove up to 2,500 email-hash or mobile-ad-ID-hash rows per request.
  • The conversion events tool is for server-side conversion events. Include click_id when available and send events within Reddit's accepted event window.
  • Pixel IDs come from the pixels getter; they are required for conversion events.

Gotchas

  • Scheduled or archived resources can still appear in reports. Use configured and effective status fields when deciding whether something is serving.
  • New or edited ads may enter review before serving.
  • Archive/delete operations are intentionally destructive from an operational standpoint even when reporting history remains.
  • Use account history before changing live objects when you need to understand prior status, budget, targeting, or audience edits.
  • Feature access can be empty even for valid accounts; treat empty as "no explicit gated features returned", not as an auth failure.

Tools in this Server (33)

Reddit Ads Create Custom Audience

Create a Reddit Ads CUSTOMER_LIST custom audience. Reddit Ads API v3 does not expose metadata updates for custom audiences; add hashed email or mobile...

Reddit Ads Delete Ad

Archive a Reddit ad creative. Use reddit_ads_get_ads first to find the ad ID.

Reddit Ads Delete Ad Group

Archive a Reddit Ads ad group. Use reddit_ads_get_ad_groups first to find the ad group ID.

Reddit Ads Delete Campaign

Archive a Reddit Ads campaign. Use reddit_ads_get_campaigns first to find the campaign ID.

Reddit Ads Delete Custom Audience

Permanently delete a Reddit Ads custom audience and its members. Use reddit_ads_get_custom_audiences first.

Reddit Ads Get Account History

Get Reddit Ads account audit history. Use it to understand who changed campaign, ad, ad group, audience, budget, status, or targeting fields before ma...

Reddit Ads Get Accounts

Get Reddit Ads accounts. Omit account_id to list all accounts available to the connected user; pass account_id to fetch one account's configuration. T...

Reddit Ads Get Ad Groups

Get Reddit Ads ad groups. Omit ad_group_id to list ad groups, optionally scoped to a campaign; pass ad_group_id to fetch bid settings, targeting, stat...

Reddit Ads Get Ads

Get Reddit Ads creatives. Omit ad_id to list ads in an account or ad group; pass ad_id to fetch one ad's creative fields, review status, rejection rea...

Reddit Ads Get Campaign Performance

Get an opinionated campaign-level performance snapshot with standard KPIs and ranking. Use this for quick campaign health checks; use reddit_ads_get_r...

Reddit Ads Get Campaigns

Get Reddit Ads campaigns. Omit campaign_id to list campaigns in an account with filters, pagination, and sorting; pass campaign_id to fetch one campai...

Reddit Ads Get Channel Planning Reach

Estimate Reddit channel reach before building a campaign. Returns a reach/impressions curve for country, duration, age bracket, and gender. This is re...

Reddit Ads Get Community Suggestions

Get Reddit community targeting suggestions from a topic query, website URL, or seed community names. Use this to expand targeting ideas before creatin...

Reddit Ads Get Custom Audiences

Get Reddit Ads custom audiences. Omit audience_id to list email, mobile ID, and website visitor audiences; pass audience_id to fetch one audience's si...

Reddit Ads Get Feature Access

Get Reddit Ads feature access for a business or ad account. Use this before planning workflows that depend on gated capabilities such as catalogs, lea...

Reddit Ads Get Lead Gen Forms

Get Reddit Ads lead generation forms for an account. Use these forms when planning or auditing lead generation ads; omit form_id to list forms, or pas...

Reddit Ads Get Pixels

Get Reddit conversion pixels. Omit pixel_id to list pixels for an account; pass pixel_id to fetch one pixel's status, activity, and conversion trackin...

Reddit Ads Get Posts

Get Reddit Ads profile posts and promoted post creative inventory. Use posts to inspect existing headlines, destinations, media, comment settings, and...

Reddit Ads Get Product Catalogs

Get Reddit Ads product catalogs for catalog-sales planning. Omit catalog_id to list catalogs for a business; pass catalog_id to inspect one catalog's ...

Reddit Ads Get Profiles

Get Reddit profiles available for ads. Profiles own posts and structured posts, so resolve profile_id before reading creative inventory.

Reddit Ads Get Report

Get flexible Reddit Ads performance reports for an account by day, hour, campaign, ad group, or ad. Use this for cross-campaign analysis, custom metri...

Reddit Ads Get Saved Audiences

Get reusable Reddit Ads saved audiences for an account. Omit saved_audience_id to list targeting templates; pass saved_audience_id to fetch one saved ...

Reddit Ads Get Structured Posts

Get structured post creative payloads for a Reddit profile. Use this to inspect the structured creative shape Reddit uses for text, image, video, and ...

Reddit Ads Get Time Zones

Get Reddit Ads-supported time zones for campaign and ad group scheduling. Filter by ID, code, or name when choosing schedule fields.

Reddit Ads List Funding

List billing methods and funding instruments for a Reddit Ads account. Returns funding_instrument_id, credit limits, billable amounts, and servability...

Reddit Ads List Interests

List targetable Reddit Ads interest categories. Returns interest IDs and category names used in ad group targeting. Use before creating or updating ad...

Reddit Ads Search Communities

Search targetable Reddit communities for ad targeting. Returns community IDs, names, subscriber counts, categories, and descriptions. Use subscriber c...

Reddit Ads Search Inspiration Creatives

Search Reddit Ads inspiration creatives. Returns public creative examples with budget category, industry, objective, placements, headline, media, and ...

Reddit Ads Send Conversion Events

Send server-side conversion events to Reddit Ads CAPI for purchases, signups, leads, and custom events. Use hashed user identifiers where required, in...

Reddit Ads Update Audience Members

Add or remove hashed members in a Reddit Ads custom audience. Use SHA256 hashes only; do not send raw emails or mobile IDs. The request is limited to ...

Reddit Ads Upsert Ad

Create or update a Reddit ad creative. Providing ad_id updates an existing ad; omitting it creates a new ad inside ad_group_id. New or changed ads can...

Reddit Ads Upsert Ad Group

Create or update a Reddit Ads ad group. Providing ad_group_id updates an existing ad group; omitting it creates an ad group inside campaign_id. Use re...

Reddit Ads Upsert Campaign

Create or update a Reddit Ads campaign. Providing campaign_id updates an existing campaign; omitting campaign_id creates a campaign. On create, provid...

Frequently Asked Questions

What is the Reddit Ads MCP server?

Reddit Ads is Reddit's advertising platform that enables businesses to create and manage advertising campaigns across Reddit's network. Access campaign performance metrics, ad group management, audience targeting, creative management, and detailed advertising insights through the Reddit Ads API v3. It provides 33 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Reddit Ads to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/reddit-ads. Authentication is handled automatically.

How many tools does Reddit Ads provide?

Reddit Ads provides 33 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Reddit Ads require?

Reddit Ads uses One-click sign in. Reddit Ads requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Reddit Ads to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/reddit-ads

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Reddit Ads and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Reddit Ads will appear under Not connected — select it and click Connect to complete OAuth.
Name: Reddit Ads
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/reddit-ads
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Reddit Ads?

Sign in to connect your credentials and start running tools from the chat.

Reddit Ads MCP Server & Skill — 33 Tools