Snapchat Ads MCP · Updated September 5, 2026
Snapchat Ads MCP Server: run your Snapchat Ads from Claude or ChatGPT
Paste one link into Claude or ChatGPT, sign in with Snapchat, and your AI can read and manage your Snapchat Ads account — campaigns, ad squads, creatives, spend, swipes 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 Snapchat, pick your workspace. Open a new chat and ask: “Which Snapchat ad squads had the highest swipe-up rate this month?”
01 — Overview
What this Snapchat 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 Snapchat. No developer app, no Business Manager app review, no token, no Python, no server to run.
- Read tools for ad accounts, stats, campaigns, ad squads, ads and creatives, 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 (Snapchat Ads MCP)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over Streamable HTTP
- Auth
- OAuth 2.0 (Snapchat sign-in, one Ryze workspace per connection)
- Hosting
- Hosted by Ryze AI — nothing to install or run
- Snapchat 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 Snapchat Ads MCP server turns your ad account into a set of those tools, so an assistant can pull stats by ad squad, rank creatives by swipe-up rate or pause a campaign from a chat instead of Snapchat Ads Manager. Snap publishes a Marketing API but no official MCP server; the few community servers are local processes you configure with your own Business Manager app and credentials. This one is hosted, so the whole setup is a URL and a Snapchat sign-in. The comparison further down covers each route.
/01
Managed Snapchat OAuth
Browser sign-in with Snapchat, tokens exchanged and refreshed server-side. No Business Manager app, no app review, no long-lived token to guard.
/02
Stats at every level
Impressions, swipes, spend, video views, quartiles, attachment metrics and conversion events at account, campaign, ad-squad or ad level, by hour, day or lifetime.
/03
Full object reads
Campaigns, ad squads, ads, creatives and media with objective, status, budget, bid, placement, targeting and schedule.
/04
Approval-gated writes
Change budgets, bids, schedules and status, or create campaigns, ad squads and ads, through per-tool approval. Deletes use a separate, explicit path.
/05
Creative performance
Rank Snap Ads, Story Ads and Collection Ads by swipe-up rate, view-through and cost per result to spot fatigue early.
/06
Targeting reads
Geos, demographics, interests, lifestyle categories and custom audiences an ad squad targets, and the options available.
/07
Multi-account
Discover every organization and ad account the login can reach and pass the ad account 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 Snapchat Ads tools cover
Every call takes an ad_account_id. The exact tool names appear in your client’s tool list the moment Snapchat 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 organization and ad account the signed-in Snapchat login can reach, with currency and timezone. The assistant calls this first. | none |
Account summary | read | Spend, impressions, swipes, conversions, CPA and ROAS for a date range in one call. | ad_account_id · start_time · end_time |
Stats | read | Any Marketing API stats query: entity level, granularity (TOTAL, DAY, HOUR), fields, breakdowns, conversion source and date range. | ad_account_id · level · granularity · fields · breakdown · start_time · end_time |
Campaign, ad squad and ad reads | read | Objects with objective, status, budget, bid, optimization goal, placement, targeting and schedule. | ad_account_id · filters |
Creative and media reads | read | Creatives (Snap Ad, Story Ad, Collection Ad) and media assets with type, status and attachment. | ad_account_id · filters |
Audience and pixel reads | read | Custom and lookalike audiences with size and status, and the Snap Pixel with its events. | ad_account_id |
Status, budget and bid updates | write | Activate or pause, or change budget, bid, schedule and targeting on campaigns and ad squads. | ad_account_id · id · fields |
Campaign, ad squad and ad creation | write | Create campaigns and ad squads with objective, budget, bid, placement, targeting and schedule, and ads from existing creatives. | ad_account_id · body |
Delete | write | Delete campaigns, ad squads 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 Snapchat login with a member role on the organization that owns the ad account in Snapchat Business Manager.
- 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 Snap Business Manager app, app review or a Marketing API 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 Snapchat Ads once under Workspace Settings → Integrations in Ryze (it opens the Snapchat 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 Snapchat Ads spend, impressions, swipes 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 Snapchat Ads spend, impressions, swipes and conversions by campaign.”
- >“Build my Monday Snapchat report: spend, cost per swipe, top 5 ads, and what to fix.”
- >“Show daily spend and swipe-up rate for the last 30 days as a table I can chart.”
Creative
- >“Rank my active Snap Ads by swipe-up rate and flag the ones decaying over 4 weeks.”
- >“Which creatives have a video view-through under 10% and spend over $200 this month?”
- >“Compare Story Ads vs single Snap Ads on cost per purchase, last 30 days.”
Structure
- >“List every ad squad with its optimization goal, bid and daily budget.”
- >“Which ad squads target lookalike audiences, and how big are they?”
- >“Show the Snap Pixel events firing this week.”
Changes (approval-gated)
- >“Raise the daily budget on the best-ROAS ad squad by 20% — show me the plan first.”
- >“Pause every ad squad with cost per swipe over $1 and spend over $100 this month.”
- >“Create a paused Conversions campaign with a $50 daily budget, US, 18–34, using the three top creatives.”
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
Stats 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 Marketing API terms and the server runs it as a stats query or an object update. Three that come up daily:
Campaign stats, last 30 days
{
"ad_account_id": "…",
"level": "campaign",
"granularity": "TOTAL",
"fields": ["impressions", "swipes", "spend", "video_views",
"conversion_purchases", "conversion_purchases_value"],
"start_time": "2026-08-06T00:00:00.000-07:00",
"end_time": "2026-09-05T00:00:00.000-07:00"
}Snapchat reports money in micro-currency: spend 25000000 = $25.00. Times are ISO timestamps on hour boundaries in the account timezone.
Daily ad-squad stats for one campaign
{
"ad_account_id": "…",
"level": "adsquad",
"granularity": "DAY",
"fields": ["impressions", "swipes", "spend", "quartile_1", "quartile_3"],
"start_time": "2026-08-29T00:00:00.000-07:00",
"end_time": "2026-09-05T00:00:00.000-07:00"
}DAY granularity returns one row per day; HOUR is limited to short ranges, so long pulls are chunked.
Read ad squads, then an approval-gated budget change
// read
{ "ad_account_id": "…", "filters": { "campaign_id": "…" } }
// update (approval-gated)
{ "ad_account_id": "…",
"adsquad_id": "…",
"fields": { "daily_budget_micro": 60000000 } }daily_budget_micro 50000000 = $50.00. 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) | Snapchat Ads Manager UI only |
|---|---|---|---|
| Runtime | None — remote HTTP | Local Node or Python process you run | None — a browser |
| Credentials you manage | Snapchat sign-in only | Business Manager app + app review + token | Your Snapchat login |
| When the API version changes | Ryze updates the server | You wait for a repo update | Snap |
| Reporting | Stats tool at every level, cross-platform in one chat | Varies by project | Dashboard exports |
| Platforms | Snapchat + Google Ads, Meta, TikTok, GA4, Search Console, Shopify | Snapchat only | Snapchat 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 Marketing API. Snap has not shipped an official MCP server, so the practical choice for everyone else is this hosted server, which also puts Snapchat 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 Snapchat'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 Snapchat campaigns and ad squads cannot be restored, so deletion only runs on an item-by-item approved list. Pausing is the reversible path.
Revoke any time
Disconnect Snapchat Ads under Workspace Settings → Integrations in Ryze, or remove the app under Snapchat Business Manager → Business Details → Apps.
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 Marketing API access. Self-hosted servers need a Business Manager app, app review and a token you refresh. |
| Money fields | Spend, budgets and bids are micro-currency: divide by 1,000,000. Currency and timezone come from the ad account. |
| Stats ranges | Start and end times must sit on hour boundaries in the account timezone. HOUR granularity covers short ranges only; the assistant chunks long pulls and uses DAY or TOTAL. |
| Reporting freshness | Snapchat stats can lag a few hours; today's numbers are partial until the account's day closes. |
| Budget rules | Snap enforces minimum daily budgets per ad squad (typically $5 in USD at the ad-squad level, $20 at campaign level where set) and minimum bids per goal; the assistant validates before proposing a change. |
| Learning | Ad squads recalibrate after large bid or budget changes; the assistant keeps single changes under about 20–30% unless told otherwise. |
| Creatives | Ads reference creatives already in the account; new creatives and media uploads go through Snap'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 Snapchat tools, only Google and Meta | Snapchat 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 | Micro-currency. | Divide spend, daily_budget_micro and bid_micro by 1,000,000. |
| Stats request rejected for the time range | Times not on an hour boundary, or the range too long for HOUR. | Round to the hour in the account timezone and use DAY or TOTAL for long ranges. |
| Numbers don't match Ads Manager | Different conversion source or attribution window. | Ask for the same window and conversion source 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
Snapchat Ads MCP server questions
What is the Snapchat Ads MCP server?
It is an MCP (Model Context Protocol) server that exposes a Snapchat Ads account as tools an AI assistant can call. Ryze AI's Snapchat Ads MCP server is hosted and remote: you add one URL to Claude, ChatGPT, Cursor or Claude Code, connect Snapchat via OAuth, and the assistant can pull stats at every level, read campaigns, ad squads and creatives, and make approval-gated changes.
What is the Snapchat 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 Snapchat have an official Ads MCP server?
No. Snap publishes a Marketing API for developers but, as of September 2026, no official MCP server. Community servers on GitHub wrap the Marketing API as local processes. Ryze AI's hosted server connects Snapchat Ads to Claude, ChatGPT and other MCP clients without any of that setup.
Do I need a Snap Business Manager app or token?
No. The hosted server runs on Ryze AI's own Marketing API access. You sign in with a Snapchat login that has a member role on the organization and you are done. Self-hosted servers require you to create a Business Manager app, pass review, generate and refresh a token and keep a local process running.
What can the Snapchat Ads tools do?
Read: discover ad accounts, pull account summaries and stats at account, campaign, ad-squad or ad level by hour, day or lifetime, and read campaigns, ad squads, ads, creatives, media, audiences and the Snap Pixel. Write, with approval: change status, budgets, bids, schedules and targeting, create campaigns, ad squads and ads from existing creatives, and delete objects from an explicit list.
Can the MCP server change my Snapchat 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 Snapchat objects cannot be restored.
How are budgets and spend expressed?
In micro-currency. A $50 daily budget is daily_budget_micro 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.
How do I pull Snapchat stats through MCP?
Ask in plain English or describe the stats query: the level (account, campaign, ad squad or ad), the granularity (TOTAL, DAY or HOUR), the fields you want such as impressions, swipes, spend, video views, quartiles or conversion events, and a date range on hour boundaries in the account timezone.
Can I use it with several ad accounts or clients?
Yes. The assistant lists every organization 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 Snapchat 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 Snapchat Ads MCP server secure?
Access is OAuth 2.0 only, so your Snapchat 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 Business Manager 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 Snapchat Ads tools after I connected?
Two common reasons. First, start a new chat — Claude and ChatGPT bind connectors when a conversation starts. Second, Snapchat 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 Snapchat next to Google, Meta and TikTok in one chat?
Yes. Those toolsets sit on the same endpoint, so one prompt can pull spend, swipe-up rate 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 · Snapchat Ads read + write tools · Live in ~60 seconds
Add Snapchat 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
