GuidesReddit Ads MCP

Reddit Ads MCP Server

Connect Claude, ChatGPT, or any AI tool to your Reddit Ads account. Manage campaigns, ad groups, ads, reports, audiences, pixels, and conversion events with natural language.

What is the Reddit Ads MCP?

The Pipeboard Reddit Ads MCP (Model Context Protocol) Server connects AI assistants like Claude, ChatGPT, and custom agents to the Reddit Ads v3 API. Manage campaigns, ad groups, ads, audiences, pixels, conversion events, and reports through natural language.

Instead of clicking through Reddit Ads Manager or hand-rolling API integrations, you get instant access to the full campaign lifecycle — promoting Reddit posts as ads, targeting communities and interests, running CAPI conversion uploads, and pulling time-series reports.

Key features:

29 pre-built tools covering campaigns, ad groups, ads, audiences, pixels, reports, and the Conversions API

Works with Claude Desktop, ChatGPT, Python, n8n, and any MCP client

Multi-account support: connect multiple Reddit OAuth users to one Pipeboard account

Promote organic Reddit posts as ads via post_id, or build shopping creatives

Targeting search across interests, subreddit communities, geolocations, devices, and carriers

CAPI conversion event uploads keyed off your Reddit pixel for measurement + optimization

Getting Started

Set up in under 2 minutes

1. Sign up for a Pipeboard account:

pipeboard.co/auth/signup →

2. Connect your Reddit Ads account:

pipeboard.co/connections →

You can connect multiple Reddit OAuth users — useful when an agency manages multiple Reddit business accounts on behalf of different brands.

3. Add the MCP server to Claude (or another MCP client):

https://reddit-ads.mcp.pipeboard.co/

Use this URL as a Streamable HTTP MCP server in your client. Authentication is handled automatically through your Pipeboard session.

Connect to Your AI Tool

The Reddit Ads MCP works with any MCP-compatible client. Just add the server URL and start managing your Reddit campaigns with natural language.

Claude Pro / Max

Recommended

1.Open claude.ai/settings/connectors
2.Click "Add custom connector"
3.URL: https://reddit-ads.mcp.pipeboard.co/

ChatGPT

Developer mode

1.Enable Developer mode in ChatGPT Settings
2.Settings → Apps → Advanced → Developer mode
3.Create app with MCP URL

Claude Code

CLI / VS Code

Run this command in your terminal:

claude mcp add --transport http pipeboard-reddit-ads https://reddit-ads.mcp.pipeboard.co/

Then type /mcp in Claude Code to authenticate with Pipeboard.

Alternative: use an API token for instant setup (no browser auth needed):

claude mcp add --transport http pipeboard-reddit-ads https://reddit-ads.mcp.pipeboard.co/?token=pk_...

Get your token at pipeboard.co/api-tokens

Claude Desktop JSON configuration:

Add this to your Claude Desktop MCP settings (Settings → MCP Servers → Add):

claude_desktop_config.json

{
  "mcpServers": {
    "reddit-ads": {
      "url": "https://reddit-ads.mcp.pipeboard.co/"
    }
  }
}

More integrations:

Python + LangChain

Build custom AI agents and automation

View guide →

n8n Automation

No-code workflow automation with MCP nodes

View guide →

Any MCP Client

Use the URL in any compatible client

View guide →

Tips for getting started

Browse our prompt library for ready-to-use prompts you can copy into Claude

Reddit ads typically promote an existing Reddit post (a t3_* post_id) — make sure the post you point at is approved and live before launching

Always start with list_reddit_ad_accounts to grab the ad_account_id every other tool requires

Try these prompts

Account Overview

"List my Reddit ad accounts and show me a CAMPAIGN_ID + DATE report of impressions, clicks, and spend for the last 7 days"

Community Targeting

"Find the top 5 subreddits related to home automation and create a paused ad group targeting them with a $10/day budget"

Lifecycle Bulk Action

"Pause every Reddit ad group that spent more than $50 over the last 7 days but has zero conversions"

Promote a Post

"Promote my Reddit post t3_12345 as a CLICKS ad inside ad_group 2500422923601141912 with click_url https://example.com — keep it PAUSED"

Available Tools

The Reddit Ads MCP provides 29 tools organized by category. All tools are available through natural language when connected to an AI assistant.

Account Management

list_reddit_ad_accounts

List accessible ad accounts across all connected Reddit OAuth users (chains /me/businesses → /businesses/{id}/ad_accounts)

list_reddit_businesses

List the Reddit business managers you have access to

list_reddit_funding_instruments

List funding instruments — needed when an account has multiple funding sources

Campaigns

get_reddit_campaigns

List campaigns in an ad account with objective, status, and budget

get_reddit_campaign

Fetch a single campaign by ID with full readback

create_reddit_campaign

Create a campaign — defaults to PAUSED so you can review before launching

update_reddit_campaign

