Reddit Ads MCP Server
Provides read-only access to the Reddit Ads API v3, enabling campaign management, performance reporting, and data retrieval for ad accounts, campaigns, ad groups, and ads.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Reddit Ads MCP Server
A Model Context Protocol (MCP) server that provides read-only access to the Reddit Ads API v3.
Features
List ad accounts, campaigns, ad groups, and ads
Generate performance reports with flexible metrics and breakdowns
Daily performance trends
OAuth2 authentication with automatic token refresh
Configurable defaults for account ID and metrics
Related MCP server: tiktok-ads-mcp
Setup
1. Create a Reddit Developer App
Click "create another app..."
Fill in:
name: reddit-ad-mcp (or your preference)
type: Select "script"
redirect uri: http://localhost:8080 (won't be used but required)
Click "create app"
Note your client_id (under the app name) and client_secret
2. Get a Refresh Token
You need to do a one-time OAuth flow to get a refresh token:
# 1. Open this URL in your browser (replace CLIENT_ID):
https://www.reddit.com/api/v1/authorize?client_id=CLIENT_ID&response_type=code&state=random&redirect_uri=http://localhost:8080&duration=permanent&scope=adsread
# 2. Authorize the app - you'll be redirected to localhost with a ?code= parameter
# 3. Exchange the code for tokens (replace CLIENT_ID, CLIENT_SECRET, and CODE):
curl -X POST https://www.reddit.com/api/v1/access_token \
-u "CLIENT_ID:CLIENT_SECRET" \
-d "grant_type=authorization_code&code=CODE&redirect_uri=http://localhost:8080"
# 4. Save the refresh_token from the response3. Configure the MCP Server
Create config.local.json (copy from config.json):
{
"reddit_api": {
"base_url": "https://ads-api.reddit.com/api/v3",
"auth": {
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"refresh_token": "YOUR_REFRESH_TOKEN",
"user_agent": "reddit-ad-mcp/1.0"
}
},
...
"defaults": {
"account_id": "YOUR_AD_ACCOUNT_ID"
}
}4. Install Dependencies
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt5. Add to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"reddit-ads": {
"command": "/path/to/reddit-ad-mcp/.venv/bin/python",
"args": ["/path/to/reddit-ad-mcp/server.py"]
}
}
}Available Tools
Tool | Description |
| List all accessible ad accounts |
| List campaigns for an account |
| List ad groups (optionally filtered by campaign) |
| List ads (optionally filtered by ad group) |
| Generate a performance report with custom metrics and breakdowns |
| Convenience tool for daily trend analysis |
Example Queries
Once connected to Claude, you can ask things like:
"Show me my Reddit ad accounts"
"What campaigns do I have running?"
"How did my ads perform last week?"
"Show me daily spend for the last 30 days"
"Break down campaign performance by country"
Report Metrics
Available metrics for performance reports:
Core: impressions, reach, clicks, spend, ecpm, ctr, cpc
Video: video_viewable_impressions, video_fully_viewable_impressions, video_watched_25/50/75/100_percent
Conversions: conversion_purchase_clicks, conversion_purchase_views, conversion_add_to_cart_clicks, conversion_lead_clicks, conversion_sign_up_clicks, conversion_page_visit_clicks
Report Breakdowns
Available breakdown dimensions: date, country, region, community, placement, device_os
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only Google Ads, Meta Ads and TikTok Ads performance, campaigns and creatives via OAuth.
Manage Reddit advertising across accounts, campaigns, ad groups, posts, and ads. List accounts, fu…
Manage Reddit advertising end-to-end: browse ad accounts and payment methods, and organize campaig…
Read your Amazon Ads campaigns, results, rules and activity, every marketplace and ad type.
Related MCP Servers
- AlicenseAqualityDmaintenanceApple Search Ads API v5 (read-only). Campaigns, ad groups, keywords, performance reports.91MIT
- AlicenseBqualityCmaintenanceProvides read-only access to TikTok advertising data, including campaigns, ad groups, ads, and performance reports through the TikTok Business API.699 PyPI46MIT
- AlicenseBqualityBmaintenanceRead-only MCP server for Meta Ads that lists and reads ad accounts, campaigns, ad sets, ads, ad images, creatives, and fetches insights at various levels.18MIT
- FlicenseNot gradedqualityDmaintenanceProvides read-only access to Meta Ads API, enabling campaign management, creative analysis, targeting research, and performance analytics via 39 tools.-