reddit-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_ADS_CLIENT_ID | Yes | Your Reddit Ads API app client ID. | |
| REDDIT_ADS_ACCOUNT_ID | Yes | Your Reddit Ads account ID (e.g., a2_xxxxxxxx). | |
| REDDIT_ADS_CLIENT_SECRET | Yes | Your Reddit Ads API app client secret. | |
| REDDIT_ADS_REFRESH_TOKEN | Yes | Permanent refresh token obtained via OAuth2. | |
| REDDIT_ADS_WRITE_ENABLED | No | Set to 'true' to enable write tools (mutations). Default is 'false'. | false |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_accountsA | List every Reddit ad account reachable with the current credentials (walks /me/businesses → businesses/{id}/ad_accounts). |
| list_campaignsA | List campaigns for an ad account (defaults to REDDIT_ADS_ACCOUNT_ID). |
| list_ad_groupsC | List ad groups for an ad account, optionally filtered by campaign_id. |
| list_adsA | List ads for an ad account, optionally filtered by ad_group_id. |
| get_performance_reportB | Performance report for a date range (YYYY-MM-DD). fields default to IMPRESSIONS, CLICKS, SPEND, CTR, CPC, ECPM. breakdowns default to [DATE]; common values: DATE, CAMPAIGN_ID, AD_GROUP_ID, AD_ID. |
| get_daily_performanceB | Last N days (default 7) of impressions/clicks/spend/CTR/CPC/eCPM, by DATE + CAMPAIGN_ID. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
The list tools are clearly distinct by entity, but the two performance tools (get_daily_performance vs get_performance_report) overlap in purpose. Although one is for recent days and the other for custom date ranges, an agent might misselect them without careful description reading.
All tool names follow a consistent verb_noun pattern using snake_case (get_*, list_*). The naming is predictable and clear.
With 6 tools, the set is well-scoped for an ad management server. It covers essential entities (accounts, campaigns, ad groups, ads) and reporting, without unnecessary redundancy.
The tool surface is read-only: only listing and reporting. Missing write operations (create, update, delete) for campaigns, ads, etc., which are critical for actual ad management. Agents cannot perform any operational tasks.