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:
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.Open claude.ai/settings/connectors
- 2.Click "Add custom connector"
- 3.URL:
https://snap-ads.mcp.pipeboard.co/
Claude Code
CLI / VS CodeRun 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):
{
"mcpServers": {
"snap-ads": {
"url": "https://snap-ads.mcp.pipeboard.co/"
}
}
}More integrations:
Tips for getting started
list_snap_ad_accounts to grab the ad_account_id other tools requireTry 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_accountsList organizations and ad accounts across all connected Snap users
get_snap_account_infoAccount currency, timezone, balance, and status
Campaigns
get_snap_campaignsList campaigns with status filtering
create_snap_campaignCreate a campaign with objective, status, and start time
update_snap_campaignRename, change status, or update lifetime/daily caps
delete_snap_campaignPermanently delete a campaign
duplicate_snap_campaignClone a campaign with optional ad squad/ad copy
Ad Squads
get_snap_ad_squadsList ad squads with budget, bid, and targeting details
create_snap_ad_squadCreate an ad squad with targeting, bidding, and pacing
update_snap_ad_squadUpdate budget, bid, schedule, or targeting
delete_snap_ad_squadPermanently delete an ad squad
duplicate_snap_ad_squadClone an ad squad, optionally including its ads
bulk_update_snap_ad_squad_budgetsUpdate daily/lifetime budgets across many ad squads at once
Ads
get_snap_adsList ads with creative IDs, status, and review state
create_snap_adCreate a new ad from an existing creative
update_snap_adUpdate ad name, status, or attached creative
delete_snap_adPermanently delete an ad
bulk_clone_snap_adsClone an ad into many ad squads in a single call
pause_snap_entitiesPause campaigns, ad squads, or ads in bulk
resume_snap_entitiesResume campaigns, ad squads, or ads in bulk
Creatives & Media
get_snap_ad_creativesList creatives in an ad account with type, status, and assets
create_snap_creativeCreate a SNAP_AD, LONGFORM_VIDEO, WEB_VIEW, COLLECTION, or AD_TO_LENS creative
update_snap_creativeUpdate headline, brand name, or call-to-action
create_snap_mediaReserve a media slot (IMAGE, VIDEO, or LENS_PACKAGE)
upload_snap_mediaUpload the actual image or video bytes for a media record
get_snap_mediaFetch metadata for a media asset (status, file size, duration)
Audience Segments
list_snap_segmentsList custom audience segments in an ad account
get_snap_segmentFetch details and approximate size for one segment
create_snap_customer_list_segment_from_urlBuild a customer-list segment from a hashed CSV URL
create_snap_event_segmentBuild a pixel-event segment (purchase, view content, etc.)
create_snap_lookalike_segmentGenerate a lookalike from a seed segment
Pixels & Conversions
get_snap_pixelsList Snap Pixels installed under an ad account
update_snap_pixelUpdate Pixel name or status
list_snap_custom_conversionsList custom conversions defined in an ad account
create_snap_custom_conversionCreate a custom conversion from pixel events
delete_snap_custom_conversionDelete a custom conversion
Analytics & Insights
get_snap_statsPerformance 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_ADStandard single-video Snap Ad. The default format for In-Feed/Discover placements.
LONGFORM_VIDEOUp to 10-minute video creative for storytelling and brand campaigns.
WEB_VIEWTap-to-open mobile web experience attached to a Snap Ad.
APP_INSTALLDrives installs by deep-linking to the iOS App Store or Google Play.
DEEP_LINKOpens a specific surface inside an installed mobile app.
COLLECTIONHero video + four product tiles for shoppable storytelling.
DYNAMIC_COLLECTIONCatalog-driven Collection ad pulling products from a Snap product feed.
AD_TO_LENSDrives users into a sponsored AR Lens experience.
AD_TO_CALL / AD_TO_MESSAGEClick-to-call or click-to-message direct response formats.
Campaign Objectives
Common Snap campaign objectives passed to create_snap_campaign:
WEB_CONVERSIONDrive purchases or signups on your website
APP_INSTALLDrive mobile app installs
VIDEO_VIEWMaximize 2s/15s/completed video views
BRAND_AWARENESSReach the most users at the lowest CPM
AWARENESS_AND_ENGAGEMENTCombined awareness + interaction goals
CATALOG_SALESSell products from a Snap product catalog
LEAD_GENERATIONCollect 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