Reddit Ads MCP · Updated September 5, 2026
Reddit Ads MCP Server: run your Reddit Ads from Claude or ChatGPT
Paste one link into Claude or ChatGPT, sign in with Reddit, and your AI can read and manage your Reddit Ads account — campaigns, ad groups, community targeting, spend and conversions. No developer app, nothing to install, about a minute of setup. Everything below the link is the full reference for you and your AI agent.
https://connector.get-ryze.ai/mcp- 01Copy your MCP link:
https://connector.get-ryze.ai/mcp - 02In Claude go to Settings → Connectors → Add custom connector. Name it Ryze AI, paste the link, click Add. In ChatGPT it is Settings → Apps → Create app.
- 03Click Connect, sign in with Reddit, pick your workspace. Open a new chat and ask: “Which Reddit ad groups had the lowest cost per conversion this month?”
01 — Overview
What this Reddit Ads MCP server does
The short version
- One URL,
https://connector.get-ryze.ai/mcp, works in Claude, ChatGPT, Claude Code, Cursor and any MCP client. - Sign in with Reddit. No developer app, no Ads API access request, no token, no Python, no server to run.
- Read tools for ad accounts, reports, campaigns, ad groups, ads and targeting, plus approval-gated write tools for budgets, bids, status and new campaigns.
- Same endpoint carries Google Ads, Meta Ads, TikTok, GA4, Search Console and Shopify — 150+ tools in total.
- Free to connect. Paid Ads Autopilot is $89/mo flat if you want Ryze AI to run the optimizations for you.
- Server name
- Ryze AI (Reddit Ads MCP)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over Streamable HTTP
- Auth
- OAuth 2.0 (Reddit sign-in, one Ryze workspace per connection)
- Hosting
- Hosted by Ryze AI — nothing to install or run
- Reddit Ads tools
- Read + write (writes approval-gated)
- Also on this endpoint
- Google Ads, Meta Ads, TikTok, GA4, Search Console, Shopify — 150+ tools
- Developer app / token
- Not required
- Price
- Free to connect · Paid Ads Autopilot $89/mo flat
- Updated
- September 5, 2026
MCP (Model Context Protocol) is the open standard AI assistants use to call external tools. A Reddit Ads MCP server turns your ad account into a set of those tools, so an assistant can pull a report by community, compare interest targeting against keyword targeting or pause an ad group from a chat instead of Reddit Ads Manager. Reddit publishes an Ads API but no official MCP server; the few community servers are local processes you configure with your own developer app and Ads API credentials. This one is hosted, so the whole setup is a URL and a Reddit sign-in. The comparison further down covers each route.
/01
Managed Reddit OAuth
Browser sign-in with Reddit, tokens exchanged and refreshed server-side. No developer app, no Ads API access application, no long-lived token to guard.
/02
Reports with breakdowns
Spend, impressions, clicks, CTR, CPC, eCPM and conversion metrics at account, campaign, ad-group or ad level, broken down by date, community, country, placement or interest.
/03
Full object reads
Campaigns, ad groups, ads and their objective, funding, bid strategy, budget, schedule, targeting and status.
/04
Approval-gated writes
Change budgets, bids, schedules and status, or create new campaigns, ad groups and ads, through per-tool approval. Deletes use a separate, explicit path.
/05
Community and interest targeting
Read and adjust the subreddits, interests, keywords, geos and devices an ad group targets — the levers that decide Reddit performance.
/06
Creative and post reads
Promoted posts, headlines, thumbnails and destination URLs, so the assistant can rank creatives and reuse winners.
/07
Multi-account
Discover every ad account under the business and pass its ID per call for agency setups.
/08
Seven platforms, one URL
The same endpoint carries Google Ads, Meta Ads, TikTok, GA4, Search Console and Shopify toolsets — one login instead of seven servers.
02 — Tool reference
What the Reddit Ads tools cover
Every call takes an ad_account_id. The exact tool names appear in your client’s tool list the moment Reddit Ads is connected to the workspace; the table groups them by what they do. Write capabilities are approval-gated.
| Capability | Access | What it does | What you pass |
|---|---|---|---|
Ad account discovery | read | Every business and ad account the signed-in Reddit login can reach, with currency and timezone. The assistant calls this first. | none |
Account summary | read | Spend, impressions, clicks, conversions, CPA and ROAS for a date range in one call. | ad_account_id · start_date · end_date |
Report | read | Any Ads API report: breakdowns (date, campaign, ad group, ad, community, country, placement, interest), fields, filters and date range, paged. | ad_account_id · breakdowns · fields · filters · starts_at · ends_at · page |
Campaign, ad group and ad reads | read | Objects with objective, funding instrument, bid strategy, budget, schedule, targeting and status. | ad_account_id · filters · page |
Targeting reads | read | Communities, interests, keywords, geolocations and devices an ad group targets, and the available targeting options. | ad_account_id · ad_group_id |
Creative and post reads | read | Promoted posts and ad creatives with headline, thumbnail, destination URL and status. | ad_account_id · filters |
Status, budget and bid updates | write | Activate or pause, or change budget, bid, schedule and targeting on campaigns and ad groups. | ad_account_id · id · fields |
Campaign, ad group and ad creation | write | Create campaigns and ad groups with objective, budget, bid strategy, schedule and targeting, and ads from existing posts. | ad_account_id · body |
Delete | write | Delete campaigns, ad groups or ads. Only runs on an explicit, item-by-item approved list. | ad_account_id · id |
The same endpoint exposes the Google Ads, Meta Ads, TikTok, GA4, Search Console and Shopify toolsets. The cross-platform list lives in the advertising API & MCP tools reference; Google Ads and Meta have their own pages at Google Ads MCP and Meta Ads MCP.
03 — Prerequisites
What you need before you start
You need
- A Reddit login with access to the ad account in Reddit Ads Manager (Admin or Manager role on the business).
- A free Ryze AI account — created during the OAuth step if you don’t have one.
- An MCP client: Claude Pro, Team or Max (custom connectors are not on the free plan), ChatGPT Plus, Pro or Business with Developer mode, or Claude Code, Cursor, Windsurf, VS Code on any plan.
You don’t need
- A Reddit developer app, an Ads API access request or a token — the hosted server brings its own API access.
- A client ID and secret, a refresh-token job or a rate-limit backoff you maintain.
- Python, Node, a virtual environment, a
.envfile or a process to keep running.
04 — Setup
Install in every MCP client
All routes end in the same OAuth screen: sign in with Ryze AI, choose your workspace, click Allow. Connect Reddit Ads once under Workspace Settings → Integrations in Ryze (it opens the Reddit consent screen); the tools appear in the next chat. One connection maps to one workspace, so agencies with several client workspaces reconnect per workspace. Screenshots for the Claude route are in how to connect Claude to the Ryze AI MCP.
Claude (web and desktop)
- 01On claude.ai, click your avatar (bottom-left) → Settings.
- 02Open the Connectors tab and click Customize, then the + next to Connectors.
- 03Name: Ryze AI. Remote MCP server URL:
https://connector.get-ryze.ai/mcp. Click Add. - 04Click Connect on the new connector, sign in, pick your workspace and click Allow Claude to connect.
- 05A green confirmation lists the available tools. Start a new chat and ask your first question.
Requires Claude Pro, Team or Max. The Claude desktop app uses the same Settings → Connectors flow; if you prefer the config file, use the mcp-remote entry under “Claude Desktop config file” below.
ChatGPT
- 01Settings → Apps. Under Advanced settings, turn on Developer mode.
- 02Click Create app. Name: Ryze AI. MCP server URL:
https://connector.get-ryze.ai/mcp— choose Server URL, not Tunnel. - 03Authentication: OAuth. Tick the acknowledgment and click Create.
- 04On the authorization page choose Sign in with Ryze AI, pick your workspace and click Allow.
- 05Start a new chat: “Pull the last 7 days of Reddit Ads spend, impressions, CTR and conversions by campaign.”
Requires a ChatGPT plan that supports apps and connectors (Plus, Pro or Business).
Claude Code
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcpThen run /mcp inside Claude Code to complete the OAuth sign-in. Add --scope user to make it available in every project.
Cursor, Windsurf and any mcp.json client
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Save, then approve the OAuth prompt the client opens. Windsurf uses the key serverUrl instead of url.
VS Code (GitHub Copilot agent mode)
{
"servers": {
"ryze": {
"type": "http",
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Claude Desktop config file (optional)
{
"mcpServers": {
"ryze": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://connector.get-ryze.ai/mcp"]
}
}
}macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop; the first call opens the browser for OAuth. Most people won’t need this — Settings → Connectors does the same without Node.
05 — Usage
What to ask once connected
Reporting
- >“Pull the last 7 days of Reddit Ads spend, impressions, CTR and conversions by campaign.”
- >“Build my Monday Reddit report: spend, cost per conversion, top 5 ads, and what to fix.”
- >“Break last month's spend down by community — which subreddits actually converted?”
Targeting
- >“Compare interest targeting vs community targeting on cost per conversion, last 30 days.”
- >“Which communities have spend over $50 and zero conversions this month? Propose exclusions.”
- >“List every ad group with its targeted communities, geos and devices.”
Creative
- >“Rank my promoted posts by CTR and flag any with CTR under 0.3%.”
- >“Which headlines drove the most conversions across all ad groups?”
- >“Show the ads still in review and the ones rejected, with the reason if available.”
Changes (approval-gated)
- >“Move 20% of budget from the two worst ad groups to the best one — show me the plan first.”
- >“Pause every ad group with CTR under 0.3% and spend over $100 this month.”
- >“Create a paused Conversions campaign with a $50 daily budget targeting r/shopify, r/ecommerce and r/marketing in the US.”
Ready-made workflows: the media buyer’s guide to Claude, automating cross-platform ads with Claude MCP and MCP tools for ad campaign reporting.
06 — Request examples
Report requests you can describe in the chat
You rarely need to write these — the assistant builds them. When you want exact control, describe the request in Reddit Ads API terms and the server runs it as a report or an object update. Three that come up daily:
Campaign report, last 30 days
{
"ad_account_id": "t2_…",
"breakdowns": ["CAMPAIGN_ID"],
"fields": ["SPEND", "IMPRESSIONS", "CLICKS", "CTR", "CPC",
"CONVERSION_PURCHASE_TOTAL_ITEMS"],
"starts_at": "2026-08-06T00:00:00Z",
"ends_at": "2026-09-05T00:00:00Z"
}Reddit reports money in microcurrency: SPEND 25000000 = $25.00. Dates are ISO timestamps in the account timezone.
Community breakdown for one ad group
{
"ad_account_id": "t2_…",
"breakdowns": ["AD_GROUP_ID", "COMMUNITY"],
"fields": ["SPEND", "CLICKS", "CTR", "CONVERSION_PURCHASE_TOTAL_ITEMS"],
"filters": [{ "field": "AD_GROUP_ID", "operator": "EQUALS", "value": "…" }],
"starts_at": "2026-08-29T00:00:00Z",
"ends_at": "2026-09-05T00:00:00Z"
}Community, country, placement and interest breakdowns show where the spend lands; add DATE for daily rows.
Read ad groups, then an approval-gated budget change
// read
{ "ad_account_id": "t2_…",
"filters": { "campaign_id": "…" } }
// update (approval-gated)
{ "ad_account_id": "t2_…",
"ad_group_id": "…",
"fields": { "daily_budget": 60000000 } }Budgets and bids are microcurrency too: 50000000 = $50.00 per day. Updates need approval before they run.
07 — Compare
Hosted vs self-hosted vs Ads Manager
| What you operate | Ryze AI hosted server | Open source (GitHub) | Reddit Ads Manager UI only |
|---|---|---|---|
| Runtime | None — remote HTTP | Local Node or Python process you run | None — a browser |
| Credentials you manage | Reddit sign-in only | Developer app + Ads API access request + token | Your Reddit login |
| When the API version changes | Ryze updates the server | You wait for a repo update | |
| Reporting | Report tool with breakdowns, cross-platform in one chat | Varies by project | Dashboard exports |
| Platforms | Reddit + Google Ads, Meta, TikTok, GA4, Search Console, Shopify | Reddit only | Reddit only |
| Write approval controls | Per-tool, on by default | Varies by project | Manual |
Self-hosting is the right call when the data must never leave your machine or you are building your own agent on the raw Reddit Ads API. Reddit has not shipped an official MCP server, so the practical choice for everyone else is this hosted server, which also puts Reddit next to Google Ads, Meta Ads and TikTok Ads in one chat.
08 — Security & permissions
Safe by default
OAuth 2.0 only
You sign in on Reddit's page. Your password never touches Ryze, and tokens are refreshed server-side.
One workspace per connection
Each connection is authorized against a single Ryze workspace, chosen on the consent screen. Switching workspaces means reconnecting and starting a new chat.
Approval-gated writes
Read tools are automatic. In Claude, open Settings → Connectors → Ryze AI and keep every write and delete tool on 'Needs approval' — the recommended default for live accounts.
Deletes are separate and explicit
Deleted Reddit campaigns and ad groups cannot be restored, so deletion only runs on an item-by-item approved list. Pausing is the reversible path.
Revoke any time
Disconnect Reddit Ads under Workspace Settings → Integrations in Ryze, or remove the authorization under Reddit → User Settings → Privacy → Authorized applications.
Policies
Read the MCP privacy policy, MCP terms, security policy and MCP permissions best practices.
09 — Quotas & limits
What to know before a heavy session
| Developer app & tokens | Not yours to manage — the hosted server runs on Ryze AI's Reddit Ads API access. Self-hosted servers need a developer app, an Ads API access grant and a token you refresh. |
| Money fields | Spend, budgets and bids are microcurrency: divide by 1,000,000. Currency comes from the ad account. |
| Report ranges | Timestamps are ISO in the account timezone; the assistant splits long ranges into monthly chunks and pages through results. |
| Reporting freshness | Reddit reporting can lag a few hours; today's numbers are partial until the account's day closes. |
| Budget rules | Reddit enforces minimum daily budgets per ad group (typically $5 in USD) and minimum bids per objective; the assistant validates against them before proposing a change. |
| Learning | Ad groups recalibrate after large targeting, bid or budget changes; the assistant keeps single changes under about 20–30% unless told otherwise. |
| Creatives | Ads reference existing promoted posts; new post creation goes through Reddit's review before serving, which the API cannot skip. |
| Client plans | Claude custom connectors: Pro, Team or Max. ChatGPT connectors: Plus, Pro or Business with Developer mode. |
10 — Troubleshooting
Common errors and the fix
| Symptom | Cause | Fix |
|---|---|---|
| Tools don't show up in the chat | The chat was opened before the connector existed. | Start a new chat — Claude and ChatGPT bind connectors when a conversation starts. |
| No 'custom connector' option in Claude | Free Claude plan. | Custom connectors need Claude Pro, Team or Max. ChatGPT needs Plus, Pro or Business with Developer mode on. |
| No Reddit tools, only Google and Meta | Reddit Ads is not connected to this workspace. | Connect it under Workspace Settings → Integrations in Ryze, then start a new chat. |
| "ad_account_id is required" or the wrong account | No ad account chosen yet. | Ask for accessible ad accounts first and name one. |
| Spend looks a million times too big | Microcurrency. | Divide SPEND, budgets and bids by 1,000,000. |
| Report returns no rows | Range in the wrong timezone or before the campaign existed. | Use the account timezone and check the campaign schedule. |
| Numbers don't match Ads Manager | Different attribution window or conversion event. | Ask for the same window and the same conversion field Ads Manager shows. |
| A write action 'did nothing' | It is waiting for your approval. | Approve the tool call in the chat, or review the tool's setting under Settings → Connectors → Ryze AI. |
| Data from the wrong client account | The connection is authorized to another workspace. | Each connection is one Ryze workspace. Reconnect, pick the right workspace, and start a new chat. |
Still stuck? Email support@get-ryze.ai. Agencies juggling many accounts: MCP config for multiple ad accounts.
11 — FAQ
Reddit Ads MCP server questions
What is the Reddit Ads MCP server?
It is an MCP (Model Context Protocol) server that exposes a Reddit Ads account as tools an AI assistant can call. Ryze AI's Reddit Ads MCP server is hosted and remote: you add one URL to Claude, ChatGPT, Cursor or Claude Code, connect Reddit via OAuth, and the assistant can run reports with community breakdowns, read campaigns and targeting, and make approval-gated changes.
What is the Reddit Ads MCP server URL?
The server URL is https://connector.get-ryze.ai/mcp. It is a remote MCP server over Streamable HTTP with OAuth 2.0. The same endpoint serves the Google Ads, Meta Ads, TikTok, GA4, Search Console and Shopify toolsets, so one connector covers the whole ad stack. Each connection is authorized against one Ryze workspace.
Does Reddit have an official Ads MCP server?
No. Reddit publishes an Ads API for developers but, as of September 2026, no official MCP server. Community servers on GitHub wrap the Ads API as local processes. Ryze AI's hosted server connects Reddit Ads to Claude, ChatGPT and other MCP clients without any of that setup.
Do I need a Reddit developer app or Ads API token?
No. The hosted server runs on Ryze AI's own Ads API access. You sign in with a Reddit login that has access to the ad account and you are done. Self-hosted servers require you to create a developer app, request Ads API access, generate and refresh a token and keep a local process running.
What can the Reddit Ads tools do?
Read: discover ad accounts, pull account summaries and reports broken down by date, campaign, ad group, ad, community, country, placement or interest, and read campaigns, ad groups, ads, targeting and creatives. Write, with approval: change status, budgets, bids, schedules and targeting, create campaigns, ad groups and ads from existing posts, and delete objects from an explicit list.
Can the MCP server change my Reddit campaigns, or only read data?
Both. Read tools work the moment the connection completes. Write tools are approval-gated: in Claude you set each one to 'Needs approval' under Settings → Connectors → Ryze AI. Deletion is separate and only runs on an item-by-item approved list because deleted Reddit objects cannot be restored.
Can it show me which subreddits are converting?
Yes. The report tool supports a community breakdown, so one prompt returns spend, clicks, CTR and conversions per subreddit for any ad group or the whole account. From there the assistant can propose community exclusions or a new ad group built on the winners, both approval-gated.
How are budgets and spend expressed?
In microcurrency. A $50 daily budget is 50000000 and a SPEND of 25000000 is $25.00. The assistant converts on the way in and out; if you read raw values, divide by 1,000,000. The currency comes from the ad account.
Can I use it with several ad accounts or clients?
Yes. The assistant lists every business and ad account the login can reach and passes the ad account ID on each call. One connection maps to one Ryze workspace, so agencies keeping clients in separate workspaces reconnect per workspace and start a new chat.
What does the Reddit Ads MCP server cost?
Connecting is free — a Ryze AI account costs nothing to create and the connector has no per-call fee. Paid Ads Autopilot is $89/month flat with a 7-day free trial if you want Ryze AI to run the optimizations for you. On the client side you need a Claude plan that allows custom connectors (Pro, Team or Max) or a ChatGPT plan with connectors (Plus, Pro or Business).
Is the Reddit Ads MCP server secure?
Access is OAuth 2.0 only, so your Reddit password never touches Ryze. Each connection is scoped to one Ryze workspace, write and delete tools are approval-gated by default, and you can revoke access at any time from Reddit's authorized applications or from Workspace Settings → Integrations in Ryze. The MCP privacy policy, MCP terms and security policy are linked on this page.
Why doesn't Claude see the Reddit Ads tools after I connected?
Two common reasons. First, start a new chat — Claude and ChatGPT bind connectors when a conversation starts. Second, Reddit Ads must be connected to the workspace under Workspace Settings → Integrations in Ryze; a workspace with only Google connected shows only Google tools.
Can I report Reddit next to Google, Meta and TikTok in one chat?
Yes. Those toolsets sit on the same endpoint, so one prompt can pull spend, CTR and cost per conversion from all of them into one table, and GA4 or Search Console tools cover the downstream traffic.
12 — Compatibility
Works in every MCP client
13 — Related
Keep reading
One OAuth login · Reddit Ads read + write tools · Live in ~60 seconds
Add Reddit Ads to your AI today.
Free to connect. Upgrade to Paid Ads Autopilot ($89/mo flat, 7-day free trial) when you want Ryze AI to run the optimizations for you, 24/7.
2,000+ clients · 700+ agencies · $500M+ managed · No dev token · No server to run
