snapchat-ads-mcp

# 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. --- ## 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) ```bash pip install snapchat-ads-mcp ``` Or run directly without installing (requires `uv`): ```bash uvx snapchat-ads-mcp ``` Claude Desktop config with PyPI install: ```json { "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 ```bash git clone https://github.com/saadsh0/snapchat-ads-mcp cd snapchat-ads-mcp pip install -r requirements.txt ``` --- ## Setup ### Step 1 — Clone & Install ```bash git clone https://github.com/saadsh0/snapchat-ads-mcp cd snapchat-ads-mcp pip install -r requirements.txt ``` ### Step 2 — Get Snapchat API Credentials (Free) 1. Go to [business.snapchat.com](https://business.snapchat.com) 2. Navigate to **Business Details → OAuth Apps → New App** 3. Set redirect URI to `https://example.com` 4. Copy your **Client ID** and **Client Se…