Rename, change status, or update goal/budget on a campaign

delete_reddit_campaign

Soft-delete a campaign (Reddit requires ARCHIVED + 3-hour cooldown first)

Ad Groups

get_reddit_ad_groups

List ad groups, filter by campaign_id or specific ids

get_reddit_ad_group

Fetch a single ad group with full targeting and bidding readback

create_reddit_ad_group

Create an ad group with targeting (communities, interests, geo), bid strategy, and budget

update_reddit_ad_group

Update budget, bid, schedule, or targeting

delete_reddit_ad_group

Soft-delete an ad group (Reddit gates deletes for 3 hours after the last modification)

get_reddit_ads

List ads in an ad account

get_reddit_ad

Fetch a single ad by ID

create_reddit_ad

Create an ad — typically promotes an organic Reddit post via post_id (t3_*)

update_reddit_ad

Update ad name, status, click URL, or attached post/creative

delete_reddit_ad

Soft-delete an ad via configured_status=DELETED

change_reddit_status

Shorthand for ACTIVE/PAUSED/ARCHIVED/DELETED across campaigns, ad groups, and ads

Reports & Insights

get_reddit_report

Pull aggregated metrics — choose breakdowns (CAMPAIGN_ID, DATE, COMMUNITY, INTEREST, OS_TYPE, …) and fields (IMPRESSIONS, CLICKS, SPEND, CTR, CPC, CONVERSIONS, ROAS, …)

Audiences

list_reddit_custom_audiences

List custom audiences in an ad account

create_reddit_custom_audience

Create a customer-list, engagement, or pixel-based custom audience

list_reddit_saved_audiences

List saved targeting profiles (reusable across ad groups)

Pixels & Conversions API

list_reddit_pixels

List Reddit pixels in an ad account (required for CBO campaigns from 2026-07-13)

send_reddit_conversion_events

Upload server-side conversion events (CAPI) to a Reddit pixel for measurement + optimization

Lead Generation

list_reddit_lead_gen_forms

List native lead-generation forms in an ad account

create_reddit_lead_gen_form

Create a lead form with custom questions, privacy policy, and prompt

Targeting Discovery

search_reddit_targeting

Search interests, subreddit communities, geolocations, named locations, carriers, or devices — returns the IDs you plug into ad group targeting

Supported Ad Formats

Reddit ads typically promote an existing Reddit post. Pass the post's post_id (a t3_* identifier) to create_reddit_ad — Reddit renders the ad in the same shape as the source post:

Text Post

Headline + body text. Best for thought-leadership and community engagement campaigns.

Single Image

Square or landscape image with a headline. The Reddit equivalent of an in-feed display ad.

Video

Up to 15-minute MP4 video. Reddit auto-plays muted in-feed and unmutes on tap.

Gallery

Up to 20 images in a swipeable carousel — useful for storytelling and product reveals.

Link Post

Headline + outbound link. Best for driving traffic to landing pages.

Shopping Creative

Catalog-driven shopping ad with call-to-action, hero card, and product tiles. Pass shopping_creative on create_reddit_ad.

Campaign Objectives

Reddit campaign objectives passed to create_reddit_campaign:

CLICKS

Drive traffic to a landing page

CONVERSIONS

Optimize for pixel-tracked conversions

IMPRESSIONS

Maximize reach at the lowest CPM

VIDEO_VIEWABLE_IMPRESSIONS

Maximize viewable video views

APP_INSTALLS

Drive mobile app installs

CATALOG_SALES

Sell products from a Reddit product catalog

LEAD_GENERATION

Collect leads via in-feed lead-gen forms

Best Practices

Call list_reddit_ad_accounts first — every other tool needs the ad_account_id it returns
When you have multiple connected Reddit OAuth users, pass connection_id to disambiguate which one owns the account
Reddit ads default to PAUSED on create — review the ad group/ad before flipping to ACTIVE
For DAILY_SPEND ad groups, Reddit enforces a $5/day minimum and requires bid_value < daily budget — start higher than you expect
Use search_reddit_targeting to find subreddit community IDs before building your targeting block — community names alone do not work
For reports, ends_at must be hour-aligned (YYYY-MM-DDTHH:00:00Z) — sub-hour timestamps return 400
Soft-delete via change_reddit_status → DELETED, but expect a 3-hour cooldown between modification and delete on campaigns
Promoted-post ads need an approved t3_* post in the targeted subreddit — verify the post is live before launching

Support & Documentation

Need help?

Browse all guides - Step-by-step tutorials and workflows Meta Ads MCP Server - If you also manage Meta campaigns Google Ads MCP Server - If you also manage Google campaigns TikTok Ads MCP Server - If you also manage TikTok campaigns Snap Ads MCP Server - If you also manage Snap campaigns Contact support - Get help from our team

Ready to connect your AI tools to Reddit Ads?

Get started with the Reddit Ads MCP in under 2 minutes.