Meta Agent Tools
PT

Back to the catalog

Reddit Ads MCP

MCP server for the Reddit Ads API. List accounts, campaigns, ads, and pull reports.

Open source Open in the app JSON README (API)

About

MCP server for the Reddit Ads API. List accounts, campaigns, ads, and pull reports.

Details

Kind
MCP servers
Topic
Marketing & analytics
Publisher
mkerchenski
Origin
official
Category
ferramentas
Transport
local
Version
1.1.1
Stars
1
Forks
2
Last push
2026-02-21T22:57:58Z
Repository state
ativo
Language
C#
License
MIT
Added
2026-08-29 04:00:50
Updated
2026-08-29 04:00:50
Origin id
io.github.mkerchenski/reddit-ads-mcp

README

<!-- mcp-name: io.github.mkerchenski/reddit-ads-mcp -->
# RedditAdsMcp

[![NuGet](https://img.shields.io/nuget/v/RedditAdsMcp)](https://www.nuget.org/packages/RedditAdsMcp)
[![Build](https://github.com/mkerchenski/RedditAdsMcp/actions/workflows/lint.yml/badge.svg)](https://github.com/mkerchenski/RedditAdsMcp/actions/workflows/lint.yml)

A C# MCP (Model Context Protocol) server for the Reddit Ads API. Provides read-only tools for listing accounts, campaigns, ad groups, ads, and pulling performance reports.

Built with .NET 10 and the official [ModelContextProtocol](https://www.nuget.org/packages/ModelContextProtocol/) SDK.

## Available Tools

| Tool | Description |
|------|-------------|
| `ListAccounts` | List all Reddit ad accounts accessible with current credentials |
| `ListCampaigns` | List campaigns for an account |
| `ListAdGroups` | List ad groups, optionally filtered by campaign |
| `ListAds` | List ads, optionally filtered by ad group |
| `GetPerformanceReport` | Get a performance report with custom date range, fields, and breakdowns |
| `GetDailyPerformance` | Convenience wrapper — last N days of impressions, clicks, spend, CTR, CPC, eCPM |

All tools accept an optional `accountId` parameter. If omitted, the default account from `REDDIT_ACCOUNT_ID` is used.

## Prerequisites

1. A Reddit account with an active [Reddit Ads](https://ads.reddit.com) advertiser account
2. [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)

## Install

### Option A: Install as a dotnet tool (recommended)

```bash
dotnet tool install -g RedditAdsMcp
```

Then configure Claude Code (see [Step 5b](#5b-configure-claude-code-dotnet-tool) below).

### Option B: Clone and build from source

```bash
git clone https://github.com/mkerchenski/RedditAdsMcp.git
cd RedditAdsMcp
dotnet build
```

Then configure Claude Code (see [Step 5a](#5a-configure-claude-code-from-source) below).

## Setup

### 1. Create a Reddit Ads API App

1. Go to [ads.reddit.com](https://ads.reddit.com)
2. In the left sidebar, click **Developer Applications** (under your account/business settings)
3. Click **Create a new app** and fill in:

| Field | Value |
|-------|-------|
| **App name** | `Reddit Ads MCP` |
| **Description** | `MCP server for Reddit Ads reporting` |
| **About url** | `https://github.com/mkerchenski/RedditAdsMcp` (or leave blank) |
| **Redirect URI** | `https://hurrah.dev/oauth/reddit` |

Reddit requires a public HTTPS redirect URI (localhost won't work). The URL above is a simple callback page maintained by the package author that displays the authorization code for you to copy — it does not store any data. You can use any HTTPS URL you control instead; just update the redirect URI in Steps 2–3 to match.

4. Click **Create app**
5. Copy your **App ID** and **Secret** — you'll need both in the next steps

### 2. Authorize the App

Open this URL in your browser, replacing `YOUR_APP_ID` with the App ID from Step 1:

```
https://www.reddit.com/api/v1/authorize?client_id=YOUR_APP_ID&response_type=code&state=mcp&redirect_uri=https%3A%2F%2Fhurrah.dev%2Foauth%2Freddit&duration=permanent&scope=adsread
```

Click **Allow**. You'll be redirected to a page that displays your authorization code — click **Copy**.

### 3. Exchange the Code for a Refresh Token

Run this command, replacing the three placeholders with your App ID, Secret, and authorization code:

```bash
curl -X POST https://www.reddit.com/api/v1/access_token \
  -u "YOUR_APP_ID:YOUR_SECRET" \
  -A "ads-mcp/1.0" \
  -d "grant_type=authorization_code&code=YOUR_AUTHORIZATION_CODE&redirect_uri=https://hurrah.dev/oauth/reddit"
```

> The `redirect_uri` must match exactly what you entered in Step 1.

The response JSON contains a `refresh_token` field. Save it — it's permanent until revoked.

### 4. Find Your Account ID

1. Go to [ads.reddit.com](https://ads.reddit.com) and click **All accounts** (top-left dropdown)
2. Select your business on the left — your ad account appears on the right
3. The account ID is the value under the account name (e.g. `a2_eaf73mplhhps`)

### 5a. Configure Claude Code (from source)

Add to your Claude Code MCP settings (`.mcp.json` in your project, or `~/.claude/settings.json`), replacing the four placeholder values:

```json
"reddit-ads": {
  "type": "stdio",
  "command": "dotnet",
  "args": ["run", "--project", "/path/to/RedditAdsMcp", "--no-build"],
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}
```

### 5b. Configure Claude Code (dotnet tool)

```json
"reddit-ads": {
  "type": "stdio",
  "command": "reddit-ads-mcp",
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}
```

Verify with `/mcp` in Claude Code — the `reddit-ads` server should appear with 6 tools.

## Development

```bash
dotnet build    # compile
dotnet run      # start MCP server on stdio
dotnet pack     # create NuGet package
```

## License

MIT

More