For AI agents — MCPBundles Directory API
For MCP client apps (human connect):
MCP connect URL: https://mcp.mcpbundles.com/bundle/reddit-ads
Skill page: https://www.mcpbundles.com/skills/reddit-ads
Tools: 35
Live probe refreshed Nov 21, 2026 · Endpoint host mcp.mcpbundles.com
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 → Structured Post → 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 structured posts; ads attach to post_id.
First Moves
Call the accounts getter first. Omit account_id to list accessible accounts; pass account_id to fetch one account.
Ad account ids use the a2_ prefix (for example a2_h9ko1rxq8dz3). Profile ids use t2_. Never pass bare slugs like igebsl70a5t9 — run the accounts getter first (omit account_id to list) and copy default_scope.account_id.
Use the account returned by default_scope.account_id when there is exactly one valid account.
default_scope also carries business_id and profile_id after the accounts getter runs.
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, structured posts from the structured-post read or create tools, 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, 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.
Structured Posts: the creative payload (TEXT, IMAGE, VIDEO, or CAROUSEL). Create with the structured post creator; ads reference post_id.
Ads: attach a structured post to an ad group; review status and rejection reason live on the ad.
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: profile inventory and legacy posts. Prefer structured posts for new creatives.
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 names with community suggestions; pass names into targeting.communities, not t5_ IDs from search results.
Reuse saved audiences when they already match the targeting plan instead of rebuilding targeting JSON from scratch.
List funding instruments before campaign creation. funding_instrument_id is required to create a campaign. Pick a servable self-serve instrument.
Create in this order: campaign (defaults PAUSED), ad group, structured post, ad (defaults PAUSED). Enable only after review.
Campaign budgets: CONVERSIONS, APP_INSTALLS, and CATALOG_SALES are non-CBO — do not pass daily_budget_cents on campaign create. Set daily_budget_cents on the ad group instead (maps to Reddit goal_value in micros).
CBO objectives (TRAFFIC, BRAND_AWARENESS, etc.) need daily_budget_cents or lifetime_budget_cents on campaign create.
Ad group optimization: CONVERSIONS/CATALOG_SALES use PAGE_VISIT, SIGN_UP, PURCHASE, LEAD, or ADD_TO_CART — not CLICKS. Default on create is PAGE_VISIT.
Community targeting: targeting.communities must be subreddit names (PPC, ClaudeAI), not t5_ IDs. Use community suggestions or the reddit search-subreddits tool for names; ads community search is poor for keyword lookup.
Structured posts: TEXT needs body and uses text_format PLAIN_TEXT or RICH_TEXT_JSON. IMAGE/VIDEO/CAROUSEL need public HTTPS click_url and media URLs Reddit can download (404s fail at ad attach).
Creative × objective: CONVERSIONS and CATALOG_SALES cannot use TEXT (free-form) posts for ads with landing pages — use IMAGE, VIDEO, or CAROUSEL with click_url on the post. Do not pass click_url on the ad for TEXT posts.
Competitor creative research is not available through this bundle — Reddit removed the inspiration API from public access. Browse the Ads Inspiration Library at https://ads.reddit.com/inspiration (Creative → Ads Inspiration Library in Ads Manager). Use profiles, posts, and channel planning reach for account-native planning.
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.
Reddit timestamps on create prefer YYYY-MM-DDTHH:MM:SS+00:00 (no Z suffix).
Community search with a bare keyword often returns unrelated large subreddits; prefer community suggestions or the Reddit social bundle's subreddit search for PPC/marketing audience research.
MCPBundles publishes this directory for MCP discovery. Except where we host or operate an offering, third-party services run under their own terms. Product and company names on this page are used in a descriptive, identifying way (including under nominative fair use where applicable); they remain the property of their owners. Nothing here grants you rights in those marks, and nothing here is an offer to sell a third party's services. Terms
Reddit Ads
Add to your AI client, then sign in once when you connect.
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.
This listing identifies a third-party integration. MCPBundles is not affiliated with, sponsored by, or endorsed by the service or its operator unless stated on this page.
Check Reddit conversion pixel health before launching CONVERSIONS campaigns. Reads last_fired_at from Reddit's pixel report API and optionally validates CAPI credentials with a test_mode PageVisit event.
Reddit Ads Check Pixel Health — Check Reddit conversion pixel health before launching CONVERSIONS campaigns. Reads last_fired_at from Reddit's pixel report API and optionally validates CAPI credentials with a test_mode PageVisit event.
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-ID members after creating it.
Reddit Ads Create Structured Post — Create a Reddit Ads structured post (TEXT, IMAGE, VIDEO, or CAROUSEL) using the official structured post creation job API. Returns post_id when the job succeeds. CONVERSIONS/CATALOG_SALES ads with landing pages need IMAGE, VIDEO, or CAROUSEL with click_url (public HTTPS media Reddit can download). TEXT is free-form and cannot attach to conversion ads. Attach the returned post_id when creating an ad.
Reddit Ads Delete Ad — Archive a Reddit ad creative. List ads first to find the ad ID.
Reddit Ads Delete Ad Group — Archive a Reddit Ads ad group. List ad groups first to find the ad group ID.
Reddit Ads Delete Campaign — Archive a Reddit Ads campaign. List campaigns first to find the campaign ID.
Reddit Ads Delete Custom Audience — Permanently delete a Reddit Ads custom audience and its members. List 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 making further edits.
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. This is the first call for most workflows because campaigns, ad groups, ads, audiences, pixels, reports, and funding are account-scoped.
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 35 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.
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, status, and schedule for one ad group.
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 reason, destination URL, and media.
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 the flexible report tool for custom metrics or grains.
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 campaign's budget, status, schedule, and funding configuration. Resolve the ad account first.
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 read-only planning data and does not create ads.
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 creating or editing ad group targeting.
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 size, retention, status, and configuration.
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, lead generation, or beta features.
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 pass form_id for one form's questions and settings.
Reddit Ads Get Pixels — Get Reddit conversion pixels. Omit pixel_id to list pixels for an account; pass pixel_id to fetch one pixel with last_fired_at from Reddit's dedicated report endpoint. Pixel IDs are needed for CAPI events and conversion_pixel_id on ad groups.
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 post URLs before creating or updating ads.
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 status and event sources.
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 metric sets, and date-range exports.
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 audience's targeting configuration.
Reddit Ads Get Structured Post Job — Get the status of a Reddit structured post creation job. Use after async structured post creation when wait_for_completion was false, or to re-check a long-running IMAGE/VIDEO job.
Showing the first 25 tools — full list and schemas: Directory API.
How many tools does Reddit Ads provide?
Reddit Ads provides 35 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.
MCPBundles is an independent platform built on the open Model Context Protocol standard. MCPBundles is not affiliated with, sponsored by, or endorsed by Anthropic PBC.
More in marketing
Other MCP servers in this category from the directory index