Skip to main content
Glama
Snapchat Ads MCP Server

Snapchat Ads MCP Server

by saadsh0

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

pip install snapchat-ads-mcp

Or run directly without installing (requires uv):

uvx snapchat-ads-mcp

Claude 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.txt

Setup

Step 1 — Clone & Install

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

  2. Navigate to Business Details → OAuth Apps → New App

  3. Set redirect URI to https://example.com

  4. Copy 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_secret

Or create a .env file (see .env.example).

Step 4 — Authorize Your Account (One Time)

python auth_setup.py

This 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

snapchat_get_ad_accounts

List all ad accounts — start here

snapchat_get_campaigns

All campaigns with budget & status

snapchat_get_ad_squads

Ad squads with targeting & bid info

snapchat_get_ads

Individual ads

snapchat_get_performance_stats

Stats for any campaign / ad squad / ad

snapchat_get_account_report

Full account-level summary

snapchat_update_status

Pause or activate any entity

snapchat_update_campaign_budget

Change daily budget or lifetime cap

snapchat_get_creatives

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 fantastic

Each 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 tools
snapchat_get_account_reportA
Read-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_accountsA
Read-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_adsA
Read-only

List all Ads in an account. Excludes DELETED. Results cached for 5 minutes.

Inputs: params (required). Returns: result

snapchat_get_ad_squadsA
Read-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_campaignsA
Read-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_creativesA
Read-only

List all creatives in your ad account. Results cached for 5 minutes.

Inputs: params (required). Returns: result

snapchat_get_performance_statsA
Read-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_statusA
Idempotent

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

    A4.1/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent 'snapchat_{verb}_{noun}' pattern with snake_case. Verbs are either 'get' for retrieval or 'update' for modification, ensuring predictability.

    Tool Count5/5

    With 9 tools, the set is well-scoped for an ads platform. It covers key entities and operations without being overwhelming or too sparse.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      5
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 PyPI
      723
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude Desktop to your Google Ads account, allowing you to analyze and manage campaigns, ad groups, and keywords using natural language.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects 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