How to Connect Snapchat Ads to Gemini via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Snapchat Ads, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Snapchat Ads + Gemini

Let your AI work with your Snapchat ads: list organizations, ad accounts, campaigns, ad squads, ads, creatives and audiences, read impressions, swipes and spend per day or in total, and pause or restart a campaign after your confirmation. Signed in through an OAuth app of your own in Snap Business Manager.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

SNAPCHAT_CLIENT_ID, SNAPCHAT_CLIENT_SECRET

Step 1 — Get credentials

1. Sign in at business.snapchat.com as an Organization Admin. Only admins see the OAuth app settings.
2. Open Business Details (or Business Settings) → OAuth Apps and create an app. Give it a name and set the Redirect URI to https://cloud.anythingmcp.com/api/mcp-oauth/callback. If you host AnythingMCP yourself, use https://your-anythingmcp-host/api/mcp-oauth/callback. Accept the Snap Developer Terms and the Snap Business Tools Terms.
3. Copy the Client ID into SNAPCHAT_CLIENT_ID and the Client Secret into SNAPCHAT_CLIENT_SECRET. The secret is shown only once; if you lose it, create a new app.
4. Install the connector, click Authorize with Provider on the connector page, sign in with the Snapchat account that has access to your ad accounts and approve.
5. Start with snapchat_list_organizations: it lists your organizations with their ad accounts, currency and time zone.

The Marketing API is open to every advertiser: there is no application or review by Snap.

Who sees what: the connector asks for the scope snapchat-marketing-api and sees what the signed-in user may see in Ads Manager. Ad accounts that user has no role on answer 403.

What it reads: organizations and ad accounts; campaigns with objective, schedule, daily budget and spend cap; ad squads (Snapchat's ad sets) with placement, optimization goal, bid, budget and targeting; ads with their review status and rejection reasons; creatives; and audience segments such as customer lists and lookalikes with their approximate size. Statistics give impressions, swipes, spend and other metrics for an ad account, campaign, ad squad or ad, as one total or per day (up to 31 days) or per hour (up to 7 days), and can be split by campaign, ad squad or ad.

Money in micro-currency: Snapchat states budgets, bids and spend in millionths of the account currency, so a spend of 12345678 is 12.35. The AI converts the figures before quoting them. Numbers become final 48 hours after the end of a day.

Asks before every change: snapchat_set_campaign_status pauses a campaign or turns it back on. Turning it on starts spending its budget, so the AI names the campaign, says what will happen and waits for your yes. Only the status changes; Snapchat then checks the whole campaign and refuses the change if something in it is invalid.

Switched off at install: snapchat_set_campaign_daily_budget. A budget change decides how much money is spent, so an administrator turns the tool on deliberately; the AI then shows the change and asks first as well.

Staying signed in: access tokens last one hour and are renewed automatically. Removing the user from the organization, or deleting the app, ends the sign-in; then click Authorize with Provider again.

Common errors: 401: the sign-in expired or was revoked; authorize again. 403: the user has no role on that organization or ad account. 400: Snapchat names the field in its message, for example when it refuses a status change; for statistics, ask for fewer metrics or a shorter period. 429: too many requests; wait and try again.

The connector does not create or delete campaigns, ad squads, ads or creatives, upload media or change targeting, and it does not cover the Conversions API, pixels, billing or invoices.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
4. Start prompting: Gemini CLI can now call the Snapchat Ads tools.

Available tools

Example prompts

• "How much did we spend on Snapchat last week per campaign, with impressions and swipes?"
• "Which of our ads were rejected in review, and why?"
• "Show me daily spend and swipes for the Summer Sale campaign from October 1 to October 14."
• "Pause the Back to School campaign. Tell me exactly what will happen first."
• "List our audience segments that can be targeted, with their approximate size."

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT