Skip to main content
Glama
Reddit Ads MCP server

Reddit Ads MCP server

by get-mcp-ads

Reddit Ads MCP server

Bring your Reddit Ads accounts into your MCP client.

Read campaigns and reporting, inspect targeting and prepare changes for explicitly allowed ad accounts.

Release CI License: Apache 2.0 Node

Watch the film · What's new · Install · Tool reference · Try hosted getmcpads

Watch the getmcpads film: every ad account in one conversation with your AI assistant

Play the 45-second film

The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.

31 read tools · 22 write tools, disabled by default.

Run locally with your own platform credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the platform. For managed connections, including supported ChatGPT setups, use the hosted option.

What's new

v1.0.2: Maintainer metadata update · November 8, 2026

  • List the getmcpads team as maintainer in package.json, the README and SOURCE_SYNC.md.

  • No change to tools, parameters, descriptions or runtime behaviour.

Earlier releases

Version

Date

Highlights

1.0.1

October 26, 2026

Zod 4 security update

1.0.0

October 23, 2026

First standalone release

Full changelog · All releases

Source synchronization: SOURCE_SYNC.md.

Upgrade notes

Requires Node.js 22.23.4, 24.22.1, 26.12.1 or a newer release of those lines. CI covers Node 22, 24 and 26, and the server prints a warning to stderr on an older runtime. Writes remain optional and require explicit confirmation. Hosted creative integrations and MCP Apps UI are outside this release.

Related MCP server: io.github.seer22/shturman-direct-mcp

Install this release

This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.

git clone --branch v1.0.2 --depth 1 https://github.com/get-mcp-ads/reddit-ads-mcp-server.git
cd reddit-ads-mcp-server
npm ci
npm run build

Configure your MCP client to run node with the absolute path to dist/cli.js and the platform credentials documented below. Once the package is on npm, the same server runs with npx -y @getmcpads/reddit-ads-mcp-server. A Claude Desktop entry looks like this:

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/reddit-ads-mcp-server"],
      "env": {
        "REDDIT_ADS_REFRESH_TOKEN": "your-refresh-token",
        "REDDIT_ADS_CLIENT_ID": "your-app-client-id",
        "REDDIT_ADS_CLIENT_SECRET": "your-app-secret",
        "REDDIT_ADS_ACCOUNT_IDS": "a2_abc123"
      }
    }
  }
}

Managed connection. Use Reddit Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.

Configuration

Provide these environment variables through the client's secret configuration:

Variable

Purpose

REDDIT_ADS_ACCESS_TOKEN

OAuth access token with adsread, and adsedit if you enable writes. Optional when the three refresh variables are set.

REDDIT_ADS_REFRESH_TOKEN

Permanent refresh token. With the two variables below, the server renews access tokens in memory.

REDDIT_ADS_CLIENT_ID

Client ID of your Reddit app, needed with the refresh token.

REDDIT_ADS_CLIENT_SECRET

Secret of your Reddit app, needed with the refresh token.

REDDIT_ADS_ACCOUNT_IDS

Required comma-separated ad account IDs, such as a2_abc123. Every other account is refused, for reads too.

REDDIT_ADS_ENABLE_WRITES

Defaults to false. Only the exact value true exposes the 22 write tools.

REDDIT_ADS_USER_AGENT

Optional. Reddit asks clients to identify themselves, for example node:my-ads-app:v1.0.0 (by /u/your_username).

Register a developer application and request Ads API access as described in Reddit's Ads API documentation. Then run Reddit's OAuth authorization code flow with the scopes adsread, plus adsedit only if you plan to enable writes, and duration=permanent to receive a refresh token. Reddit access tokens expire after about an hour. Give the refresh token and the app credentials for daily use; an access token alone works until it expires. This package accepts tokens. It does not run an OAuth browser flow and never writes a renewed token to disk. Reddit ad account IDs start with a2_; the business ID is a different value.

npm run doctor reports which variables are set, without printing any value, and whether your Node.js release carries the October 2026 security fixes. Run reddit_health_check as the first call: it reads the account, its business, currency and timezone.

Safety and coverage

