PilotMCP
Platforms and tools

Snapchat Ads

The 37 tools Pilot MCP serves for Snapchat Ads: 18 read-only, and 19 that write with the €29 plan, taken from the server.

Pilot MCP serves 18 read-only tools for Snapchat Ads, on every plan. With the €29 plan, it also serves 15 that create or change and 4 that delete. Their names start with snapchat_.

What each entry shows

The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.

Writing and deleting

Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See Read and write.

Tool families

Other tools

snapchat_get_ad

Snapchat Ads: Get Ad · read-only · idempotent

Get details of a specific ad, with the ad account of its campaign (ad_account_id)

ParameterTypeRequiredDescription
ad_idstringyesAd ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_ad_account

Snapchat Ads: Get Ad Account · read-only · idempotent

Get the details of one Snapchat ad account by ad_account_id.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_get_ad_account_stats

Snapchat Ads: Get Ad Account Stats · read-only · idempotent

Get the spend of a Snapchat ad account over a time range, by granularity (DAY by default). Snapchat returns only spend at the ad account level: use get_campaign_stats, get_ad_squad_stats or get_ad_stats for impressions, swipes and conversions.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
granularitystringnoGranularity of stats. Values: "TOTAL", "DAY", "HOUR". Default: "DAY".
start_timestringyesStart time ISO 8601 (e.g. 2025-01-01T00:00:00.000-00:00).
end_timestringyesEnd time ISO 8601.
conversion_source_typesstringnoComma-separated conversion sources (web, app, total).
swipe_up_attribution_windowstringnoSwipe-up attribution window (e.g. 28_DAY).
view_attribution_windowstringnoView attribution window (e.g. 7_DAY).

snapchat_get_ad_squad

Snapchat Ads: Get Ad Squad · read-only · idempotent

Get details of a specific ad squad, with the ad account of its campaign (ad_account_id)

ParameterTypeRequiredDescription
ad_squad_idstringyesAd Squad ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_audience

Snapchat Ads: Get Audience · read-only · idempotent

Get details of a specific audience segment

ParameterTypeRequiredDescription
segment_idstringyesSegment ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_audience_size

Snapchat Ads: Get Audience Size · read-only · idempotent

Estimate the audience size range for a targeting spec (geos, demographics, interests...), with optional ad squad fields (type, placement, optimization_goal...) that shape the estimate.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
targeting_specobjectyesTargeting spec object (geos, demographics, interests, etc.).
ad_squadobjectnoOther ad squad fields of the estimate, e.g. { "type": "SNAP_ADS", "placement": "CONTENT", "optimization_goal": "SWIPES" }.

snapchat_get_campaign

Snapchat Ads: Get Campaign · read-only · idempotent

Get the details of one Snapchat campaign by campaign_id.

ParameterTypeRequiredDescription
campaign_idstringyesCampaign ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_creative

Snapchat Ads: Get Creative · read-only · idempotent

Get the details of one Snapchat creative by creative_id.

ParameterTypeRequiredDescription
creative_idstringyesCreative ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_media

Snapchat Ads: Get Media · read-only · idempotent

Get the details of one Snapchat media file by media_id.

ParameterTypeRequiredDescription
media_idstringyesMedia ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_pixel

Snapchat Ads: Get Pixel · read-only · idempotent

Get the details of one Snapchat pixel by pixel_id.

ParameterTypeRequiredDescription
pixel_idstringyesPixel ID.
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_get_targeting_options

Snapchat Ads: Get Targeting Options · read-only · idempotent

Get available Snapchat targeting options by type and dimension: geo (country by default; with country_code, its region, metro or postal_code), demographics (age_group, gender, languages, advanced_demographics), device (os_type, connection_type, marketing_name, carrier), interests, location categories.

