Snapchat Ads — Claude Code MCP server: ad accounts in chat
Wires your Snapchat ad accounts into an MCP client: 21 tools for reading campaigns and metrics, and 25 write tools that stay off until you turn them on.
claude mcp add --env SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> --env SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> --env SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> --env SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> --env SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> --transport stdio snapchat-ads -- npx -y @getmcpads/snapchat-ads-mcp-serverWhat Snapchat Ads does
The server talks to the Snap Marketing API itself. Requests go to adsapi.snapchat.com and accounts.snapchat.com and nowhere else. Reading covers campaigns, ad squads, ads and their performance. Writes are opt-in: only the exact value true in SNAPCHAT_ADS_ENABLE_WRITES exposes them, and anything else halts startup. Every write returns a preview until you pass confirm: true. New campaigns, ad squads and ads arrive paused.
SNAPCHAT_ADS_ACCOUNT_IDS is required and takes comma-separated ad account UUIDs. Organization IDs do not count. Any request or referenced entity outside those accounts is refused before it leaves your machine. You also need an OAuth app for the Snap Marketing API and a refresh token with the snapchat-marketing-api scope. There is no browser sign-in flow; renewed tokens live in memory, so a restart starts again from the refresh token in your config. Node.js 22.23.4, 24.22.1 or 26.12.1 and newer is the floor — older builds print a warning on stderr because these lines carry the October 2026 security fixes. Run npm run doctor to see which variables are set and whether your Node release qualifies; it never prints the values themselves.
Building from the v1.0.0 GitHub release means git clone, npm ci and npm run build, then pointing the client at node with the absolute path to dist/cli.js. The hosted creative galleries, alerts and MCP Apps UI are a separate product. This release ships the native API tools only.
What it helps with
- review a Snapchat ad account's campaigns and spend from chat
- stage a campaign change and inspect it before it applies
- keep the assistant inside a whitelist of ad accounts
- launch new campaigns paused for a manual check
- verify server config and Node version before wiring it up
Example prompts for the agent
- List active campaigns in the account with spend for the past week
- Draft a preview of a new ad squad and don't confirm it
- Create the campaign paused and show me the result
How to install Snapchat Ads
Platform CLI
claude mcp add --env SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> --env SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> --env SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> --env SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> --env SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> --transport stdio snapchat-ads -- npx -y @getmcpads/snapchat-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add snapchat-ads --env SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> --env SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> --env SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> --env SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> --env SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> -- npx -y @getmcpads/snapchat-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"snapchat-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/snapchat-ads-mcp-server"
],
"env": {
"SNAPCHAT_ADS_ACCOUNT_IDS": "<SNAPCHAT_ADS_ACCOUNT_IDS>",
"SNAPCHAT_ADS_ACCESS_TOKEN": "<SNAPCHAT_ADS_ACCESS_TOKEN>",
"SNAPCHAT_ADS_REFRESH_TOKEN": "<SNAPCHAT_ADS_REFRESH_TOKEN>",
"SNAPCHAT_ADS_CLIENT_ID": "<SNAPCHAT_ADS_CLIENT_ID>",
"SNAPCHAT_ADS_CLIENT_SECRET": "<SNAPCHAT_ADS_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"snapchat-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/snapchat-ads-mcp-server"
],
"env": {
"SNAPCHAT_ADS_ACCOUNT_IDS": "<SNAPCHAT_ADS_ACCOUNT_IDS>",
"SNAPCHAT_ADS_ACCESS_TOKEN": "<SNAPCHAT_ADS_ACCESS_TOKEN>",
"SNAPCHAT_ADS_REFRESH_TOKEN": "<SNAPCHAT_ADS_REFRESH_TOKEN>",
"SNAPCHAT_ADS_CLIENT_ID": "<SNAPCHAT_ADS_CLIENT_ID>",
"SNAPCHAT_ADS_CLIENT_SECRET": "<SNAPCHAT_ADS_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> -e SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> -e SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> -e SNAPCHAT_ADS_CLIENT_ID=<SNAPCHAT_ADS_CLIENT_ID> -e SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> snapchat-ads npx -y @getmcpads/snapchat-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Snapchat Ads
How do I install Snapchat Ads in Claude Code?
Run `claude mcp add snapchat-ads -e SNAPCHAT_ADS_ACCOUNT_IDS=<SNAPCHAT_ADS_ACCOUNT_IDS> -e SNAPCHAT_ADS_ACCESS_TOKEN=<SNAPCHAT_ADS_ACCESS_TOKEN> -e SNAPCHAT_ADS_REFRESH_TOKEN=<SNAPCHAT_ADS_REFRESH_TOKEN> -e SNAPCHAT_ADS_CLIENT_SECRET=<SNAPCHAT_ADS_CLIENT_SECRET> -- npx -y @getmcpads/snapchat-ads-mcp-server`, replacing the placeholders with your own credentials.
What does Snapchat Ads do?
It lets the assistant read Snapchat campaigns and metrics and propose changes to them. Changes need a preview and an explicit confirmation, and the write tools are off until enabled.
What do I need before running it?
A Snap Marketing API OAuth app with a refresh token, the ad account UUIDs in SNAPCHAT_ADS_ACCOUNT_IDS, and Node.js 22.23.4, 24.22.1 or 26.12.1 and newer.
