Skip to main content
All connectors
qbash Connectors / Reddit Ads

Reddit Ads MCP serverand Python AI tasks

qbash hosts a Reddit Ads MCP server you can use in Claude, ChatGPT, Codex, Cursor, Grok Bot and Muse. Developers use qbash Tasks to write cloud-hosted Python functions that pair Reddit Ads with models such as Claude and GPT.

Add the qbash MCP

Use Reddit Ads from Claude Code, Codex, Cursor and other MCP clients. Connect Reddit Ads in qbash, and your agent can work with its data and build Tasks that call it.

claude mcp add --transport http qbash https://mcp.qbash.com/mcp

Then run /mcp in Claude Code and sign in with qbash.

  • List businesses, ad accounts and funding instruments
  • Pull performance reports for campaigns, ad groups and ads
  • Create paused campaigns, ad groups and ads
  • Create image, video and structured posts for ad creatives
  • Build and update custom and lookalike audiences
  • Send conversion events and data-deletion requests
Read the docs

Write a Reddit Ads task in Python

A qbash Task is a Python function hosted in the cloud. Python is the runtime and defines the process, and built-in inline prompts run on leading models such as Claude, GPT, Gemini and Grok.

Run a Task on a schedule, from an HTTP request or when a connected app sends an event. Your agents and chat tools call it over MCP.

Each run is logged with its inputs and results, and you can turn data logging off for any Task. Every Task has version control, and each run is locked to the version it ran.

Compare each campaign's cost per purchase across the week

get_report merges every page of the report into one list of rows. An inline prompt totals each campaign and names those whose cost per purchase moved most.

main.py
report = qbash.integrations.reddit_ads.get_report(
ad_account_id="your-ad-account-id",
starts_at="2026-10-13",
ends_at="2026-10-20",
fields=["IMPRESSIONS", "CLICKS", "CTR", "SPEND", "CPC", "CONVERSION_PURCHASE_CLICKS", "CONVERSION_PURCHASE_ECPA"],
breakdowns=["CAMPAIGN_ID", "DATE"],
fetch_all=True,
)
rows = report["metrics"]
if rows:
review = qbash.ai.run_prompt(
slug="reddit-ads-weekly-review",
variables={"rows": json.dumps(rows)},
)
qbash.output({"review": review, "truncated": report["truncated"]})
else:
qbash.output("Reddit returned no delivery for this ad account in the date range.")
Sample get_report response
{
"status": "success",
"metrics": [
{
"campaign_id": "2087561234567890123",
"date": "2026-10-13",
"impressions": 48210,
"clicks": 392,
"ctr": 0.00813,
"spend": 214560000,
"cpc": 547346,
"conversion_purchase_clicks": 11,
"conversion_purchase_ecpa": 19505454
},
{
"campaign_id": "2087561234567890123",
"date": "2026-10-14",
"impressions": 51874,
"clicks": 418,
"ctr": 0.00806,
"spend": 229840000,
"cpc": 549856,
"conversion_purchase_clicks": 9,
"conversion_purchase_ecpa": 25537777
},
{
"campaign_id": "2091234567890123456",
"date": "2026-10-13",
"impressions": 12450,
"clicks": 87,
"ctr": 0.00699,
"spend": 61200000,
"cpc": 703448,
"conversion_purchase_clicks": 0,
"conversion_purchase_ecpa": null
}
],
"metrics_updated_at": "2026-10-20T06:12:00Z",
"total_count": 3,
"pages_fetched": 1,
"truncated": false,
"next_cursor": null
}

Custom MCP server

Build a custom MCP server with Reddit Ads

Create a hosted MCP server that combines Reddit Ads tools with your other connectors, Tasks and memory folders. You choose each tool it exposes, so a server can share Reddit Ads reads with write tools left off.

Share the server with your team, and each person adds it to the client they already use.

How to set it up

  1. Connect Reddit Ads on the qbash Connectors page.
  2. Create an MCP server and add the Reddit Ads tools you want to share.
  3. Paste the server URL into your client. It connects with OAuth or an access token.

Ways to use Reddit Ads

Pause costly ad groups

Report cost per conversion by ad group each morning and pause the ad groups that run over a target you set.

Sync a customer list

Read new customers from your CRM and add them to a Reddit custom audience. qbash hashes the emails before upload.

Build a Reddit Ads task

Write it in Python with AI steps, or describe it to your coding agent through the qbash MCP.