What is Reddit Ads MCP?

It's an MCP (Model Context Protocol) server that connects Reddit Ads to your AI, giving the agent tools to act on your data — through a single remote link.

Which AI clients does it work with?

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

No. Paste the remote URL into your client, authenticate once, and you're done — no packages to install, no code to write.

Is it secure? Can the AI change my data?

Access is authorized by you and can be revoked anytime. Permissions follow what Reddit Ads exposes; you approve them when connecting.

How much does it cost?

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Can I cancel anytime?

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

Reddit Ads MCP Server and REST API

Reddit Ads

Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit.

Install in your client

MCP server URL

https://api.mcp.ai/p_reddit_ads

Secure connection via OAuth 2.0

Tools (83)

For developers

API & agent docs

Machine-readable docs to plug this server into an agent or call it over REST.

Skill (how to use)

Markdown: use via MCP or via the direct REST API.

Open

llms.txt

Agent-readable spec of this server.

Open

For agents

Install prompt — paste into Claude, ChatGPT, Cursor or any MCP agent and it sets itself up.

Open

Postman collection

Import the REST API into Postman.

Download

FAQ

Reddit Ads

Tools (83)

API & agent docs

Frequently asked questions

Example prompts

Reddit Ads

Tools (83)

reddit_ads_create_ad_groupTool to create a new ad group within a Reddit Ads campaign. Use when setting up ad groups with specific bidding strategies, budget goals, and targeting criteria. Note that optimization_goal is require

reddit_ads_create_batch_productsTool to create or update multiple products in a catalog in a single batch operation. Use when you need to add up to 1000 products at once. Note: If using a schedule feed, update your feed to ensure yo

reddit_ads_create_campaignTool to create a new Reddit Ads campaign for the specified ad account. Use when you need to set up a new advertising campaign with specific objective, budget, and targeting settings. Note: Max campaig

reddit_ads_create_custom_audienceTool to create a new Custom Audience in Reddit Ads. Use when you need to create a custom audience for targeted advertising campaigns. Note: This endpoint has rate limits - Custom Audiences Ingestion:

reddit_ads_create_lead_gen_formTool to create a new lead generation form in Reddit Ads. Use when you need to set up a lead gen form to collect user information such as emails, names, phone numbers, etc. Rate limit: 20 requests per

