GuidesSnap Ads MCP

Snap Ads MCP Server

Connect Claude, ChatGPT, or any AI tool to your Snap Ads account. Manage campaigns, ad squads, creatives, segments, and pixels with natural language.

What is the Snap Ads MCP?

The Pipeboard Snap Ads MCP (Model Context Protocol) Server connects AI assistants like Claude, ChatGPT, and custom agents to the Snap Marketing API. Manage campaigns, ad squads, creatives, audience segments, and pixels through natural language.

Instead of clicking through Snap Ads Manager or building API integrations from scratch, you get instant access to campaign creation, ad squad bulk-budget updates, creative management, customer-list and lookalike segments, custom conversions, and more.

Key features:

35+ pre-built tools covering the full Snap Ads management lifecycle
Works with Claude Desktop, ChatGPT, Python, n8n, and any MCP client
Multi-account support: connect multiple Snap OAuth users to one Pipeboard account
Bulk operations: clone ads across ad squads and update budgets in one call
Audience segments: customer lists from URLs, event-based segments, and lookalikes
Pixel + custom conversion management for conversion-optimized campaigns

Getting Started

Set up in under 2 minutes

1. Sign up for a Pipeboard account:

pipeboard.co/auth/signup →

2. Connect your Snap Ads account:

pipeboard.co/connections →

You can connect multiple Snap OAuth users — handy when you manage agency accounts that span more than one Snap Business Manager login.

3. Add the MCP server to Claude (or another MCP client):

https://snap-ads.mcp.pipeboard.co/

Use this URL as a Streamable HTTP MCP server in your client. Authentication is handled automatically through your Pipeboard session.

Connect to Your AI Tool

The Snap Ads MCP works with any MCP-compatible client. Just add the server URL and start managing your Snap campaigns with natural language.

Claude Pro / Max

Recommended
  1. 1.Open claude.ai/settings/connectors
  2. 2.Click "Add custom connector"
  3. 3.URL: https://snap-ads.mcp.pipeboard.co/

ChatGPT

Developer mode
  1. 1.Enable Developer mode in ChatGPT Settings
  2. 2.Settings → Apps → Advanced → Developer mode
  3. 3.Create app with MCP URL

Claude Code

CLI / VS Code

Run this command in your terminal:

claude mcp add --transport http pipeboard-snap-ads https://snap-ads.mcp.pipeboard.co/

Then type /mcp in Claude Code to authenticate with Pipeboard.

Alternative: use an API token for instant setup (no browser auth needed):

claude mcp add --transport http pipeboard-snap-ads https://snap-ads.mcp.pipeboard.co/?token=pk_...

Get your token at pipeboard.co/api-tokens

Claude Desktop JSON configuration:

Add this to your Claude Desktop MCP settings (Settings → MCP Servers → Add):

claude_desktop_config.json
{
  "mcpServers": {
    "snap-ads": {
      "url": "https://snap-ads.mcp.pipeboard.co/"
    }
  }
}

Tips for getting started

Browse our prompt library for ready-to-use prompts you can copy into Claude
Snap creatives perform best in 9:16 vertical format with sound-on storytelling in the first 2 seconds
Always start with list_snap_ad_accounts to grab the ad_account_id other tools require

Try these prompts

Account Overview

"List my Snap ad accounts and show campaign performance for the last 30 days"

Lookalike Segment

"Create a 1% US lookalike from my best customers segment and use it in my prospecting ad squad"

Bulk Budget Update

"Increase the daily budget by 20% on every Snap ad squad with ROAS above 2.0 over the last 7 days"

Creative Refresh

"Clone my top-performing Snap ad to all of my active prospecting ad squads with the new spring video"

Available Tools

The Snap Ads MCP provides 35+ tools organized by category. All tools are available through natural language when connected to an AI assistant.

Account Management

list_snap_ad_accounts

List organizations and ad accounts across all connected Snap users

get_snap_account_info

Account currency, timezone, balance, and status

Campaigns

get_snap_campaigns

List campaigns with status filtering

create_snap_campaign

Create a campaign with objective, status, and start time

update_snap_campaign

Rename, change status, or update lifetime/daily caps

delete_snap_campaign

Permanently delete a campaign

duplicate_snap_campaign

Clone a campaign with optional ad squad/ad copy

Ad Squads

get_snap_ad_squads

List ad squads with budget, bid, and targeting details

create_snap_ad_squad

Create an ad squad with targeting, bidding, and pacing