ParameterTypeRequiredDescription
targeting_typestringyesTargeting type to retrieve. Values: "geo", "demographics", "device", "carrier", "interests_dlxs", "interests_dlxc", "interests_dlxp", "interests_nln", "location_categories", "advanced_demographics".
country_codestringnoCountry code (e.g. fr): for geo, the country whose regions, metros or postal codes are listed; otherwise a filter.
dimensionstringnoDimension within the type: required for demographics and device; for geo, region by default when country_code is given. Values: "country", "region", "metro", "postal_code", "age_group", "gender", "languages", "advanced_demographics", "os_type", "connection_type", "marketing_name", "carrier".
account_idstringnoSnapchat Ads account to use when the workspace has several. Default: the first account linked to the workspace.

snapchat_list_ad_squads

Snapchat Ads: List Ad Squads · read-only · idempotent

List all the ad squads of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_ads

Snapchat Ads: List Ads · read-only · idempotent

List all the ads of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_audiences

Snapchat Ads: List Audiences · read-only · idempotent

List all audience segments under an ad account

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_campaigns

Snapchat Ads: List Campaigns · read-only · idempotent

List all the campaigns of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_creatives

Snapchat Ads: List Creatives · read-only · idempotent

List all the creatives of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_media

Snapchat Ads: List Media · read-only · idempotent

List all the media files of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

snapchat_list_pixels

Snapchat Ads: List Pixels · read-only · idempotent

List all the pixels of a Snapchat ad account (ad_account_id).

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.

Create and change (€29)

Served with the €29 plan.

snapchat_create_ad

Snapchat Ads: Create Ad · create or change, €29 plan · creates an object on each call

Create a new ad (PAUSED by default) under an ad squad. Change it with update_ad, delete it with delete_ad.

ParameterTypeRequiredDescription
ad_squad_idstringyesAd Squad ID.
namestringyesAd name.
creative_idstringyesCreative ID to associate with this ad.
statusstringnoAd status. Values: "ACTIVE", "PAUSED". Default: "PAUSED".
typestringnoAd type. Values: "SNAP_AD", "LONGFORM_VIDEO", "APP_INSTALL", "REMOTE_WEBPAGE", "DEEP_LINK", "STORY", "AD_TO_LENS", "AD_TO_CALL", "AD_TO_MESSAGE", "FILTER", "LENS", "LENS_REMOTE_WEBPAGE", "LENS_APP_INSTALL", "LENS_DEEP_LINK", "COLLECTION", "LEAD_GENERATION". Default: "SNAP_AD".
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_create_ad_squad

Snapchat Ads: Create Ad Squad · create or change, €29 plan · creates an object on each call

Create a new Snapchat ad squad in campaign_id. Defaults: status PAUSED, type SNAP_ADS, billing event IMPRESSION, automatic placement. Change it with update_ad_squad, delete it with delete_ad_squad.

ParameterTypeRequiredDescription
campaign_idstringyesCampaign ID.
namestringyesAd squad name.
statusstringnoStatus. Values: "ACTIVE", "PAUSED". Default: "PAUSED".
typestringnoAd squad type. Values: "SNAP_ADS", "LENSES", "FILTERS". Default: "SNAP_ADS".
placement_v2objectnoPlacement configuration.
optimization_goalstringnoOptimization goal (IMPRESSIONS, SWIPES, APP_INSTALLS, etc.).
bid_micronumbernoBid amount in micro-currency.
daily_budget_micronumbernoDaily budget in micro-currency.
billing_eventstringnoBilling event. Values: "IMPRESSION", "SWIPE". Default: "IMPRESSION".
start_timestringnoStart time ISO 8601.
end_timestringnoEnd time ISO 8601.
targetinganynoTargeting spec object (geos, demographics, devices, etc.).
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_create_audience

Snapchat Ads: Create Audience · create or change, €29 plan · creates an object on each call

Create a new audience segment under an ad account. Change it with update_audience, delete it with delete_audience.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesSegment name.
descriptionstringnoSegment description.
source_typestringyesAudience source type. Values: "FIRST_PARTY", "ENGAGEMENT", "PIXEL", "MOBILE", "LOOKALIKE", "AD_ACCOUNT", "SAVED_AUDIENCE", "CUSTOMER_LIST".
retention_in_daysnumbernoRetention period in days. Default: 180.

