Skip to content
Get MCP AdsGet MCP Ads, home
Start free

MCP server

External access pending

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.

Reddit AdsMCP Server

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

https://mcp.getmcpads.com/reddit-ads/mcp
Start free

This endpoint serves Reddit Ads on its own. One shared URL reaches every platform you connect.

50
Tools
19
That write
416
Metrics
37
Dimensions

Ask it

What you can ask it.

Real questions, with the tools each one resolves to. Every tool named below is in the catalogue on this page.

2 questions

0102One exchange

You type the sentence into your assistant. Reddit Ads answers through the tools named here, and nothing else is called.

Every question, every platform

Claude

“Read Reddit campaign performance and audience breakdowns.”

Resolves to2 tools
  • reddit_get_reporting_schema
  • reddit_get_insights

When access is enabled, checks native reporting fields, UTC dates and pagination. External assistant access is currently pending.

1 more

Prepare Reddit campaign, ad group and creative changes.

Documents the native creation workflow, with previews and paused parents. Requires authorized access; external assistant access is pending.

reddit_get_write_schemareddit_create_campaignreddit_create_ad_groupreddit_create_ad

The ledger

Every Reddit Ads tool, as the gateway ships it.

Each description is the one the tool reports to your assistant during discovery, which is what it reads before deciding to call it.

19 write

What it can change: Create and edit paused campaigns, ad groups and ads; import creative assets, manage posts, audience configuration and catalog products. Every write previews before confirmation. Every write previews first.

50 tools

  • reddit_create_adwrite

    create Reddit ad with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_create) and current configuration before edits.

  • reddit_create_ad_groupwrite

    create Reddit ad_group with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_group_create) and current configuration before edits.

  • reddit_create_campaignwrite

    create Reddit campaign with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=campaign_create) and current configuration before edits.

  • reddit_create_catalogwrite

    Reddit create catalog using the native schema catalog_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

  • reddit_create_custom_audiencewrite

    create Reddit custom_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=custom_audience_create) and current configuration before edits.

  • reddit_create_lead_formwrite

    create Reddit lead_form with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=lead_form_create) and current configuration before edits.

  • reddit_create_postwrite

    Reddit create post using the native schema post_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

  • reddit_create_product_setwrite

    Reddit create product set using the native schema product_set_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

  • reddit_create_saved_audiencewrite

    create Reddit saved_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=saved_audience_create) and current configuration before edits.

  • reddit_get_ad

    Read one Reddit ad; verify it belongs to the selected ad account.

  • reddit_get_ad_group

    Read one Reddit ad_group; verify it belongs to the selected ad account.

  • reddit_get_ad_groups

    Read Reddit ad_groups, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_ads

    Read Reddit ads, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_asset_uploads

    Poll processing of creative imports through the selected profile; ACTIVE is media-ready, not advertising delivery.

  • reddit_get_campaign

    Read one Reddit campaign; verify it belongs to the selected ad account.

  • reddit_get_campaigns

    Read Reddit campaigns, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_catalog_imports

    Read catalog_imports from an owned Reddit catalog.

  • reddit_get_catalogs

    Read product catalogs of the business owning the selected ad account.

  • reddit_get_creative_assets

    List the selected Reddit profile's asset library; unused files are not necessarily ads.

  • reddit_get_custom_audience

    Read one Reddit custom_audience; verify it belongs to the selected ad account.

  • reddit_get_custom_audiences

    Read Reddit custom_audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_insights

    Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination. Empty results validate transport only. Reported audience demographics differ from configured targeting.

  • reddit_get_lead_form

    Read one Reddit lead_form; verify it belongs to the selected ad account.

  • reddit_get_lead_gen_forms

    Read Reddit lead_gen_forms, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_pixels

    List pixels accessible to the selected Reddit ad account.

  • reddit_get_post

    Read an ad structured post after profile ownership verification.

  • reddit_get_post_job

    Poll a previously created structured post using its signed job receipt. Does not accept arbitrary job IDs from another account.

  • reddit_get_posts

    List advertising structured posts for a profile attached to this account. Returns native image/video/carousel/text configuration.

  • reddit_get_product_sets

    Read product_sets from an owned Reddit catalog.

  • reddit_get_products

    Read products from an owned Reddit catalog.

  • reddit_get_profiles

    List profiles accessible to the selected Reddit ad account.

  • reddit_get_reporting_schema

    Reddit metric and dimension inventory; configured targeting is read with reddit_get_targeting, not inferred from reporting.

  • reddit_get_saved_audience

    Read one Reddit saved_audience; verify it belongs to the selected ad account.

  • reddit_get_saved_audiences

    Read Reddit saved_audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.

  • reddit_get_setup_guide

    Complete Reddit connector coverage, prerequisites and live-validation limits. Do not infer unavailable capabilities from the initial short tool list.

  • reddit_get_targeting

    Read actual ad-group targeting: inclusions, exclusions, geo, age/gender, languages, interests, communities, keywords, devices and audience IDs. This is configuration, not delivery demographics.

  • reddit_get_targeting_options

    Discover valid native targeting values. Communities can be searched; large lists are paginated or explicitly marked partial.

  • reddit_get_write_schema

    Exact pinned native schemas for Reddit creation and edits, including targeting and all implemented campaign/ad formats. Provider acceptance is separate from local schema validation.

  • reddit_health_check

    Read the selected Reddit account, currency and timezone; API access is not proof of delivery or full objective eligibility.

  • reddit_list_ad_creatives

    Resolve ad-linked image/video/carousel assets with explicit coverage. A video cover does not establish its motion/audio; use full media when available.

  • reddit_update_adwrite

    update Reddit ad with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_update) and current configuration before edits.

  • reddit_update_ad_groupwrite

    update Reddit ad_group with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_group_update) and current configuration before edits.

  • reddit_update_assetwrite

    Update supported Reddit asset fields; preview by default. Read reddit_get_write_schema(operation=asset_update).

  • reddit_update_campaignwrite

    update Reddit campaign with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=campaign_update) and current configuration before edits.

  • reddit_update_catalogwrite

    Update supported Reddit catalog fields; preview by default. Read reddit_get_write_schema(operation=catalog_update).

  • reddit_update_postwrite

    Update supported Reddit post fields; preview by default. Read reddit_get_write_schema(operation=post_update).

  • reddit_update_product_setwrite

    Update supported Reddit product_set fields; preview by default. Read reddit_get_write_schema(operation=product_set_update).

  • reddit_update_saved_audiencewrite

    update Reddit saved_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=saved_audience_update) and current configuration before edits.

  • reddit_upload_creative_assetswrite

    Reddit upload creative assets using the native schema asset_upload. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

  • reddit_upsert_productswrite

    Reddit upsert products using the native schema products_upsert. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

Catalogues

What you can measure, and how you can cut it.

The full catalogues live in the reference, where every entry carries the API field it maps to and the constraints that come with it. Here is their shape.

Metrics

416

5 families

  • App conversion193
  • Web conversion184
  • Video24
  • Delivery11
  • Cost4

All 416 metrics

Dimensions

37

2 families

  • Breakdowns20
  • Report attributes17

All 37 dimensions

Reference

Everything else about it.

The reference, the catalogues, and how to put Reddit Ads in front of your assistant.

The other 8 servers