Writes preview by default. Review the exact account, target and payload before repeating the call with confirm: true. Campaigns, ad groups and ads are created paused. Activation can spend advertising budget, and previews that set configured_status to ACTIVE say so with activationMaySpend. Do not retry a write automatically when its result is uncertain. Read the account and reconcile it first. The server retries only after an HTTP 401, once, when it renewed the token, because Reddit rejected that request before acting on it. The account allowlist applies before every request. Each entity read is checked against the ad account, directly or through its profile, business or catalog. Before a confirmed write, the campaigns, ad groups, posts, audiences, pixels, product sets, profiles and assets it references are checked the same way. Write payloads are validated against Reddit's schemas pinned on 2026-09-11. Billing fields and computed statuses are refused. Passing local validation is not provider acceptance. Budgets, bids and SPEND are microcurrency: one millionth of the account currency. Other reporting fields keep their native units. Pagination cursors are Reddit's own page tokens.

Requests go only to ads-api.reddit.com and, for token renewal, www.reddit.com. No request follows a redirect. Each one has a timeout and a response size limit. Credentials are redacted from every result and error. Media URLs that Reddit returns are passed on as data. This server never downloads them.

Some Reddit capabilities are intentionally not exposed:

  • Customer-list member uploads and conversion event injection.

  • Lead submissions and any other download of personal records. Lead forms are readable as configuration only.

  • Product feeds, billing and funding instruments.

  • Destructive deletes. Status updates accept PAUSED and ACTIVE only, and saved audiences cannot be set to DELETED.

  • Onsite lead-form creation, which Reddit ended on September 21, 2026.

This server exposes a reviewed subset of the Reddit Ads API. It does not automatically expose new upstream endpoints. Hosted creative galleries, alerts, exports and MCP Apps UI are excluded. Use tools/list or server-card.json for exact schemas, reddit_get_write_schema for the pinned write schemas and Reddit's API reference for provider details.

Hosted option

getmcpads for Reddit Ads manages the hosted connection and account selection. Hosted and source releases can differ. Contact: hello@getmcpads.com.

Development

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

All tests run offline with synthetic responses. No live account is changed.

Tools

Every tool is listed below. See server-card.json for complete parameter and output schemas.

Tool

Purpose

reddit_get_setup_guide

Coverage, prerequisites, units, renaming and known limits of this server

reddit_get_write_schema

Pinned native schema for one write operation, including targeting and formats

reddit_get_reporting_schema

Every reporting metric and breakdown name Reddit accepts

reddit_health_check

Read the allowed ad account, its business, currency and timezone

reddit_get_campaigns

List campaigns with native configuration and status

reddit_get_campaign

Read one campaign after checking its account

reddit_get_ad_groups

List ad groups with native configuration and status

reddit_get_ad_group

Read one ad group after checking its account

reddit_get_ads

List ads with native configuration and status

reddit_get_ad

Read one ad after checking its account

reddit_get_saved_audiences

List saved audiences

reddit_get_saved_audience

Read one saved audience after checking its account

reddit_get_custom_audiences

List custom audiences

reddit_get_custom_audience

Read one custom audience after checking its account

reddit_get_lead_gen_forms

List lead form configurations, never lead submissions

reddit_get_lead_form

Read one lead form configuration after checking its account

reddit_get_targeting

Read the configured targeting of an ad group

reddit_get_targeting_options

Discover valid geolocations, languages, interests, devices, carriers and communities

reddit_get_profiles

List profiles attached to the ad account

reddit_get_pixels

List pixels available to the ad account

reddit_get_insights

Run a native report with metrics, up to three breakdowns, UTC dates and pagination

reddit_get_creative_assets

List the asset library of an attached profile

reddit_get_posts

List structured posts of an attached profile

reddit_get_post

Read one structured post after checking its profile

reddit_get_asset_uploads

Poll the processing of creative asset imports

reddit_get_post_job

Poll a structured post creation job with its signed receipt

reddit_list_ad_creatives

Resolve the images and videos behind ads, with explicit coverage

reddit_get_catalogs

List product catalogs of the business that owns the ad account

reddit_get_products

List products of an owned catalog

reddit_get_product_sets

List product sets of an owned catalog

reddit_get_catalog_imports

List catalog imports of an owned catalog

Disabled by default. Calls preview unless explicitly confirmed. Check the configuration and exact schema before use.

Tool

Purpose

reddit_create_campaign

Create a campaign, always paused

reddit_update_campaign

Update campaign fields, including pause or reactivation

reddit_create_ad_group

Create an ad group, always paused

reddit_update_ad_group

Update ad group fields, including targeting, bids and status

reddit_create_ad

Create an ad, always paused

reddit_update_ad