snapchat_create_audience_segment

Snapchat Ads: Create Audience Segment · create or change, €29 plan · creates an object on each call

Create a customer list audience segment for targeting. Change it with update_audience, delete it with delete_audience.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesSegment name.
descriptionstringnoSegment description.
source_typestringnoSegment source type. Values: "FIRST_PARTY", "ENGAGEMENT", "PIXEL", "THIRD_PARTY_UPLOADED". Default: "FIRST_PARTY".
retention_in_daysnumbernoRetention period in days.

snapchat_create_campaign

Snapchat Ads: Create Campaign · create or change, €29 plan · creates an object on each call

Create a new campaign under an ad account

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesCampaign name.
statusstringnoCampaign status. Values: "ACTIVE", "PAUSED". Default: "PAUSED".
start_timestringnoStart time ISO 8601 (e.g. 2025-01-01T00:00:00.000-05:00).
end_timestringnoEnd time ISO 8601.
daily_budget_micronumbernoDaily budget in micro-currency (1 USD = 1000000).
lifetime_spend_cap_micronumbernoLifetime spend cap in micro-currency.
objectivestringnoCampaign objective (e.g. AWARENESS, APP_INSTALLS, WEB_CONVERSIONS).

snapchat_create_creative

Snapchat Ads: Create Creative · create or change, €29 plan · creates an object on each call

Create a new creative under an ad account. Change it with update_creative. Snapchat's Marketing API has no endpoint to delete a creative (the Creatives reference lists create, get and update only): create one only if it may stay.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesCreative name.
typestringyesCreative type. Values: "SNAP_AD", "APP_INSTALL", "LONGFORM_VIDEO", "WEB_VIEW", "DEEP_LINK", "AD_TO_LENS", "AD_TO_CALL", "AD_TO_MESSAGE", "LENS", "FILTER", "COLLECTION", "LEAD_GENERATION".
headlinestringnoHeadline text.
brand_namestringnoBrand name.
shareablebooleannoAllow sharing. Default: true.
top_snap_media_idstringnoTop snap media ID.
top_snap_crop_positionstringnoCrop position. Values: "MIDDLE", "TOP", "BOTTOM".
call_to_actionstringnoCall to action. Values: "BLANK", "WATCH", "VIEW_MORE", "INSTALL_NOW", "SIGN_UP", "SHOP_NOW", "BOOK_NOW", "APPLY_NOW", "GET_NOW", "ORDER_NOW", "LEARN_MORE", "MORE", "LISTEN", "OPEN_APP", "PLAY", "DONATE", "SUBSCRIBE", "DIRECTIONS", "SHOWTIMES", "SEND", "TRY", "USE".
web_view_urlstringnoWeb view destination URL.
deep_link_uristringnoDeep link URI for app.

snapchat_create_media

Snapchat Ads: Create Media · create or change, €29 plan · creates an object on each call

Create a media entry (initiate upload) under an ad account. Snapchat's Marketing API has no endpoint to delete or rename a media (the Media reference lists create, upload and get only): create one only if it may stay.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesMedia name.
typestringyesMedia type. Values: "IMAGE", "VIDEO", "LENS_PACKAGE".

snapchat_create_pixel

Snapchat Ads: Create Pixel · create or change, €29 plan · creates an object on each call

Create a new Snapchat pixel named name in the ad account ad_account_id. Snapchat's Marketing API has no endpoint to delete a pixel (the Snap Pixel reference lists create, get and update only): create one only if it must stay.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringyesPixel name.

snapchat_update_ad

Snapchat Ads: Update Ad · create or change, €29 plan · creates an object on each call

Update an existing ad (Snapchat replaces the whole ad: Pilot reads it first and sends it back with your changes)

ParameterTypeRequiredDescription
ad_idstringyesAd ID.
namestringnoNew name.
statusstringnoNew status. Values: "ACTIVE", "PAUSED".
creative_idstringnoNew creative ID.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_update_ad_account

