Reddit Ads MCP API reference
Every Reddit Ads tool the MCP server exposes, with its parameters. 54 tools, 416 metrics and 37 dimensions, on a dedicated endpoint.
View as MarkdownNo row matches.
Campaigns, ad groups, ads, communities and audience targeting, creative assets, catalogs and native reporting.
To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.
Connection
- Platform id
reddit_ads- Tool prefix
reddit_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ reddit-ads/ mcp - Access
- Connect Reddit and select the ad accounts your assistant may access. Native account eligibility and permissions apply.
- Tools
- 54, 23 of which write
- Metrics
- 416
- Dimensions
- 37
Scope requested
| Scope | Grants | Allows writes |
|---|---|---|
adsread | Read authorized Reddit Ads accounts and reporting. | No |
adsedit | Manage Reddit campaigns, ad groups, ads, assets and supported audience/catalog configuration. Changes require confirmation and the appropriate account permissions. | Yes |
Catalogues
- Metrics416 metrics, with the field name each one maps to.
- Dimensions37 dimensions, with their constraints.
Write tools (23)
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_rename_ad | Rename one Reddit ad. | Write | On demand |
reddit_ | Rename the selected Reddit ad account. | Write | On demand |
reddit_ | Rename one Reddit ad group. | Write | On demand |
reddit_ | Rename one Reddit campaign. | 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)
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 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 |
Manage your ads from your AI assistant
Start for free
Free with 1 ad account, no card. Pro is free for 7 days.