Snapchat Ads MCP Server
Provides tools for managing and analyzing Snapchat Ads campaigns, including listing accounts, campaigns, ad squads, and ads; retrieving performance stats (ROAS, CPA, CTR, etc.); pausing/activating entities; updating campaign budgets; and managing creatives.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Snapchat Ads MCP Server Give me a 7-day performance report for my top campaign"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Snapchat Ads MCP Server
A free, open-source Model Context Protocol (MCP) server that connects Claude AI directly to your Snapchat Ads account — enabling live campaign analysis and real actions without leaving your chat.
What It Does
Capability | Tools |
Analyze | Account report, campaign stats, ad squad breakdown, creative performance |
Act | Pause/activate campaigns & ad squads, update budgets, rename campaigns |
Metrics | ROAS, CPA, CTR, eCPM, swipe-up rate, video views, avg screen time |
No CSV exports. No manual copy-paste. Just ask Claude in plain language.
Related MCP server: Google Ads MCP
Quick Demo
"Give me a performance report for last 7 days"
"Pause all underperforming ad squads"
"What's my ROAS across all active campaigns?"
"Update daily budget for campaign X to $100"Requirements
Python 3.10+
Snapchat Business Account
Snapchat Marketing API credentials (free — see setup below)
Install
Option A — PyPI (Recommended, 1-click)
pip install snapchat-ads-mcpOr run directly without installing (requires uv):
uvx snapchat-ads-mcpClaude Desktop config with PyPI install:
{
"mcpServers": {
"snapchat-ads": {
"command": "uvx",
"args": ["snapchat-ads-mcp"],
"env": {
"SNAPCHAT_CLIENT_ID": "your_client_id",
"SNAPCHAT_CLIENT_SECRET": "your_client_secret"
}
}
}
}Option B — Manual Setup
git clone https://github.com/saadsh0/snapchat-ads-mcp
cd snapchat-ads-mcp
pip install -r requirements.txtSetup
Step 1 — Clone & Install
git clone https://github.com/saadsh0/snapchat-ads-mcp
cd snapchat-ads-mcp
pip install -r requirements.txtStep 2 — Get Snapchat API Credentials (Free)
Go to business.snapchat.com
Navigate to Business Details → OAuth Apps → New App
Set redirect URI to
https://example.comCopy your Client ID and Client Secret
⚠️ Use Business Manager to create the app — NOT the Developer Portal
Step 3 — Set Environment Variables
export SNAPCHAT_CLIENT_ID=your_client_id
export SNAPCHAT_CLIENT_SECRET=your_client_secretOr create a .env file (see .env.example).
Step 4 — Authorize Your Account (One Time)
python auth_setup.pyThis opens Snapchat in your browser → you click Allow → you paste the redirect URL → your org is auto-detected and locked into config → tokens saved. Never needed again.
Step 5 — Connect to Claude Desktop
Add this to your claude_desktop_config.json:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"snapchat-ads": {
"command": "python3",
"args": ["/full/path/to/snapchat-ads-mcp/server.py"],
"env": {
"SNAPCHAT_CLIENT_ID": "your_client_id",
"SNAPCHAT_CLIENT_SECRET": "your_client_secret"
}
}
}
}Restart Claude Desktop. Done.
Available Tools
Tool | Description |
| List all ad accounts — start here |
| All campaigns with budget & status |
| Ad squads with targeting & bid info |
| Individual ads |
| Stats for any campaign / ad squad / ad |
| Full account-level summary |
| Pause or activate any entity |
| Change daily budget or lifetime cap |
| List creative assets |
Example Prompts
List all my Snapchat ad accounts
Give me a 7-day performance report for account [ID]
Which campaigns have the highest CTR this week?
Pause the Indonesia ad squad — CTR is too low
Update campaign [ID] daily budget to $150
Compare performance across all active ad squads
Rename campaign [ID] to [new name]Budget Values (Micro-Dollars)
Snapchat API uses micro-dollars: $1 = 1,000,000
USD | Micro-dollars |
$10 | 10,000,000 |
$50 | 50,000,000 |
$100 | 100,000,000 |
Antigravity / n8n Integration
See AGENT_FLOWS.md for connecting this MCP to Antigravity agents for automated reporting and optimization workflows.
Agency / Multi-Client Setup
Each client gets their own isolated config with their own tokens and org ID.
Step 1 — Run auth once per client
python auth_setup.py --client skyline
python auth_setup.py --client fantasticEach run saves to with org ID locked automatically.
Step 2 — Add one entry per client in claude_desktop_config.json
{
mcpServers: {
snapchat-skyline: {
command: python3,
args: [/full/path/to/server.py],
env: {
SNAPCHAT_CLIENT_ID: your_app_id,
SNAPCHAT_CLIENT_SECRET: your_secret,
SNAPCHAT_CONFIG_FILE: /full/path/to/clients/skyline/config.json
}
},
snapchat-fantastic: {
command: python3,
args: [/full/path/to/server.py],
env: {
SNAPCHAT_CLIENT_ID: your_app_id,
SNAPCHAT_CLIENT_SECRET: your_secret,
SNAPCHAT_CONFIG_FILE: /full/path/to/clients/fantastic/config.json
}
}
}
}✅ One OAuth app (your Sigma Digital credentials) works for all clients. Each client is fully isolated — wrong org access is blocked at the server level.
How it works in Claude
You'll see and as separate tool sets. Tell Claude which client to use and it only touches that org's data.
Troubleshooting
"CLIENT_ID not set" → Set env variables before running
"No tokens found" → Run python auth_setup.py
"Error 401" → Token expired, run python auth_setup.py again
"Error 403" → Check Snapchat Business account has Marketing API access
Tools not showing in Claude → Verify path in config and restart Claude Desktop
Built By
Sigma Digital — Performance Marketing & AI Automation Agency
License
MIT — free to use, modify, and distribute.
Available Tools
9 toolssnapchat_get_account_reportARead-only
Full account-level performance report with per-campaign breakdown. Uses breakdown=campaign to fetch all campaign stats in 2 API calls total (1 for campaign names, 1 bulk stats call) — same efficiency as Meta Ads API. Falls back to concurrent per-campaign calls if breakdown endpoint returns an error. Results cached per account + date range for 5 minutes.
Inputs: params (required). Returns: result
snapchat_get_ad_accountsARead-only
List all Snapchat Ad Accounts linked to this config. When an org_id is saved in config, only that org's accounts are returned — preventing cross-client data access in agency setups.
Inputs: no named parameters. Returns: result
snapchat_get_adsARead-only
List all Ads in an account. Excludes DELETED. Results cached for 5 minutes.
Inputs: params (required). Returns: result
snapchat_get_ad_squadsARead-only
List all Ad Squads for an account or specific campaign. Excludes DELETED. Results cached for 5 minutes.
Inputs: params (required). Returns: result
snapchat_get_campaignsARead-only
List all campaigns for a Snapchat Ad Account with status and budget info. Returns ACTIVE, PAUSED, and COMPLETED campaigns — excludes DELETED only. Results cached for 5 minutes.
Inputs: params (required). Returns: result
snapchat_get_creativesARead-only
List all creatives in your ad account. Results cached for 5 minutes.
Inputs: params (required). Returns: result
snapchat_get_performance_statsARead-only
Get performance statistics for a campaign, ad squad, or ad. Returns: impressions, swipe-ups, spend, CTR, eCPM, video views, conversions, ROAS. Results cached per entity + date range for 5 minutes.
Inputs: params (required). Returns: result
snapchat_update_campaign_budgetA
Update the daily budget or lifetime spend cap of a campaign. $1 = 1,000,000 micro-dollars. Example: $50/day = 50000000. Automatically clears cached data for the account after the update.
Inputs: params (required). Returns: result
snapchat_update_statusAIdempotent
Pause or activate a campaign, ad squad, or ad. Automatically clears cached data for the account after the update.
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct entity or operation (accounts, campaigns, ad squads, ads, creatives, performance stats, budget update, status update, and account report). No two tools have overlapping purposes, making selection unambiguous.
All tools follow a consistent 'snapchat_{verb}_{noun}' pattern with snake_case. Verbs are either 'get' for retrieval or 'update' for modification, ensuring predictability.
With 9 tools, the set is well-scoped for an ads platform. It covers key entities and operations without being overwhelming or too sparse.
The tool set provides read operations for all major entities and updates for budget and status, but lacks create/delete functionality for campaigns, ad squads, ads, and creatives, which are common advertising operations.
Maintenance
Related MCP Connectors
Ask Claude about your ads on 8 platforms. Connect an ad account first; free plan, no card.
Ask Claude about your ads: Meta, Google, TikTok, LinkedIn, GA4 & Shopify. No AI credits.
Manage Google, Meta, TikTok, Snapchat and LinkedIn ads, plus GA4, Tag Manager and Search Console, by chat from Claude or ChatGPT. Spend increases need your confirmation first.
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.5ISC
- AlicenseNot gradedqualityDmaintenanceA tool that connects Google Ads with Claude AI, allowing users to analyze advertising data through natural language conversations and access campaign information, performance metrics, keyword analytics, and ad management.58 PyPI723MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to your Google Ads account, allowing you to analyze and manage campaigns, ad groups, and keywords using natural language.MIT
- AlicenseNot gradedqualityCmaintenanceConnects Claude to Meta Ads, enabling full management of ad accounts including campaigns, creatives, budgets, and reporting. Handles authentication, token minting, and MCP server registration automatically.MIT