Update ad fields, including pause or reactivation

reddit_create_saved_audience

Create a saved audience

reddit_update_saved_audience

Update a saved audience, without deletion

reddit_create_custom_audience

Create a pixel, engagement or empty customer-list audience

reddit_upload_creative_assets

Import images, videos or headlines into a profile's asset library

reddit_create_post

Start a structured post creation job and return its receipt

reddit_create_catalog

Create a product catalog for the owning business

reddit_create_product_set

Create a product set in an owned catalog

reddit_upsert_products

Create or update products in an owned catalog

reddit_rename_campaign

Rename a campaign, nothing else

reddit_rename_ad_group

Rename an ad group, nothing else

reddit_rename_ad

Rename an ad, nothing else

reddit_rename_ad_account

Rename the ad account, nothing else

reddit_update_post

Change whether comments are allowed on a structured post

reddit_update_asset

Rename a creative asset

reddit_update_catalog

Update a catalog's name or event sources

reddit_update_product_set

Update a product set's name or filter

Resources

Resource

Content

reddit-ads://guide

The setup guide, also returned by reddit_get_setup_guide

reddit-ads://reporting-catalog

Every metric with its category and unit note, and every dimension with whether it is a breakdown

License

Apache License 2.0. See NOTICE.

More from getmcpads

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

Maintained by the getmcpads team at getmcpads. Questions: hello@getmcpads.com.

Available Tools

31 tools
reddit_get_adreddit get adA
Read-onlyIdempotent

Read one Reddit ad and verify that it belongs to the ad account.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_ad_groupreddit get ad groupA
Read-onlyIdempotent

Read one Reddit ad group and verify that it belongs to the ad account.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_ad_groupsreddit get ad groupsA
Read-onlyIdempotent

Read Reddit ad groups, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_adsreddit get adsA
Read-onlyIdempotent

Read Reddit ads, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_asset_uploadsreddit get asset uploadsB
Read-onlyIdempotent

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

Inputs: profileId (required), uploadIds (required), adAccountId (required). Returns: result

reddit_get_campaignreddit get campaignA
Read-onlyIdempotent

Read one Reddit campaign and verify that it belongs to the ad account.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_campaignsreddit get campaignsA
Read-onlyIdempotent

Read Reddit campaigns, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_catalog_importsreddit get catalog importsB
Read-onlyIdempotent

Read catalog imports from a catalog owned by the ad account's business.

Inputs: catalogId (required), adAccountId (required), limit, cursor. Returns: result

reddit_get_catalogsreddit get catalogsB
Read-onlyIdempotent

Read product catalogs of the business owning the ad account.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_creative_assetsreddit get creative assetsA
Read-onlyIdempotent

List the asset library of a profile attached to the ad account; unused files are not necessarily ads.

Inputs: profileId (required), adAccountId (required), limit, cursor. Returns: result

reddit_get_custom_audiencereddit get custom audienceA
Read-onlyIdempotent

Read one Reddit custom audience and verify that it belongs to the ad account.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_custom_audiencesreddit get custom audiencesA
Read-onlyIdempotent

Read Reddit custom audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_insightsreddit get insightsA
Read-onlyIdempotent

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.

Inputs: endsAt (required), fields (required), startsAt (required), adAccountId (required), +4 more. Returns: result

reddit_get_lead_formreddit get lead formA
Read-onlyIdempotent

Read one Reddit lead form and verify that it belongs to the ad account. Form configuration only; lead submissions are never returned.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_lead_gen_formsreddit get lead gen formsA
Read-onlyIdempotent

Read Reddit lead gen forms, including native configuration and configured/effective status. Form configuration only; lead submissions are never returned. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_pixelsreddit get pixelsA
Read-onlyIdempotent

List pixels accessible to the allowed Reddit ad account.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_postreddit get postA
Read-onlyIdempotent

Read an ad structured post after profile ownership verification.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_post_jobreddit get post jobA
Read-onlyIdempotent

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

Inputs: receipt (required), adAccountId (required). Returns: result

reddit_get_postsreddit get postsB
Read-onlyIdempotent

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

Inputs: profileId (required), adAccountId (required), limit, cursor. Returns: result

reddit_get_productsreddit get productsB
Read-onlyIdempotent

Read products from a catalog owned by the ad account's business.

Inputs: catalogId (required), adAccountId (required), limit, cursor. Returns: result

