# Reddit Ads

> Every Reddit Ads tool the MCP server exposes, with its parameters. 50 tools, 416 metrics and 37 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Campaigns, ad groups, ads, communities and audience targeting, creative assets, catalogs and native reporting.

> **Note** External assistant access is pending Reddit clarification. Authorized operators can manage the test connection; the implemented tools are documented here but are not publicly callable yet.

Connection

|  |  |
| --- | --- |
| Platform id | `reddit_ads` |
| Tool prefix | `reddit_` |
| Account parameter | `adAccountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/reddit-ads/mcp |
| Access | External assistant access is pending Reddit clarification. Authorized operators can manage the test connection; the implemented tools are documented here but are not publicly callable yet. |
| Tools | 50, 19 of which write |
| Metrics | 416 |
| Dimensions | 37 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `adsread` | Read authorized Reddit Ads accounts and reporting. External assistant access remains disabled pending Reddit clarification. | No |
| `adsedit` | Manage Reddit campaigns, ad groups, ads, assets and supported audience/catalog configuration. Test workflows are implemented; production assistant access remains disabled. | Yes |

> **Note** What the gateway can change here: Create and edit paused campaigns, ad groups and ads; import creative assets, manage posts, audience configuration and catalog products. Every write previews before confirmation.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/reddit-ads/metrics): 416 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/reddit-ads/dimensions): 37 dimensions, with their constraints.

## Write tools (19)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`reddit_create_ad`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_ad) | create Reddit ad with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_create_ad_group`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_ad_group) | create Reddit ad_group with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_create_campaign`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_campaign) | create Reddit campaign with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_create_catalog`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_catalog) | Reddit create catalog using the native schema catalog_create. | Write | On demand |
| [`reddit_create_custom_audience`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_custom_audience) | create Reddit custom_audience with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_create_lead_form`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_lead_form) | create Reddit lead_form with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_create_post`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_post) | Reddit create post using the native schema post_create. | Write | On demand |
| [`reddit_create_product_set`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_product_set) | Reddit create product set using the native schema product_set_create. | Write | On demand |
| [`reddit_create_saved_audience`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_create_saved_audience) | create Reddit saved_audience with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_update_ad`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_ad) | update Reddit ad with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_update_ad_group`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_ad_group) | update Reddit ad_group with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_update_asset`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_asset) | Update supported Reddit asset fields; preview by default. | Write | On demand |
| [`reddit_update_campaign`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_campaign) | update Reddit campaign with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_update_catalog`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_catalog) | Update supported Reddit catalog fields; preview by default. | Write | On demand |
| [`reddit_update_post`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_post) | Update supported Reddit post fields; preview by default. | Write | On demand |
| [`reddit_update_product_set`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_product_set) | Update supported Reddit product_set fields; preview by default. | Write | On demand |
| [`reddit_update_saved_audience`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_update_saved_audience) | update Reddit saved_audience with native fields, including supported objectives/formats. | Write | On demand |
| [`reddit_upload_creative_assets`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_upload_creative_assets) | Reddit upload creative assets using the native schema asset_upload. | Write | On demand |
| [`reddit_upsert_products`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_upsert_products) | Reddit upsert products using the native schema products_upsert. | Write | On demand |

## Read tools (31)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`reddit_get_ad`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_ad) | Read one Reddit ad; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_ad_group`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_ad_group) | Read one Reddit ad_group; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_ad_groups`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_ad_groups) | Read Reddit ad_groups, including native configuration and configured/effective status. | Read | Announced |
| [`reddit_get_ads`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_ads) | Read Reddit ads, including native configuration and configured/effective status. | Read | On demand |
| [`reddit_get_asset_uploads`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_asset_uploads) | Poll processing of creative imports through the selected profile; ACTIVE is media-ready, not advertising delivery. | Read | On demand |
| [`reddit_get_campaign`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_campaign) | Read one Reddit campaign; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_campaigns`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_campaigns) | Read Reddit campaigns, including native configuration and configured/effective status. | Read | Announced |
| [`reddit_get_catalog_imports`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_catalog_imports) | Read catalog_imports from an owned Reddit catalog. | Read | On demand |
| [`reddit_get_catalogs`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_catalogs) | Read product catalogs of the business owning the selected ad account. | Read | On demand |
| [`reddit_get_creative_assets`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_creative_assets) | List the selected Reddit profile's asset library; unused files are not necessarily ads. | Read | On demand |
| [`reddit_get_custom_audience`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_custom_audience) | Read one Reddit custom_audience; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_custom_audiences`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_custom_audiences) | Read Reddit custom_audiences, including native configuration and configured/effective status. | Read | On demand |
| [`reddit_get_insights`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_insights) | Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination. | Read | Announced |
| [`reddit_get_lead_form`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_lead_form) | Read one Reddit lead_form; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_lead_gen_forms`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_lead_gen_forms) | Read Reddit lead_gen_forms, including native configuration and configured/effective status. | Read | On demand |
| [`reddit_get_pixels`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_pixels) | List pixels accessible to the selected Reddit ad account. | Read | On demand |
| [`reddit_get_post`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_post) | Read an ad structured post after profile ownership verification. | Read | On demand |
| [`reddit_get_post_job`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_post_job) | Poll a previously created structured post using its signed job receipt. | Read | On demand |
| [`reddit_get_posts`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_posts) | List advertising structured posts for a profile attached to this account. | Read | On demand |
| [`reddit_get_product_sets`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_product_sets) | Read product_sets from an owned Reddit catalog. | Read | On demand |
| [`reddit_get_products`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_products) | Read products from an owned Reddit catalog. | Read | On demand |
| [`reddit_get_profiles`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_profiles) | List profiles accessible to the selected Reddit ad account. | Read | On demand |
| [`reddit_get_reporting_schema`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_reporting_schema) | Reddit metric and dimension inventory; configured targeting is read with reddit_get_targeting, not inferred from reporting. | Read | On demand |
| [`reddit_get_saved_audience`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_saved_audience) | Read one Reddit saved_audience; verify it belongs to the selected ad account. | Read | On demand |
| [`reddit_get_saved_audiences`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_saved_audiences) | Read Reddit saved_audiences, including native configuration and configured/effective status. | Read | On demand |
| [`reddit_get_setup_guide`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_setup_guide) | Complete Reddit connector coverage, prerequisites and live-validation limits. | Read | On demand |
| [`reddit_get_targeting`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_targeting) | Read actual ad-group targeting: inclusions, exclusions, geo, age/gender, languages, interests, communities, keywords, devices and audience IDs. | Read | Announced |
| [`reddit_get_targeting_options`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_targeting_options) | Discover valid native targeting values. | Read | On demand |
| [`reddit_get_write_schema`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_get_write_schema) | Exact pinned native schemas for Reddit creation and edits, including targeting and all implemented campaign/ad formats. | Read | On demand |
| [`reddit_health_check`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_health_check) | Read the selected Reddit account, currency and timezone; API access is not proof of delivery or full objective eligibility. | Read | Announced |
| [`reddit_list_ad_creatives`](https://www.getmcpads.com/docs/sources/reddit-ads/tools/reddit_list_ad_creatives) | Resolve ad-linked image/video/carousel assets with explicit coverage. | Read | Announced |

---

This page as HTML: https://www.getmcpads.com/docs/sources/reddit-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.