reddit_ads_create_postTool to create a new Reddit post for a specified profile. Use when you need to create promotional content including text, images, videos, or carousel posts. Rate limit: 200 requests per 60 seconds (Cr

reddit_ads_create_product_catalogTool to create a new product catalog. Use when you need to set up a product catalog for Reddit Ads. After creation, finish setup by manually creating products or linking a product feed.

reddit_ads_create_product_feedTool to create a new feed for a product catalog. Use when setting up product feeds for Reddit catalog sales campaigns. Each catalog can contain up to 2 feeds, but they must be of different types (REPL

reddit_ads_create_product_setTool to create a new product set in a product catalog. Use when you need to define a subset of products from a catalog using filter rules for targeted advertising.

reddit_ads_create_saved_audienceTool to create a saved audience for a Reddit Ads ad account with targeting criteria. Use when you need to define and save audience segments for ad campaigns. Rate limit: 200 requests per 60 seconds (C

reddit_ads_create_structured_post_creation_jobTool to create a structured post creation job on Reddit Ads. Use when creating promoted posts with specific creative content (text, image, video, or carousel). Returns a job with status tracking infor

reddit_ads_delete_custom_audienceTool to delete a Custom Audience by ID from Reddit Ads. Use when you need to permanently remove a custom audience. This operation is subject to rate limits: Custom Audiences Ingestion allows 3000 requ

reddit_ads_delete_product_catalogTool to delete a product catalog by ID from Reddit Ads. Use when you need to permanently remove a catalog. Important: This action cannot be undone.

reddit_ads_delete_product_feedTool to delete a feed in a catalog by ID from Reddit Ads. Use when you need to permanently remove a product feed. Important: This action cannot be undone.

reddit_ads_delete_product_setTool to delete a product set by ID from Reddit Ads. Use when you need to permanently remove a product set. Important: This action cannot be undone.

reddit_ads_delete_productsTool to delete multiple products from a Reddit Ads product catalog in a single request. Use when you need to remove products from a catalog. Important: This action cannot be undone, and deleted produc

reddit_ads_do_geolocation_validationsTool to validate a list of geolocations for use in Reddit Ads targeting. Use when you need to check if geolocation IDs or cities are valid for ad targeting before creating or updating campaigns. Rate

reddit_ads_do_keyword_validationsTool to validate a list of keywords for targeting and check their brand safety status. Use when you need to verify if keywords are safe and valid for ad targeting campaigns. Rate limit: Targeting Taxo

reddit_ads_generate_inspiration_creative_summaryTool to get AI-generated summary of best practices followed by an inspiration creative ad. Use when you need to analyze what makes a Reddit ad successful.

reddit_ads_get_a_reportTool to generate a metrics report for ad performance based on specified fields and breakdowns. Use when you need detailed insights and analytics on ad performance, audience engagement, impressions, cl

reddit_ads_get_ad_accountTool to retrieve details for a specific Reddit ad account by ID. Use when you need to get account information including admin approval status, attribution settings, currency, excluded communities/keyw

reddit_ads_get_ad_account_historyGet changelog history for a Reddit ad account with filtering options. Use when you need to track changes made to ads, campaigns, or ad groups within an account, including who made changes and when.

reddit_ads_get_ad_groupTool to get an ad group by its ID from Reddit Ads API. Use when you need to retrieve details about a specific ad group. Note: Rate limit of 400 requests per 60 seconds applies (Campaign Management Rea

reddit_ads_get_app_last_fired_atTool to retrieve the last time mobile conversion events were fired for a specific app ID. Use when you need to check conversion tracking status or verify that mobile events are being received. Rate li

reddit_ads_get_businessTool to get business details by ID from the Reddit Ads API. Use when you need to retrieve information about a specific business entity including its name, industry, contact details, and metadata. The

reddit_ads_get_campaignRetrieve a specific Reddit Ads campaign by its ID. Returns comprehensive campaign information including objective, status, budget, targeting, and optimization settings. Rate limited to 400 requests pe

reddit_ads_get_channel_planning_reachTool to retrieve estimated reach data for a given set of targeting parameters. Returns a series of 10 data points representing the reach curve by impressions. Use when planning ad campaigns and estima

reddit_ads_get_child_funding_instrumentsTool to retrieve a list of Funding Instrument Allocations for a parent funding instrument. Use when you need to view child allocations, check billing amounts, or verify servability status. Note: This

reddit_ads_get_custom_audienceTool to retrieve a custom audience by ID from Reddit Ads API. Use when you need to fetch detailed information about a specific custom audience including its configuration, status, and size estimates.

reddit_ads_get_lead_gen_formTool to retrieve details for a specific lead generation form by ID from Reddit Ads. Use when you need to get form information including name, prompt, privacy link, questions, and timestamps. Rate limi

reddit_ads_get_meTool to get the authenticated member's information from the Reddit Ads API. Use when you need to retrieve details about the currently authenticated user including their Reddit username, email, name, a

reddit_ads_get_pixel_last_fired_atTool to retrieve the last time conversion events were fired for a specific conversion pixel. Use when you need to check conversion tracking status or verify that pixel events are being received. Rate

reddit_ads_get_postTool to retrieve a promoted or organic Reddit post by its ID. Returns post details including type, content, headline, and metadata. Rate limit: 200 requests per 60 seconds (Creative Management).

reddit_ads_get_product_catalogTool to retrieve a specific product catalog by ID from the Reddit Ads API. Use when you need to fetch details about a particular product catalog including its name, language, currency, attached pixels

reddit_ads_get_product_feedTool to retrieve metadata for a specific product feed by ID. Use when you need to fetch details about a particular feed including its URL, schedule, authentication credentials, and update mode.

reddit_ads_get_product_setTool to retrieve metadata for a specific product set by ID from the Reddit Ads API. Use when you need to fetch details about a particular product set including its name, filter rules, and product stat

reddit_ads_get_profileTool to retrieve details for a specific profile by ID from the Reddit Ads API. Use when you need to get profile information including business ID, Reddit username, and modification timestamp. Rate lim

reddit_ads_get_saved_audienceTool to retrieve a saved audience by ID from Reddit Ads API. Use when you need to fetch detailed information about a specific saved audience including its targeting criteria and status. Rate limit: 40

reddit_ads_get_sk_ad_network_availabilityTool to get SKAdNetwork IDs availability quota for an iOS app. Use when you need to check how many SKAdNetwork IDs are available for campaigns, ad groups, or ads.

reddit_ads_get_structured_postTool to retrieve a structured post by its ID from the Reddit Ads API. Returns post details including creative content which can be image, text, video, or carousel type. Rate limit: 200 requests per 60

reddit_ads_list_ad_accounts_by_businessTool to get a list of ad accounts under a business on Reddit Ads. Use when you need to retrieve ad accounts associated with a specific business ID. Supports filtering by specific ad account IDs and pa

reddit_ads_list_ad_groupsTool to list ad groups for a Reddit ad account. Use when you need to retrieve ad groups for campaign management. Rate limit: Campaign Management Read - 400 requests per 60 seconds.

reddit_ads_list_adsTool to list ads by ad account on Reddit Ads platform. Use when you need to retrieve advertising campaigns for a specific ad account. Note: Only 1 ad will appear for each Max campaign. Supports filter

reddit_ads_list_campaignsTool to list campaigns by ad account with pagination support. Use when you need to retrieve campaigns for a specific Reddit Ads account. Rate limit: Campaign Management Read - 400 requests per 60 seco

reddit_ads_list_carriersTool to retrieve all available carriers from Reddit Ads API for targeting purposes. Use when you need to get a list of mobile carriers for ad targeting. Rate limit: Targeting Taxonomy - 500 requests p

reddit_ads_list_catalog_importsTool to retrieve all imports for a catalog. Use when you need to list import history and status for a specific product catalog. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).

reddit_ads_list_communitiesTool to list targetable communities matched by their names. Use when you need to find Reddit communities (subreddits) available for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 s

reddit_ads_list_communities_suggestionsTool to fetch suggested communities for given community names from Reddit Ads API. Use when you need to discover relevant communities for ad targeting based on community names or website URLs. Rate li

reddit_ads_list_devicesTool to retrieve all available devices from Reddit Ads API for targeting purposes. Use when you need to get a list of devices (by make and model) for ad targeting. Rate limit: Targeting Taxonomy - 500

reddit_ads_list_funding_instrumentsTool to list funding instruments (payment methods) for a Reddit Ads ad account. Use when you need to retrieve billing information or check available payment methods. Rate limit: 30 requests per 60 sec

reddit_ads_list_geolocationsTool to fetch a list of geolocations from Reddit Ads API. Use when you need geographic targeting options. Postal code and City geolocations are excluded by default unless postal_code or cities_search

reddit_ads_list_industriesTool to retrieve all available industries from Reddit Ads API. Use when you need to get a complete list of industries for targeting or classification purposes. Returns industry IDs and display names.

reddit_ads_list_interestsTool to retrieve all available interests from Reddit Ads API for targeting purposes. Use when you need to get a list of interests for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60

reddit_ads_list_lead_gen_formsTool to list lead generation forms for a Reddit Ads ad account. Use when you need to retrieve all lead gen forms associated with a specific ad account. Rate limit: 20 requests per 60 seconds (Leads ca

reddit_ads_list_my_businessesTool to retrieve details of businesses associated with the provided access token. Use when you need to get a list of businesses the user has access to, with optional filters for ad account ID or user

reddit_ads_list_pixels_by_ad_accountTool to list pixels by ad account. Use when you need to retrieve conversion pixels for a specific Reddit Ads account. Note: Rate limited to 30 requests per 60 seconds (Conversion Signals).

reddit_ads_list_pixels_by_businessTool to list all pixels associated with a specific business. Use when you need to retrieve conversion tracking pixels for a business. Rate limited to 30 requests per 60 seconds.

reddit_ads_list_postsTool to list up to 1,000 of the most recent posts for a specified profile. Use when you need to retrieve posts from a Reddit profile. Supports filtering by post type (CAROUSEL, IMAGE, TEXT, VIDEO) and

reddit_ads_list_product_catalogsTool to retrieve details for all product catalogs belonging to a business. Use when you need to list all catalogs for a specific business ID. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).

reddit_ads_list_product_feedsTool to retrieve metadata for all feeds in a product catalog. Use when you need to list all feeds for a specific catalog ID to view feed configurations, URLs, and schedules.

reddit_ads_list_product_setsTool to retrieve all product sets in a catalog. Use when you need to list product sets for a specific catalog ID. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).

reddit_ads_list_products_in_product_catalogTool to retrieve all products in a Reddit Ads product catalog. Use when you need to list products for advertising campaigns, with optional filtering by approval status, search terms, or specific produ

reddit_ads_list_products_in_product_setTool to retrieve all products in a Reddit Ads product set. Use when you need to list products within a specific product set, with optional filtering by approval status, issue codes, search terms, or s

reddit_ads_list_profiles_by_ad_accountTool to list profiles by ad account from Reddit Ads API. Use when you need to retrieve all profiles associated with a specific ad account. Rate limit: 100 requests per 60 seconds (Business Manager tie

reddit_ads_list_profiles_by_businessTool to list profiles by business. Use when you need to retrieve all profiles associated with a specific business. Rate limit: Business Manager allows 100 requests per 60 seconds.

reddit_ads_list_saved_audiencesTool to list saved audiences for a Reddit ad account. Use when you need to retrieve saved audience configurations with their targeting details. Rate limit: 400 requests per 60 seconds (Campaign Manage

reddit_ads_list_structured_postsTool to list structured posts for a profile or retrieve up to 10 specific structured posts by ID. Use when you need to retrieve structured posts owned by a Reddit Ads profile. Rate limit: Creative Man

reddit_ads_list_time_zonesTool to retrieve all available time zones from Reddit Ads API for campaign scheduling. Use when you need to get a list of time zones for setting campaign schedules or display times. Rate limit: Campai

reddit_ads_list_user_custom_audiencesTool to list all Custom Audiences under an ad account. Use when you need to retrieve custom audiences for targeting in Reddit Ads campaigns. Rate limit: 500 requests per 60 seconds (Targeting Taxonomy

reddit_ads_list3rd_party_audiencesTool to retrieve all available 3rd party audiences from Reddit Ads API for targeting purposes. Use when you need to get a list of third-party data audiences for ad targeting. Rate limit: Targeting Tax

reddit_ads_query_ad_accountsTool to query ad accounts by business with optional filtering by actors, assets, roles, or custom filter string. Use when you need to retrieve ad accounts for a specific business with filtering capabi

reddit_ads_query_funding_instruments_by_businessQuery funding instruments (credit lines) by business with pagination support. Use when you need to retrieve or filter funding instruments for a Reddit Ads business account. Requires adsread OAuth scop

reddit_ads_search_communitiesTool to search for Reddit communities based on their name or topic. Use when you need to find subreddits for ad targeting purposes. Returns all communities if no query is provided.

reddit_ads_update_ad_accountTool to update a Reddit ad account configuration. Use when you need to modify account settings like name, attribution windows, excluded communities/keywords, or account approval state. Subject to Camp

reddit_ads_update_businessTool to update a business by ID in Reddit Ads. Use when you need to modify business settings such as name, industry, country, or contact information. Rate limit: 100 requests per 60 seconds for Busine

reddit_ads_update_campaignTool to update a campaign by ID in Reddit Ads. Use when you need to modify campaign settings such as name, status, budget, or targeting parameters. Rate limit: 200 requests per 60 seconds (Campaign Ma

reddit_ads_update_custom_audience_usersTool to update users in a Reddit Ads Custom Audience by adding or removing user identifiers. Use when you need to modify audience membership based on hashed user data like emails or mobile advertising

reddit_ads_update_postTool to update a Reddit post by ID. Use when you need to modify post settings like enabling/disabling comments. Rate limit: 200 requests per 60 seconds (Creative Management).