Reddit Ads

You run a Model Context Protocol (MCP) server that exposes read-only access to Reddit Ads data. This MCP server lets you list accounts, campaigns, ad groups, ads, and pull performance reports, all through a lightweight, configurable interface that integrates with MCP clients.

How to use

Use an MCP client to connect to the RedditAdsMCP server and choose the tools you need. You can request lists of accounts, campaigns, ad groups, and ads, or obtain performance reports for custom date ranges and fields. If you omit an accountId in your requests, the client will default to the account identified by REDDIT_ACCOUNT_ID.

How to install

Prerequisites you need before installing include a Reddit account with an active Reddit Ads advertiser account and the .NET 10 SDK.

Option A: Install as a dotnet tool (recommended)

dotnet tool install -g RedditAdsMcp

Option B: Clone and build from source

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

After installation, configure your MCP client to connect to the server using one of the supported configuration methods described below.

Configuration and usage notes

You have two explicit ways to configure the MCP client for RedditAdsMCP with environment variables that provide the necessary credentials and default account.

1. Configuration for Claude Code (stdio mode) using a direct dotnet run invocation

"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"
  }
}

2. Configuration for Claude Code (dotnet tool) using the MCP wrapper command

"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"
  }
}

Tools and endpoints

The RedditAdsMCP server exposes a set of read-only tools to query data and reports. You can invoke these tools through your MCP client to perform common data retrieval tasks.

Available tools include the following capabilities:

• • 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 a custom date range, fields, and breakdowns.
• • GetDailyPerformance: Convenience wrapper — last N days of impressions, clicks, spend, CTR, CPC, eCPM.

Development

To build and run the MCP server locally during development, use the following commands.

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

Security and credentials

Keep your Reddit client credentials and refresh token secure. Do not share these values in public forums or code repositories. Use environment variables to inject credentials into your MCP client configuration and rotate tokens as needed.

Troubleshooting

If your MCP client cannot connect, verify that you provided the correct REDDIT_ACCOUNT_ID and that the Authorization flow completed successfully to obtain a valid refresh token. Ensure the CLI or client environment has the proper environment variables loaded before starting the MCP server.

Available tools

ListAccounts

List all Reddit ad accounts accessible with the current credentials.

ListCampaigns

List campaigns for a given Reddit Ads account.

ListAdGroups

List ad groups, optionally filtered by campaign.

ListAds

List ads, optionally filtered by ad group.

GetPerformanceReport

Retrieve a performance report with a custom date range, fields, and breakdowns.

GetDailyPerformance

Return the last N days of performance metrics as a convenience wrapper.