Reddit Ads MCP API reference
Every Reddit Ads tool the MCP server exposes, with its parameters. 50 tools, 416 metrics and 37 dimensions, on a dedicated endpoint.
52 rows
Campaigns, ad groups, ads, communities and audience targeting, creative assets, catalogs and native reporting.
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 requestedLink to this section
| 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 |
CataloguesLink to this section
Write tools (19)Link to this section
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 | create Reddit ad with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | create Reddit ad_group with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | create Reddit campaign with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | Reddit create catalog using the native schema catalog_create. | Write | On demand |
reddit_ | create Reddit custom_audience with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | create Reddit lead_form with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | Reddit create post using the native schema post_create. | Write | On demand |
reddit_ | Reddit create product set using the native schema product_set_create. | Write | On demand |
reddit_ | create Reddit saved_audience with native fields, including supported objectives/formats. | Write | On demand |
reddit_update_ad | update Reddit ad with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | update Reddit ad_group with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | Update supported Reddit asset fields; preview by default. | Write | On demand |
reddit_ | update Reddit campaign with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | Update supported Reddit catalog fields; preview by default. | Write | On demand |
reddit_ | Update supported Reddit post fields; preview by default. | Write | On demand |
reddit_ | Update supported Reddit product_set fields; preview by default. | Write | On demand |
reddit_ | update Reddit saved_audience with native fields, including supported objectives/formats. | Write | On demand |
reddit_ | Reddit upload creative assets using the native schema asset_upload. | Write | On demand |
reddit_ | Reddit upsert products using the native schema products_upsert. | Write | On demand |
Read tools (31)Link to this section
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 | Read one Reddit ad; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read one Reddit ad_group; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read Reddit ad_groups, including native configuration and configured/effective status. | Read | Announced |
reddit_get_ads | Read Reddit ads, including native configuration and configured/effective status. | Read | On demand |
reddit_ | Poll processing of creative imports through the selected profile; ACTIVE is media-ready, not advertising delivery. | Read | On demand |
reddit_ | Read one Reddit campaign; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read Reddit campaigns, including native configuration and configured/effective status. | Read | Announced |
reddit_ | Read catalog_imports from an owned Reddit catalog. | Read | On demand |
reddit_ | Read product catalogs of the business owning the selected ad account. | Read | On demand |
reddit_ | List the selected Reddit profile's asset library; unused files are not necessarily ads. | Read | On demand |
reddit_ | Read one Reddit custom_audience; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read Reddit custom_audiences, including native configuration and configured/effective status. | Read | On demand |
reddit_ | Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination. | Read | Announced |
reddit_ | Read one Reddit lead_form; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read Reddit lead_gen_forms, including native configuration and configured/effective status. | Read | On demand |
reddit_ | List pixels accessible to the selected Reddit ad account. | Read | On demand |
reddit_get_post | Read an ad structured post after profile ownership verification. | Read | On demand |
reddit_ | Poll a previously created structured post using its signed job receipt. | Read | On demand |
reddit_get_posts | List advertising structured posts for a profile attached to this account. | Read | On demand |
reddit_ | Read product_sets from an owned Reddit catalog. | Read | On demand |
reddit_ | Read products from an owned Reddit catalog. | Read | On demand |
reddit_ | List profiles accessible to the selected Reddit ad account. | Read | On demand |
reddit_ | Reddit metric and dimension inventory; configured targeting is read with reddit_get_targeting, not inferred from reporting. | Read | On demand |
reddit_ | Read one Reddit saved_audience; verify it belongs to the selected ad account. | Read | On demand |
reddit_ | Read Reddit saved_audiences, including native configuration and configured/effective status. | Read | On demand |
reddit_ | Complete Reddit connector coverage, prerequisites and live-validation limits. | Read | On demand |
reddit_ | Read actual ad-group targeting: inclusions, exclusions, geo, age/gender, languages, interests, communities, keywords, devices and audience IDs. | Read | Announced |
reddit_ | Discover valid native targeting values. | Read | On demand |
reddit_ | Exact pinned native schemas for Reddit creation and edits, including targeting and all implemented campaign/ad formats. | Read | On demand |
reddit_ | Read the selected Reddit account, currency and timezone; API access is not proof of delivery or full objective eligibility. | Read | Announced |
reddit_ | Resolve ad-linked image/video/carousel assets with explicit coverage. | Read | Announced |