# Reddit Ads

Connects your MCP assistant to Reddit Ads API v3 with 31 read tools and 22 previewed write actions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: get-mcp-ads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/get-mcp-ads/reddit-ads-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/reddit-ads

## What it does

This server connects your development assistant directly to Reddit Ads API v3 via stdio. It bundles 31 read actions for metrics inspection and 22 write tools that stay inactive until you set `REDDIT_ADS_ENABLE_WRITES=true`. All write actions execute in preview mode first and require `confirm: true` to apply, while newly created campaigns and ads remain paused.

Account access is constrained by `REDDIT_ADS_ACCOUNT_IDS`, accepting IDs prefixed with `a2_`. Queries targeting unlisted accounts fail instantly, even for data reads. The server renews access tokens directly in memory using your refresh credentials without writing tokens to storage.

Operation requires Node.js 22.23.4, 24.22.1, 26.12.1 or newer. Omitting `REDDIT_ADS_ACCOUNT_IDS` stops the server from handling any platform requests.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `REDDIT_ADS_ACCESS_TOKEN`, `REDDIT_ADS_REFRESH_TOKEN`, `REDDIT_ADS_CLIENT_ID`, `REDDIT_ADS_CLIENT_SECRET`, `REDDIT_ADS_ACCOUNT_IDS`, `REDDIT_ADS_ENABLE_WRITES`, `REDDIT_ADS_USER_AGENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> --transport stdio reddit-ads -- npx -y @getmcpads/reddit-ads-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add reddit-ads --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> -- npx -y @getmcpads/reddit-ads-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reddit-ads": {
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/reddit-ads-mcp-server"
            ],
            "env": {
                "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
                "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
                "REDDIT_ADS_CLIENT_ID": "<REDDIT_ADS_CLIENT_ID>",
                "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
                "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reddit-ads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/reddit-ads-mcp-server"
            ],
            "env": {
                "REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
                "REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
                "REDDIT_ADS_CLIENT_ID": "<REDDIT_ADS_CLIENT_ID>",
                "REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
                "REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> -e REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> -e REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> -e REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> -e REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> reddit-ads npx -y @getmcpads/reddit-ads-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- retrieve performance reporting and campaign spending from Reddit
- inspect targeting configurations on allowed advertising accounts
- draft paused campaigns and ad groups with schema checks
- verify account currency and status using `reddit_health_check`

## Example prompts
- Run `reddit_health_check` to see the current ad account timezone and currency
- Fetch all campaigns and metrics for account `a2_abc123`
- Preview creating an ad group inside account `a2_abc123`

## Similar
- [reddit-ads](https://affpapa.org/en/nevibecode/skills/reddit-ads.md) — skill · 1100 installs
- [ads-reddit](https://affpapa.org/en/nevibecode/skills/ads-reddit.md) — skill · 574 installs
- [reddit-api](https://affpapa.org/en/nevibecode/skills/alinaqi-reddit-api.md) — skill · 316 installs
- [developer-ads](https://affpapa.org/en/nevibecode/skills/developer-ads.md) — skill · ★ 87
- [Reddit Trends API](https://affpapa.org/en/nevibecode/mcp/reddit-trends-api.md) — MCP server
- [google-ads-report](https://affpapa.org/en/nevibecode/skills/google-ads-report.md) — skill · 476 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md