update_snap_ad_squad

Update budget, bid, schedule, or targeting

delete_snap_ad_squad

Permanently delete an ad squad

duplicate_snap_ad_squad

Clone an ad squad, optionally including its ads

bulk_update_snap_ad_squad_budgets

Update daily/lifetime budgets across many ad squads at once

Ads

get_snap_ads

List ads with creative IDs, status, and review state

create_snap_ad

Create a new ad from an existing creative

update_snap_ad

Update ad name, status, or attached creative

delete_snap_ad

Permanently delete an ad

bulk_clone_snap_ads

Clone an ad into many ad squads in a single call

pause_snap_entities

Pause campaigns, ad squads, or ads in bulk

resume_snap_entities

Resume campaigns, ad squads, or ads in bulk

Creatives & Media

get_snap_ad_creatives

List creatives in an ad account with type, status, and assets

create_snap_creative

Create a SNAP_AD, LONGFORM_VIDEO, WEB_VIEW, COLLECTION, or AD_TO_LENS creative

update_snap_creative

Update headline, brand name, or call-to-action

create_snap_media

Reserve a media slot (IMAGE, VIDEO, or LENS_PACKAGE)

upload_snap_media

Upload the actual image or video bytes for a media record

get_snap_media

Fetch metadata for a media asset (status, file size, duration)

Audience Segments

list_snap_segments

List custom audience segments in an ad account

get_snap_segment

Fetch details and approximate size for one segment

create_snap_customer_list_segment_from_url

Build a customer-list segment from a hashed CSV URL

create_snap_event_segment

Build a pixel-event segment (purchase, view content, etc.)

create_snap_lookalike_segment

Generate a lookalike from a seed segment

Pixels & Conversions

get_snap_pixels

List Snap Pixels installed under an ad account

update_snap_pixel

Update Pixel name or status

list_snap_custom_conversions

List custom conversions defined in an ad account

create_snap_custom_conversion

Create a custom conversion from pixel events

delete_snap_custom_conversion

Delete a custom conversion

Analytics & Insights

get_snap_stats

Performance metrics for a campaign, ad squad, ad, or account with date range and breakdowns

Supported Creative Types

The Snap Ads MCP supports the major Snap creative types when calling create_snap_creative:

SNAP_AD

Standard single-video Snap Ad. The default format for In-Feed/Discover placements.

LONGFORM_VIDEO

Up to 10-minute video creative for storytelling and brand campaigns.

WEB_VIEW

Tap-to-open mobile web experience attached to a Snap Ad.

APP_INSTALL

Drives installs by deep-linking to the iOS App Store or Google Play.

DEEP_LINK

Opens a specific surface inside an installed mobile app.

COLLECTION

Hero video + four product tiles for shoppable storytelling.

DYNAMIC_COLLECTION

Catalog-driven Collection ad pulling products from a Snap product feed.

AD_TO_LENS

Drives users into a sponsored AR Lens experience.

AD_TO_CALL / AD_TO_MESSAGE

Click-to-call or click-to-message direct response formats.

Campaign Objectives

Common Snap campaign objectives passed to create_snap_campaign:

WEB_CONVERSION

Drive purchases or signups on your website

APP_INSTALL

Drive mobile app installs

VIDEO_VIEW

Maximize 2s/15s/completed video views

BRAND_AWARENESS

Reach the most users at the lowest CPM

AWARENESS_AND_ENGAGEMENT

Combined awareness + interaction goals

CATALOG_SALES

Sell products from a Snap product catalog

LEAD_GENERATION

Collect leads via in-app forms

Best Practices

  • Call list_snap_ad_accounts first — every other tool needs the ad_account_id it returns
  • When you have multiple connected Snap users, pass connection_id to disambiguate which OAuth user owns the account
  • Upload creatives in 9:16 (1080x1920) — Snap is full-screen vertical first
  • Hook viewers in the first 2 seconds; include a clear brand cue and sound
  • Use bulk_clone_snap_ads to launch the same creative across many ad squads in one call instead of looping
  • Use bulk_update_snap_ad_squad_budgets to scale winners and trim losers in a single MCP call
  • Lookalike segments need at least ~1,000 hashed users in the seed segment to build well
  • Pause campaigns/ad squads/ads with pause_snap_entities rather than deleting — keeps history for reactivation

Ready to connect your AI tools to Snap Ads?

Get started with the Snap Ads MCP in under 2 minutes.