Report across campaigns and ad squads
Use normalized reporting at account, campaign, ad-group, and ad levels. Snapchat ad squads map to the ad-group level so your agent can compare the right entities.
Snapchat Ads MCP server
Snapchat Ads, from your AI agent.
Bring Snap campaign data into your agent with reporting that respects Snapchat’s native metrics. Review spend, swipes, and attributed purchases before planning a budget or delivery change.
Prefer to run it on your machine? Local setup for Snapchat Ads
What you can do with Snapchat Ads MCP
Interpret Snap metrics correctly
Read normalized clicks as swipes and conversions as attributed purchases. Reporting dates use the ad account’s timezone, not an arbitrary UTC day boundary.
Preview campaign budget changes
Inspect an existing daily budget or lifetime cap, then preview the adjustment. Campaign creation is paused by policy and does not imply a complete creative or ad-squad setup.
Prefer local setup for Snapchat Ads?
The npm CLI and MCP server run on your machine. You need Node.js 22.13 or newer, your own provider credentials, and permission to access the ad account.
- Install Adport
npm install -g adport - Connect Snapchat AdsThe wizard opens Snap authorization and verifies account discovery before saving a grant. Store-backed credentials persist rotated refresh tokens.
adport connect snapchat - Check your connectionCheck that the intended account appears before asking your agent to report on it. Never paste tokens, client secrets, or private keys into chat.
adport doctor adport accounts --provider snapchat - Register a local stdio clientFor Cursor, merge
claude mcp add --transport stdio adport -- adport mcp{"mcpServers":{"adport":{"command":"adport","args":["mcp"]}}}into your MCP configuration. ChatGPT uses the HTTP endpoint above instead of launching a local process.
Use Snapchat Ads from your agent.
Use the same Adport MCP endpoint and OAuth sign-in in each client. First connect your ad accounts in your Adport workspace. No platform secrets belong in chat.
Use Snapchat Ads in ChatGPT
Enable developer mode, then open Settings → Apps → Create. Choose OAuth and use the endpoint below.
https://app.adport.dev/mcpScan the tools, finish Adport authorization, and enable the new app in your chat.
Developer mode and custom apps must be enabled for your ChatGPT account or workspace. In newer layouts, enable Developer mode under Settings → Security and login, then use the + button in Plugins to create your app. ChatGPT connects over HTTP; the local stdio command is for clients that can launch a process.
Use Snapchat Ads in Codex
Run this command once and complete the browser authorization. Codex stores the MCP configuration and starts OAuth automatically.
codex mcp add adport --url https://app.adport.dev/mcpOnly if authorization did not start or you need to sign in again, run “codex mcp login adport”. Otherwise, check “codex mcp list” and ask Codex to list your ad accounts.
Use Snapchat Ads in Claude Code
Add Adport at user scope so it is available across your local projects.
claude mcp add --transport http --scope user adport https://app.adport.dev/mcpRun /mcp inside Claude Code if the browser authorization does not open automatically.
Use Snapchat Ads in Claude
Open Customize → Connectors → Add custom connector. Name it Adport and use the endpoint below.
https://app.adport.dev/mcpSelect Connect, approve the workspace, then enable Adport from the + menu in a conversation.
Use Snapchat Ads in Cursor
Add this server to ~/.cursor/mcp.json, then restart Cursor.
{
"mcpServers": {
"adport": {
"url": "https://app.adport.dev/mcp"
}
}
}Approve the browser sign-in when prompted. Cursor will keep the OAuth session refreshed.
Use Snapchat Ads in any MCP client
Add a remote MCP server in your client, name it Adport, and use the endpoint below. Choose OAuth or streamable HTTP if your client asks.
https://app.adport.dev/mcpApprove the browser sign-in when prompted. For a client without MCP OAuth, create an API key under Agent access instead.
Use the MCP URL from Agent access if you run your own Adport deployment. Client settings, workspace permissions, and advertising-platform approvals still apply. The Cloud waitlist below is separate from these connection instructions.
A suggestion is not a live change.
Try the write gateThe first mutation call returns a preview and a short-lived pending-operation token. Applying requires that token and the same arguments. Budget caps and protected accounts are checked by the policy engine; new campaigns are paused by policy.
Local operations are recorded in an append-only audit log. An approved preview is not a guarantee of provider acceptance, and a connected agent does not grant additional account permissions.
Snapchat Ads MCP questions
Why does Snapchat reporting call clicks “swipes”?
Snap’s native swipe metric is mapped to normalized clicks. It is not identical to every other platform’s click definition. Keep that distinction visible in cross-platform comparisons.
Can I use Snapchat Ads locally without Adport Cloud?
Yes. Install Adport from npm, connect your own Snapchat Ads credentials, and register the local MCP server with a stdio-compatible agent such as Claude Code or Cursor. Your provider may have its own approval, access, or billing requirements.
Why can I connect an account but not read a report or apply a change?
Account discovery, reporting, and mutations can require different permissions. Check the requested account, provider app scopes, advertiser eligibility, and environment. Start with adport doctor and the connection guide above. Do not bypass a denied operation by sharing secrets with the agent.