reddit_get_product_setsreddit get product setsB
Read-onlyIdempotent

Read product sets from a catalog owned by the ad account's business.

Inputs: catalogId (required), adAccountId (required), limit, cursor. Returns: result

reddit_get_profilesreddit get profilesA
Read-onlyIdempotent

List profiles accessible to the allowed Reddit ad account.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_reporting_schemareddit get reporting schemaA
Read-onlyIdempotent

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

Inputs: no named parameters. Returns: result

reddit_get_saved_audiencereddit get saved audienceA
Read-onlyIdempotent

Read one Reddit saved audience and verify that it belongs to the ad account.

Inputs: id (required), adAccountId (required). Returns: result

reddit_get_saved_audiencesreddit get saved audiencesA
Read-onlyIdempotent

Read Reddit saved audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call.

Inputs: adAccountId (required), limit, cursor. Returns: result

reddit_get_setup_guidereddit get setup guideA
Read-onlyIdempotent

Reddit connector coverage, prerequisites, units, renaming and known limits. Read it before planning writes or answering what this server cannot do.

Inputs: no named parameters. Returns: result

reddit_get_targetingreddit get targetingA
Read-onlyIdempotent

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

Inputs: adGroupId (required), adAccountId (required). Returns: result

reddit_get_targeting_optionsreddit get targeting optionsB
Read-onlyIdempotent

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

Inputs: kind (required), adAccountId (required), limit, query, +2 more. Returns: result

reddit_get_write_schemareddit get write schemaA
Read-onlyIdempotent

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.

Inputs: operation (required). Returns: result

reddit_health_checkreddit health checkA
Read-onlyIdempotent

Read the allowed Reddit ad account, its business, currency and timezone. API access is not proof of delivery or full objective eligibility.

Inputs: adAccountId (required). Returns: result

reddit_list_ad_creativesreddit list ad creativesA
Read-onlyIdempotent

Resolve ad-linked image/video/carousel assets with explicit coverage. A video cover does not establish its motion/audio; use full media when available. Media URLs are returned, never downloaded.

Inputs: adAccountId (required), adIds, limit, cursor. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 31 tools

    Disambiguation4/5

    The dominant list-vs-single pattern (reddit_get_campaigns / reddit_get_campaign, ads/ad, audiences, lead forms) is clearly conventional and easy to route between. The only genuinely soft boundaries are in the creative cluster (reddit_get_creative_assets vs reddit_list_ad_creatives vs reddit_get_asset_uploads vs reddit_get_posts/reddit_get_post) and targeting vs targeting_options, but the descriptions draw explicit distinctions there.

    Naming Consistency4/5

    Nearly every tool follows reddit_<verb>_<noun> with 'get' as the verb, which makes the surface predictable. Minor deviations exist: reddit_health_check has no verb_noun form, reddit_list_ad_creatives uses 'list' where every comparable tool uses 'get', and the lead-form pair is inconsistently named (reddit_get_lead_form vs reddit_get_lead_gen_forms).

    Tool Count2/5

    31 tools is well past the heavy threshold, and much of the volume comes from mechanical list/get duplication across ten entity types rather than distinct capabilities. The domain is genuinely broad, but a read-only surface this size would be better served by fewer, parameterized read tools plus the write operations that are conspicuously absent.

    Completeness2/5

    The surface is entirely read-only: despite exposing reddit_get_write_schema for 'creation and edits', there is no tool to create, update, pause, or delete a campaign, ad group, ad, audience, or budget. Read coverage is deep (entities, targeting, reporting, catalogs, creative), but an agent asked to actually run Reddit ads hits a dead end at the first write.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides read-only access to Meta Ads API, enabling campaign management, creative analysis, targeting research, and performance analytics via 39 tools.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables safe, informed management of Yandex.Direct accounts through 11 MCP tools, covering reads, planned two-phase writes, reports, media attachment, Wordstat, Metrika, and Audience operations, while exposing platform knowledge as resources such as limits, traps, and the red line of deliberately absent destructive actions.
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading and managing Meta Ads campaigns, ad sets, ads, audiences, pages, and Business Manager using a long-lived access token and Facebook App ID. It provides 38 read/write tools and works with any MCP client over HTTP.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP clients to read Snapchat Ads campaigns and performance and to prepare preview-first changes for selected ad accounts, with opt-in write tools and explicit confirmation before applying updates.
      21
      131 npm
      Apache 2.0