Reddit Ads MCP. Audit Ad Performance and Campaigns Instantly
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Reddit Ads MCP Server lets your AI agent manage everything related to Reddit advertising campaigns. You can list ad accounts, audit campaign performance, check creative assets, and pull detailed reports—all without logging into the dashboard.
It turns complex ad management into simple conversation flow.
What your AI agents can do
Get ad
Gets specific details for one single ad based on its ID.
Get ad account
Retrieves all account-level data for a specified ad account.
Get ad group
Gets detailed information about one specific ad group.
Lists all your Reddit Ads accounts and retrieves status metadata for each one.
Retrieves a structured list of every campaign running under your profile.
Generates advertising reports based on custom date ranges and required metrics.
Lists all creative assets associated with your account for governance checks.
Pulls granular data, including performance metrics, for a single identified campaign.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Reddit Ads MCP Server: 10 Tools for Ad Management
Use these ten tools to query every aspect of your Reddit advertising setup—from listing accounts to retrieving granular performance reports.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Reddit Ads on Vinkius019d8476get ad
Gets specific details for one single ad based on its ID.
019d8476get ad account
Retrieves all account-level data for a specified ad account.
019d8476get ad group
Gets detailed information about one specific ad group.
019d8476get campaign
Pulls all metrics and settings for a single campaign.
019d8476get report
Generates a full advertising report using specified dates and metrics.
019d8476list ad accounts
Lists all ad accounts connected to your profile in the system.
019d8476list ad groups
Provides a list of all ad groups under your current advertising setup.
019d8476list ads
Lists all active and inactive ads running across the account.
019d8476list campaigns
Provides a list of every campaign you have set up on Reddit Ads.
019d8476list creative assets
Lists all creative assets (images, videos) available for use in your ads.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Reddit Ads, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Reddit Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Diving into ad reports used to mean 45 minutes of dashboard clicking.
Remember the old way? You'd log into Reddit Ads, click 'Reports,' select your date range, hit run. Then you’d copy the total spend figure and paste it into a spreadsheet. If you needed to check the campaign status for five different groups, that meant five separate tabs and clicking around until you found the right number.
Now? You just tell your agent: 'Get me the report for last week's spending breakdown.' It runs `get_report`, pulls the data, formats it, and hands you a clean summary in text. The manual clicks disappear entirely.
Reddit Ads MCP Server: See account structure with one query.
Before this server, checking if all ad groups were correctly configured was an exercise in deep-linking—navigating from the main campaign view to each group individually. You'd spend time verifying names and status flags just to confirm structural integrity.
Now you ask your agent to `list_ad_groups`. It runs the tool, aggregates the data, and presents a clear list of every ad group under that account. The structure is visible immediately.
What you can do with this MCP connector
Listen up. This server connects your AI client straight to the Reddit Ads API. You don't gotta mess around clicking through dashboards and menus; you just talk to your agent, and it handles everything related to your ad accounts and campaigns.
Your agent lets you audit connected ad accounts by calling list_ad_accounts to see a full roster of every account tied to your profile. You can then get specific metadata for any single one using get_ad_account, which tells you the status details you need right off the bat.
When it comes to tracking performance, you've got serious firepower. To generate reports covering custom date ranges and specific metrics, just run get_report. For deep dives into a single campaign, you use get_campaign to pull all the settings and key metrics for that one area. If you need to map out your whole structure, start by running list_campaigns, which gives you every single campaign set up on Reddit Ads.
From there, you can drill down into the hierarchy. You'll get a list of all ad groups with list_ad_groups and then pull detailed info for any specific group using get_ad_group. To audit what's running inside those groups, you use list_ads, which shows every active and inactive ad currently managed by the account.
For details on a single piece of copy or visuals, call get_ad with an ID.
Need to check your assets? You can list everything available for governance checks using list_creative_assets. The system also lets you run list_ads and get_ad to verify individual ads and ensure all the creative materials are where they should be. To keep tabs on what's running, you get a complete picture of your ad structure by following this flow: list campaigns (list_campaigns) then list associated ad groups (list_ad_groups), giving you full control over every piece of copy and visual asset available in the system.
019d8476-f05b-7203-81d2-715127841e09 
How Reddit Ads MCP Works
- 1 1. Subscribe to the server and provide your Reddit Ads Access Token.
- 2 2. Connect your AI client (Claude, Cursor, etc.) to the Vinkius Marketplace endpoint.
- 3 3. Tell your agent what you need: 'List all ad accounts' or 'Get a report for last month'.
The bottom line is that your AI client treats the entire advertising API as one conversational resource.
Who Is Reddit Ads MCP For?
This server is built for marketing ops specialists and growth leads who spend too much time jumping between dashboards. If you're tired of manually verifying ad group statuses or running reports by copying dates into spreadsheets, this is for you.
Uses list_ad_accounts and list_creative_assets to verify that new ads and groups are configured correctly before launch.
Runs rapid performance audits using get_report or checks account health with get_ad_account without leaving their main workflow.
Uses the agent to pull structured data from multiple tools—like listing campaigns then getting reports—to build a performance summary instantly.
What Changes When You Connect
- Saves time on auditing: Instead of clicking through 5 different tabs to check status, your agent uses
list_ad_accountsto list every account and its current metadata in one query. - Deep performance data: Don't rely on surface metrics. Use
get_reportto pull detailed spending and ROI data for any date range, giving you the hard numbers you need. - Structured campaign overview: Need to know what's running? Call
list_campaignsfollowed bylist_ad_groups. You get a clean hierarchy of every ad group under your campaigns. - Verifies assets and ads: Never wonder if a creative asset is live or if an ad is active. Use
list_creative_assetsandget_adto confirm status across the board. - Reduces manual context switching: You keep all ad data—accounts, campaigns, groups, reports—within your chat window. No need for 10 different browser tabs open.
Real-World Use Cases
Investigating a sudden dip in CTR
The team noticed poor performance last week. They ask the agent to run get_report for the past seven days, comparing it against the prior period. The report shows spend was fine but CPC spiked dramatically, pointing them toward a specific ad group that needs immediate attention.
Onboarding new account managers
A new manager needs to know which accounts are active and if they have the necessary credentials. They ask the agent to run list_ad_accounts. The server replies instantly with a list, status, and IDs for every connected profile.
Checking structural integrity before launch
Before spending money on a new campaign, an ops specialist uses list_campaigns to verify the parent structure. Then they call list_ad_groups to ensure all necessary sub-structures are present and correctly named.
Cleaning up unused ads
A growth lead suspects old, inactive campaigns are wasting time. They run list_ads, filter the results for 'inactive' status, and get a clean list of specific ad IDs they can then manually review or pause.
The Tradeoffs
Assuming one tool covers everything
A user just asks: 'Show me my performance data for everything.' The agent fails because it doesn't know if you need account data, campaign reports, or ad group metrics.
→
You have to narrow the scope. First, run list_ad_accounts to get the ID. Then, use that ID with specific tools like get_campaign and finally get_report. Always work in stages.
Forgetting required IDs
A user asks: 'Report on last month.' The agent replies: 'Which account are you talking about?' because the report tool needs an explicit target ID.
→
Always start by listing resources. Call list_ad_accounts first to get the list of available IDs, then pass one of those IDs into your next call.
Mixing account and ad group calls
A user tries to combine listing accounts with getting campaign details in a single prompt, causing ambiguity.
→
Keep the actions separate. Use list_ad_accounts first to get the scope. Then use that ID parameter when calling specific tools like get_campaign or list_ad_groups.
When It Fits, When It Doesn't
Use this server if your workflow involves auditing, reporting, and managing structured data across multiple entities (accounts, campaigns, groups). If you need to know what is running and how well it’s doing, this is the tool. Don't use it if you only need a single piece of information—for example, just listing all ad accounts can be done with list_ad_accounts alone.
However, don't rely on it for creative strategy or copy generation; those are outside its scope. If your goal is to generate new text based on performance (e.g., 'write better headlines'), you need a separate generative tool. This server only reads and structures data.
Common Questions About Reddit Ads MCP
How do I get all my Reddit Ads accounts using list_ad_accounts? +
You simply ask the agent to 'List all Reddit Ad accounts.' It runs list_ad_accounts and returns a structured list, giving you every active account ID in one response.
What is the difference between get_campaign and list_campaigns? +
list_campaigns gives you a directory—a rundown of all campaign names. get_campaign requires you to specify one campaign ID, then pulls every single detail (metrics, budgets) for just that one.
Can I use get_report without giving dates? +
No. The get_report tool needs specific date parameters. You must tell the agent exactly what time frame you want data for (e.g., 'last Tuesday' or '2024-06-15 to 2024-06-30').
How do I check all my creatives using list_creative_assets? +
Ask the agent to list_creative_assets. It runs the tool and gives you a comprehensive catalog of every asset ID, type (image/video), and status in your account.
What credentials do I need to use get_ad_account? +
You must provide a valid Reddit Ads Access Token. This token needs read permissions across the accounts you want your agent to check. Think of this like setting up API keys; never share it, and treat it as sensitive data.
If list_ads returns an error, what does that mean? +
The error usually relates to permissions or invalid IDs provided in the request. Look closely at the specific error code—it tells you if the issue is authentication-related or if a resource simply doesn't exist.
How can I filter results when calling get_ad_group? +
You pass specific filters like status (e.g., 'ACTIVE') or target criteria in the request body. This lets you narrow down groups immediately, so your agent doesn't have to sift through every single ad group.
What should I do if get_report hits a rate limit? +
Rate limits are temporary blocks; you just need to wait and try the request again. The system provides suggested retry intervals, letting your agent automatically pause and then re-attempt fetching the data later.
How do I find my Reddit Ads Access Token? +
Go to your Reddit account settings, under App Management, and create a new script app to generate an OAuth token. Copy and paste it into the field below.
Can the agent list performance for specific ad groups? +
Yes. Use the get_report tool providing the Ad Account ID and the desired date range. Your agent will return detailed metrics such as impressions, clicks, and spend.
Is it possible to check the status of my creative assets? +
Yes. The list_creative_assets tool allows your agent to retrieve all uploaded media and their metadata, ensuring your creative pipeline is ready.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.