# Reddit Ads MCP > Reddit Ads manages your entire Reddit advertising campaign structure through an MCP connection. Your AI client can audit ad accounts, list campaigns and groups, retrieve specific ads, and pull detailed performance reports using natural conversation. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** ad-campaigns, performance-reporting, digital-marketing, audience-targeting, ad-management ## Description Running successful ads on Reddit means keeping a close eye on everything—from creative assets to daily spending. This MCP lets your agent handle that complexity. Instead of navigating multiple dashboards just to verify if an ad group is live or calculate last week's ROI, you simply ask your AI client. It connects directly to the data, pulling together structured reports and metadata instantly. You can list all active accounts and then dive into campaign details for specific performance checks. This capability turns a manual auditing process into a quick conversation with your agent. All these tools are housed within Vinkius, giving you access to industry-leading connectivity without managing multiple integrations. Whether you're checking asset governance or pulling complex reporting data across flexible dates, the MCP gives you real-time ad operation capabilities right from your workflow. ## Tools ### get_campaign Pulls specific details for one selected advertising campaign. ### get_ad_account Retrieves the complete metadata and status of a single ad account. ### get_ad_group Gets specific details for one designated ad group within an account. ### get_ad Retrieves the full data set and status of a single, specific advertisement. ### get_report Generates detailed advertising reports based on flexible date ranges and performance metrics. ### list_ad_accounts Lists all ad accounts linked to your profile for quick auditing. ### list_ad_groups Retrieves a comprehensive list of every ad group running under your account. ### list_ads Lists all currently active and inactive ads in your accounts. ### list_campaigns Provides a complete overview listing all current advertising campaigns. ### list_creative_assets Lists and inventories every creative asset used across your ad accounts. ## 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 ### Listing all Ad Accounts The agent retrieves a list of every active and inactive advertising account associated with your profile. ### Auditing Campaigns and Groups You can get details for specific campaigns or ad groups to verify their status, budget, and structure. ### Retrieving Ad Details The MCP pulls up metadata on individual ads, checking if the creative assets are correctly published and active. ### Generating Performance Reports You request detailed reports for any given time period to understand total spend, average CPC, and overall ROI. ### Managing Creative Assets The agent lists all creative assets used across your account, helping you maintain strict organizational control over your content. ## Use Cases ### A quick pre-launch audit The Ad Ops Specialist needs to know if the new Q3 campaign group is fully set up. They ask their agent to run `list_ad_groups` and then use `get_campaign` on the specific ID. The agent confirms the structure and pulls all associated creative assets using `list_creative_assets`, saving hours of dashboard clicking. ### Investigating budget overruns The Marketing Manager sees a spike in spend and needs immediate data. They ask their agent to run `get_report` for the last 7 days, specifying 'CPC' as the metric. The agent delivers a precise summary, allowing them to pinpoint which ad group caused the unexpected cost. ### Onboarding new team members The Growth Lead needs an instant inventory of all existing advertising efforts. They ask their agent to run `list_ad_accounts` and then follow up with a request for all active campaigns using `list_campaigns`, giving them immediate context. ### Cross-platform performance comparison A Business Owner needs to compare last month's spending against the previous period. They ask their agent to run two separate `get_report` calls, comparing monthly totals and providing a direct side-by-side financial summary. ## Benefits - Stop manually checking statuses. You can list all ad accounts, then use the agent to get details for specific campaigns or groups, verifying their status instantly. - Never guess your ROI again. Request a detailed advertising report using `get_report` and specify exact date ranges to understand total spend and average CPC. - Maintain control over content. Use `list_creative_assets` to audit every single piece of copy and image across all ad accounts, ensuring compliance before launch. - Get visibility fast. Instead of clicking through dozens of tabs to see what's running, run `list_campaigns` or `list_ad_groups` to maintain a structured overview of all efforts. - Verify everything is live. You can query individual ads and creative assets using tools like `get_ad` to confirm your content is published correctly. ## How It Works The bottom line is you talk to your AI client, and it talks to Reddit Ads for you. 1. Subscribe to this MCP and provide your Reddit Ads Access Token. 2. Connect the token to your preferred AI client (like Claude or Cursor). 3. Use natural language commands within your agent to request specific ad data, reports, or account audits. ## Frequently Asked Questions **How do I list all my Reddit ads accounts using the Reddit Ads MCP?** You use the `list_ad_accounts` tool. This command returns a complete roster of every ad account linked to your profile, allowing you to select which one needs auditing first. **Can I get a performance report for Reddit Ads using this MCP?** Yes, you use the `get_report` tool. You specify the date range and desired metrics—like total spend or average CPC—and the agent returns the structured financial data. **What is the difference between listing ads and getting an ad's details with Reddit Ads MCP?** The `list_ads` tool provides a general index of all running ads. If you need specific metadata, status checks, or detailed information about one particular ad, use the `get_ad` tool. **Does Reddit Ads MCP help me check if my new creative assets are ready?** Yes. You can first run `list_creative_assets` to inventory everything you have. Then, if you want to verify the status of a specific ad or group, use `get_ad_group` or `get_ad`. **Can I audit all campaigns at once with Reddit Ads MCP?** You first run `list_campaigns` to get the full list of campaign IDs. Then, you can use `get_campaign` for each ID to pull specific performance and structural details one by one.