Reddit Ads MCP: campaigns, ad groups, ads, reporting, and audience targeting.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-mharnett-reddit-ads": {
"command": "<see-readme>",
"args": []
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server for Reddit Ads API v3 -- campaign management, ad creation, performance reporting, and audience targeting via Claude.
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in marketing / analytics
MCP Server for GCP environment for interacting with various Observability APIs.
⚡ A Simple / Speedy / Secure Link Shortener with Analytics, 100% run on Cloudflare.
DataForSEO API modelcontextprotocol server
一键同步文章到多个内容平台,支持今日头条、WordPress、知乎、简书、掘金、CSDN、typecho各大平台,一次发布,多平台同步发布。解放个人生产力
MCP Security Weekly
Get CVE alerts and security updates for io.github.mharnett/reddit-ads and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
MCP server for Reddit Ads API v3 -- campaign management, ad creation, performance reporting, and audience targeting via Claude.
npm install mcp-reddit-ads
Or clone the repository:
git clone https://github.com/mharnett/mcp-reddit-ads.git
cd mcp-reddit-ads
npm install
npm run build
Security: Never share your .mcp.json file or commit it to git -- it may contain API credentials. Add .mcp.json to your .gitignore.
Create a Reddit OAuth app at reddit.com/prefs/apps:
adsread adsedit read scopesSet credentials via environment variables:
| Variable | Description |
|---|---|
REDDIT_CLIENT_ID | OAuth app client ID |
REDDIT_CLIENT_SECRET | OAuth app client secret |
REDDIT_REFRESH_TOKEN | OAuth refresh token with ads scopes |
REDDIT_ADS_MCP_WRITE | Set to true to enable mutating tools (create/update/pause/enable). Unset = read-only (default). |
As of v1.1.0 the MCP starts in read-only mode. The 10 read/report/targeting tools are always exposed, but the 8 mutating tools (create/update campaigns, ad groups, ads, and bulk pause/enable) are hidden from the tool list and refused at call time unless REDDIT_ADS_MCP_WRITE=true is set in the server's environment. This guards against a casual chat message accidentally mutating live ad spend. Enable writes deliberately, for the sessions where you actually intend to ship changes.
Copy config.example.json to config.json and fill in defaults:
{
"reddit_api": {
"base_url": "https://ads-api.reddit.com/api/v3",
"auth": {
"client_id": "",
"client_secret": "",
"refresh_token": "",
"user_agent": "reddit-ad-mcp/1.0"
}
},
"defaults": {
"account_id": "",
"business_id": "",
"report_metrics": ["impressions", "clicks", "spend", "ctr", "cpc", "ecpm"],
"date_range_days": 7
}
}
Environment variables take precedence over config file values.
{
"mcpServers": {
"reddit-ads": {
"command": "node",
"args": ["/path/to/mcp-reddit-ads/dist/index.js"],
"env": {
"REDDIT_CLIENT_ID": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_CLIENT_ID -w)",
"REDDIT_CLIENT_SECRET": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_CLIENT_SECRET -w)",
"REDDIT_REFRESH_TOKEN": "$(security find-generic-password -a reddit-ads-mcp -s REDDIT_REFRESH_TOKEN -w)"
}
}
}
}
Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
| Tool | Description |
|---|---|
reddit_ads_get_client_context | Get account info and verify API connectivity |
reddit_ads_get_accounts | List all ad accounts accessible to the authenticated user |
| Tool | Description |
|---|---|
reddit_ads_get_campaigns | List campaigns with optional status filter |
reddit_ads_get_ad_groups | List ad groups for a campaign |
reddit_ads_get_ads | List ads for an ad group |
reddit_ads_get_performance_report | Aggregated performance metrics for campaigns/ad groups/ads |
reddit_ads_get_daily_performance | Day-by-day performance breakdown |
| Tool | Description |
|---|---|
reddit_ads_create_campaign | Create a new ca |