Reddit Ads MCP server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_ADS_CLIENT_ID | No | Client ID of your Reddit app, needed with the refresh token. | |
| REDDIT_ADS_USER_AGENT | No | Optional. Reddit asks clients to identify themselves, for example node:my-ads-app:v1.0.0 (by /u/your_username). | |
| REDDIT_ADS_ACCOUNT_IDS | Yes | Required comma-separated ad account IDs, such as a2_abc123. Every other account is refused, for reads too. | |
| REDDIT_ADS_ACCESS_TOKEN | No | OAuth access token with adsread, and adsedit if you enable writes. Optional when the refresh token and client credentials are set. | |
| REDDIT_ADS_CLIENT_SECRET | No | Secret of your Reddit app, needed with the refresh token. | |
| REDDIT_ADS_ENABLE_WRITES | No | Defaults to false. Only the exact value true exposes the 22 write tools. | false |
| REDDIT_ADS_REFRESH_TOKEN | No | Permanent refresh token. With REDDIT_ADS_CLIENT_ID and REDDIT_ADS_CLIENT_SECRET, the server renews access tokens in memory. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| reddit_get_setup_guideA | Reddit connector coverage, prerequisites, units, renaming and known limits. Read it before planning writes or answering what this server cannot do. |
| reddit_get_write_schemaA | 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_get_reporting_schemaA | Reddit metric and dimension inventory; configured targeting is read with reddit_get_targeting, not inferred from reporting. |
| reddit_health_checkA | Read the allowed Reddit ad account, its business, currency and timezone. API access is not proof of delivery or full objective eligibility. |
| reddit_get_campaignsA | Read Reddit campaigns, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call. |
| reddit_get_campaignA | Read one Reddit campaign and verify that it belongs to the ad account. |
| reddit_get_ad_groupsA | Read Reddit ad groups, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call. |
| reddit_get_ad_groupA | Read one Reddit ad group and verify that it belongs to the ad account. |
| reddit_get_adsA | Read Reddit ads, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call. |
| reddit_get_adA | Read one Reddit ad and verify that it belongs to the ad account. |
| reddit_get_saved_audiencesA | Read Reddit saved audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call. |
| reddit_get_saved_audienceA | Read one Reddit saved audience and verify that it belongs to the ad account. |
| reddit_get_custom_audiencesA | Read Reddit custom audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; every further page needs an explicit call. |
| reddit_get_custom_audienceA | Read one Reddit custom audience and verify that it belongs to the ad account. |
| reddit_get_lead_gen_formsA | 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. |
| reddit_get_lead_formA | Read one Reddit lead form and verify that it belongs to the ad account. Form configuration only; lead submissions are never returned. |
| reddit_get_targetingA | 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_optionsB | Discover valid native targeting values. Communities can be searched; large lists are paginated or explicitly marked partial. |
| reddit_get_profilesA | List profiles accessible to the allowed Reddit ad account. |
| reddit_get_pixelsA | List pixels accessible to the allowed Reddit ad account. |
| reddit_get_insightsA | 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_creative_assetsA | List the asset library of a profile attached to the ad account; unused files are not necessarily ads. |
| reddit_get_postsB | List advertising structured posts for a profile attached to this account. Returns native image/video/carousel/text configuration. |
| reddit_get_postA | Read an ad structured post after profile ownership verification. |
| reddit_get_asset_uploadsB | Poll processing of creative imports through the profile; ACTIVE is media-ready, not advertising delivery. |
| reddit_get_post_jobA | Poll a previously created structured post using its signed job receipt. Does not accept arbitrary job IDs from another account. |
| reddit_list_ad_creativesA | 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. |
| reddit_get_catalogsB | Read product catalogs of the business owning the ad account. |
| reddit_get_productsB | Read products from a catalog owned by the ad account's business. |
| reddit_get_product_setsB | Read product sets from a catalog owned by the ad account's business. |
| reddit_get_catalog_importsB | Read catalog imports from a catalog owned by the ad account's business. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Reddit Ads guide | Coverage, prerequisites, units, renaming and known limits of this server. Same content as reddit_get_setup_guide. |
| Reddit Ads reporting catalog | Every reporting metric with its category and unit note, and every dimension with whether Reddit accepts it as a breakdown. |
TDQS
Scored across 31 tools
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.
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).
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.
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.