Reddit Ads API v3: campaigns, ad groups, ads, reports, plus working writes with safety tiers.
Reddit Ads API v3: campaigns, ad groups, ads, reports, plus working writes with safety tiers. The reddit ads mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 12 defined tools rather than through you.
A Reddit Ads API v3 MCP server with working write operations and tiered safety controls, built and dogfooded by an actual Reddit advertiser. It gives an MCP client read access to campaigns, ad groups, ads, and performance reports, plus gated write tools for pausing, creating, budget and bid changes, targeting edits, and copying ads between ad groups.
The server ships on npm as mcp-server-reddit-ads, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Everything the assistant can do here goes through one of these:
Group — ToolsDiagnostics — get_server_statusAccounts — get_accounts, get_account_overviewEntities — get_campaigns, get_campaign, get_ad_groups, get_ad_group, get_ads, get_adCreative — get_ad_creativeSearch — find_entityReporting — get_performance_report, get_daily_performance, compare_periods, compare_adsCreate — create_campaign, create_ad_group, create_adComments — update_ad_commentsWorkflows — copy_adsResume — enable_itemsMoney — update_budget, update_bidYou will need 5 environment variables: REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN, REDDIT_ADS_WRITE_TIER, REDDIT_ADS_ACCOUNT_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Reddit Ads's toolset — Group, Diagnostics, Accounts and 9 more — is a fair guide to whether it matches your workflow. It is maintained by camlowe; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Reddit Ads's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Group | Tools |
| Diagnostics | get_server_status |
| Accounts | get_accounts, get_account_overview |
| Entities | get_campaigns, get_campaign, get_ad_groups, get_ad_group, get_ads, get_ad |
| Creative | get_ad_creative |
| Search | find_entity |
| Reporting | get_performance_report, get_daily_performance, compare_periods, compare_ads |
| Create | create_campaign, create_ad_group, create_ad |
| Comments | update_ad_comments |
| Workflows | copy_ads |
| Resume | enable_items |
| Money | update_budget, update_bid |
{
"mcpServers": {
"reddit-ads": {
"command": "npx",
"args": ["-y", "mcp-server-reddit-ads"],
"env": {
"REDDIT_CLIENT_ID": "your-value",
"REDDIT_CLIENT_SECRET": "your-value",
"REDDIT_REFRESH_TOKEN": "your-value",
"REDDIT_ADS_WRITE_TIER": "your-value",
"REDDIT_ADS_ACCOUNT_ID": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| REDDIT_CLIENT_ID | Configuration value read at startup. | Optional |
| REDDIT_CLIENT_SECRET | Credential the server authenticates with. | Yes |
| REDDIT_REFRESH_TOKEN | Credential the server authenticates with. | Yes |
| REDDIT_ADS_WRITE_TIER | Configuration value read at startup. | Optional |
| REDDIT_ADS_ACCOUNT_ID | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.