Skip to main content
Glama
Reddit Ads MCP server

Reddit Ads MCP server

by get-mcp-ads

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
REDDIT_ADS_CLIENT_IDNoClient ID of your Reddit app, needed with the refresh token.
REDDIT_ADS_USER_AGENTNoOptional. Reddit asks clients to identify themselves, for example node:my-ads-app:v1.0.0 (by /u/your_username).
REDDIT_ADS_ACCOUNT_IDSYesRequired comma-separated ad account IDs, such as a2_abc123. Every other account is refused, for reads too.
REDDIT_ADS_ACCESS_TOKENNoOAuth access token with adsread, and adsedit if you enable writes. Optional when the refresh token and client credentials are set.
REDDIT_ADS_CLIENT_SECRETNoSecret of your Reddit app, needed with the refresh token.
REDDIT_ADS_ENABLE_WRITESNoDefaults to false. Only the exact value true exposes the 22 write tools.false
REDDIT_ADS_REFRESH_TOKENNoPermanent 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

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Reddit Ads guideCoverage, prerequisites, units, renaming and known limits of this server. Same content as reddit_get_setup_guide.
Reddit Ads reporting catalogEvery reporting metric with its category and unit note, and every dimension with whether Reddit accepts it as a breakdown.

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