Snapchat Ads: Update Ad Account · create or change, €29 plan · creates an object on each call

Update an existing ad account (Snapchat replaces the whole account: Pilot reads it first and sends it back with your changes)

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
namestringnoNew name.
advertiserstringnoNew advertiser name.

snapchat_update_ad_squad

Snapchat Ads: Update Ad Squad · create or change, €29 plan · creates an object on each call

Update an existing ad squad (Snapchat replaces the whole ad squad: Pilot reads it first and sends it back with your changes)

ParameterTypeRequiredDescription
ad_squad_idstringyesAd Squad ID.
namestringnoNew name.
statusstringnoNew status. Values: "ACTIVE", "PAUSED".
bid_micronumbernoNew bid in micro-currency.
daily_budget_micronumbernoNew daily budget in micro-currency.
end_timestringnoNew end time ISO 8601.
targetinganynoNew targeting spec object.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_update_audience

Snapchat Ads: Update Audience · create or change, €29 plan · creates an object on each call

Update an existing audience segment (name, description, retention)

ParameterTypeRequiredDescription
segment_idstringyesSegment ID.
namestringnoNew name.
descriptionstringnoNew description.
retention_in_daysnumbernoNew retention period.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_update_campaign

Snapchat Ads: Update Campaign · create or change, €29 plan · creates an object on each call

Update an existing campaign (Snapchat replaces the whole campaign: Pilot reads it first and sends it back with your changes)

ParameterTypeRequiredDescription
campaign_idstringyesCampaign ID.
namestringnoNew name.
statusstringnoNew status. Values: "ACTIVE", "PAUSED".
daily_budget_micronumbernoNew daily budget in micro-currency.
end_timestringnoNew end time ISO 8601.
lifetime_spend_cap_micronumbernoNew lifetime spend cap in micro-currency.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_update_creative

Snapchat Ads: Update Creative · create or change, €29 plan · creates an object on each call

Update an existing creative (only the given fields change)

ParameterTypeRequiredDescription
creative_idstringyesCreative ID.
namestringnoNew name.
headlinestringnoNew headline.
call_to_actionstringnoNew CTA.
web_view_urlstringnoNew web view URL.
shareablebooleannoAllow sharing.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_upload_creative_media

Snapchat Ads: Upload Creative Media · create or change, €29 plan · creates an object on each call

Upload media (image or video) from a URL for use in Snapchat ads. Snapchat's Marketing API has no endpoint to delete or rename a media: upload only what may stay.

ParameterTypeRequiredDescription
ad_account_idstringyesAd Account ID.
media_urlstringyesPublic URL of the media to upload.
media_typestringyesType of media to upload. Values: "IMAGE", "VIDEO".
namestringyesName for the media asset.

Delete (€29)

Served with the €29 plan. A deletion targets one object at a time.

snapchat_delete_ad

Snapchat Ads: Delete Ad · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE ad (irreversible). To stop it instead, use update_ad with status PAUSED.

ParameterTypeRequiredDescription
ad_idstringyesAd ID.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_delete_ad_squad

Snapchat Ads: Delete Ad Squad · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE ad squad (irreversible). To stop it instead, use update_ad_squad with status PAUSED.

ParameterTypeRequiredDescription
ad_squad_idstringyesAd Squad ID.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_delete_audience

Snapchat Ads: Delete Audience · delete, €29 plan, one object at a time · creates an object on each call

Delete one Snapchat audience segment by segment_id.

ParameterTypeRequiredDescription
segment_idstringyesSegment ID.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

snapchat_delete_campaign

Snapchat Ads: Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call

Delete ONE campaign (irreversible). To stop it instead, use update_campaign with status PAUSED.

ParameterTypeRequiredDescription
campaign_idstringyesCampaign ID.
account_idstringnoSnapchat Ads account that owns the target object. Required when the workspace has several linked accounts; otherwise its only account.

On this page