Reddit Ads MCP

io.github.mkerchenskiPublished by GitHub account mkerchenskiv1.1.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only Reddit Ads API access so an assistant can list ad accounts, campaigns, ad groups, ads, and pull performance reports.

What you can do
A local C# MCP server that wraps the Reddit Ads API with read-only tools. It exposes ListAccounts, ListCampaigns, ListAdGroups, ListAds, GetPerformanceReport (custom date range, fields, and breakdowns), and GetDailyPerformance for the last N days of impressions, clicks, spend, CTR, CPC, and eCPM. Every tool takes an optional accountId, falling back to the default account from REDDIT_ACCOUNT_ID.
When to use it
Useful when you want an assistant to inspect Reddit advertising structure or summarize campaign performance without opening the ads dashboard. It fits reporting and auditing questions about accounts, campaigns, ad groups, and ads; it does not create or change anything.
Requirements
Runs locally over stdio as a .NET 10 tool (dotnet tool install -g RedditAdsMcp) or built from source. Needs a Reddit account with an active Reddit Ads advertiser account, a Reddit Ads API app, and the environment variables REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN, and REDDIT_ACCOUNT_ID. Network access to the Reddit Ads API is required.
Before you install
Requires the secrets REDDIT_CLIENT_SECRET and REDDIT_REFRESH_TOKEN, plus REDDIT_CLIENT_ID and REDDIT_ACCOUNT_ID, passed as environment variables. The refresh token is permanent until revoked, so treat it as long-lived credentials. Setup involves a public HTTPS redirect URI; the README suggests a callback page maintained by the package author, which displays the authorization code, and notes you can use any HTTPS URL you control instead.

Installation

In SourceWeft

  1. Open Reddit Ads MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

RedditAdsMcp

[NuGet] [Build]

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 SDK.

Available Tools

ToolDescription
ListAccountsList all Reddit ad accounts accessible with current credentials
ListCampaignsList campaigns for an account
ListAdGroupsList ad groups, optionally filtered by campaign
ListAdsList ads, optionally filtered by ad group
GetPerformanceReportGet a performance report with custom date range, fields, and breakdowns
GetDailyPerformanceConvenience 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 advertiser account
  2. .NET 10 SDK

Install

Option A: Install as a dotnet tool (recommended)

bash
dotnet tool install -g RedditAdsMcp

Then configure Claude Code (see Step 5b below).

Option B: Clone and build from source

bash
git clone https://github.com/mkerchenski/RedditAdsMcp.gitcd RedditAdsMcpdotnet build

Then configure Claude Code (see Step 5a below).

Setup

1. Create a Reddit Ads API App

  1. Go to 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:
FieldValue
App nameReddit Ads MCP
DescriptionMCP server for Reddit Ads reporting
About urlhttps://github.com/mkerchenski/RedditAdsMcp (or leave blank)
Redirect URIhttps://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.

  1. Click Create app
  2. 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 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    # compiledotnet run      # start MCP server on stdiodotnet pack     # create NuGet package

License

MIT

Source: README.md at commit fe7288a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts