# Reddit Ads MCP > 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. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** ad-campaigns, performance-reporting, digital-marketing, audience-targeting, ad-management ## Description 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. ## Tools ### 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. ### get_campaign Pulls all metrics and settings for a single campaign. ### get_report Generates a full advertising report using specified dates and metrics. ### list_ad_accounts Lists all ad accounts connected to your profile in the system. ### list_ad_groups Provides a list of all ad groups under your current advertising setup. ### list_ads Lists all active and inactive ads running across the account. ### list_campaigns Provides a list of every campaign you have set up on Reddit Ads. ### list_creative_assets Lists all creative assets (images, videos) available for use in your ads. ## Prompt Examples **Prompt:** ``` List all my Reddit ad accounts. ``` **Response:** ``` I've retrieved your ad accounts. You have 2 accounts: 'Vinkius Main' and 'Test Account'. Which one would you like to audit for campaigns? ``` **Prompt:** ``` Show me my active campaigns for account ID t2_xxxx. ``` **Response:** ``` I've found 3 active campaigns in that account: 'Spring Launch', 'Community Outreach', and 'B2B Demo'. I can provide performance summaries for any of them. ``` **Prompt:** ``` Get an ads report for last week. ``` **Response:** ``` I've generated your report for last week. Your total spend was $450 with an average CPC of $0.85. Would you like a breakdown by ad group? ``` ## Capabilities ### Audit connected ad accounts Lists all your Reddit Ads accounts and retrieves status metadata for each one. ### List all active campaigns Retrieves a structured list of every campaign running under your profile. ### Get detailed ad performance reports Generates advertising reports based on custom date ranges and required metrics. ### Verify creative assets Lists all creative assets associated with your account for governance checks. ### Get specific campaign details Pulls granular data, including performance metrics, for a single identified campaign. ## 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. ## Benefits - **Saves time on auditing:** Instead of clicking through 5 different tabs to check status, your agent uses `list_ad_accounts` to list every account and its current metadata in one query. - **Deep performance data:** Don't rely on surface metrics. Use `get_report` to 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_campaigns` followed by `list_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_assets` and `get_ad` to 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. ## How It Works The bottom line is that your AI client treats the entire advertising API as one conversational resource. 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'. ## Frequently Asked Questions **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.