PilotMCP
Platforms and tools

Spotify Ads

The 12 tools Pilot MCP serves for Spotify Ads: 6 read-only, and 6 that write with the €29 plan, taken from the server.

Pilot MCP serves 6 read-only tools for Spotify Ads, on every plan. With the €29 plan, it also serves 6 that create or change. Their names start with spotify_ads_.

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

spotify_ads_get_ad_account

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

The Spotify Ads ad account linked to the workspace: name, billing currency, country, status at Spotify, role of the person who linked it, and whether it is a test account (which returns no statistics). Read-only.

ParameterTypeRequiredDescription
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_get_statistics

Spotify Ads: Get Statistics · read-only · idempotent

The Spotify Ads statistics of the linked account, by level (AD_ACCOUNT, CAMPAIGN, AD_SET, AD) and per day (DAY) or over the whole period (LIFETIME), UTC days, 90 days at most: impressions, clicks, spend (units of the account currency), starts, listen or view quartiles, completed listens, video views, reach and frequency (not additive), pixel conversions (purchases, leads, page views) and revenue attributed over 30 days. CTR, CPM and completion rate recomputed. A conversion hidden by Spotify (between 1 and 4) is reported in "masquees". Read-only.

ParameterTypeRequiredDescription
levelstringyesThe level of the rows. Values: "AD_ACCOUNT", "CAMPAIGN", "AD_SET", "AD".
granularitystringnoDAY (default): one row per entity and per day; LIFETIME: one row per entity over the period. Values: "DAY", "LIFETIME".
start_datestringyesFirst day, YYYY-MM-DD (UTC), inclusive.
end_datestringyesLast day, YYYY-MM-DD (UTC), inclusive; at most 90 days after the first.
metricsstring[]noThe metrics; when omitted, all of them. Values: "IMPRESSIONS", "CLICKS", "SPEND", "STARTS", "FIRST_QUARTILES", "MIDPOINTS", "THIRD_QUARTILES", "COMPLETES", "VIDEO_VIEWS", "STREAMED_IMPRESSIONS", "OFF_SPOTIFY_IMPRESSIONS", "PAGE_VIEWS", "LEADS", "PURCHASES", "REVENUE", "REACH", "FREQUENCY".
idsstring[]noRead only these entities of the requested level (50 at most; not at the AD_ACCOUNT level).
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_list_ads

Spotify Ads: List Ads · read-only · idempotent

The Spotify Ads ads of the linked account: status, delivery switch, tagline, displayed advertiser name, call to action and its URL, IDs of their assets (audio or video, companion image, logo) and rejection reasons. Can be filtered by ad sets. Assets are read with list_assets. Read-only.

ParameterTypeRequiredDescription
adset_idsstring[]noRead only the ads of these ad sets (50 at most).
statusesstring[]noFilter by Spotify status (ACTIVE, REJECTED, PENDING_APPROVAL…).
max_itemsintegernoItems to read (default 100, maximum 500); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_list_adsets

Spotify Ads: List Ad Sets · read-only · idempotent

The Spotify Ads ad sets of the linked account (the level that holds budget, bid, dates, AUDIO or VIDEO format, MUSIC or PODCAST placements and status): status, delivery switch (ON, OFF), pause and its reason, budget (amount in units of the account currency, DAILY or LIFETIME type), bid per thousand impressions, UTC dates. Can be filtered by campaigns. Read-only.

ParameterTypeRequiredDescription
campaign_idsstring[]noRead only the ad sets of these campaigns (50 at most).
statusesstring[]noFilter by Spotify status (ACTIVE, COMPLETED, PENDING_APPROVAL…).
max_itemsintegernoItems to read (default 100, maximum 500); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_list_assets

Spotify Ads: List Assets · read-only · idempotent

The requested Spotify Ads assets (IDs returned by list_ads): AUDIO, VIDEO or IMAGE type, status, file URL, video thumbnail, dimensions, duration. The URLs returned by Spotify are not permanent. Read-only.

ParameterTypeRequiredDescription
asset_idsstring[]yesThe assets to read (50 at most).
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_list_campaigns

Spotify Ads: List Campaigns · read-only · idempotent

The Spotify Ads campaigns of the linked account: id, name, status (ACTIVE, PAUSED, ARCHIVED…), delivery objective, creation and modification dates. A campaign has no budget and no delivery dates: they live on its ad sets (list_adsets). Read-only.

ParameterTypeRequiredDescription
campaign_idsstring[]noRead only these campaigns (50 at most).
statusesstring[]noFilter by Spotify status (ACTIVE, PAUSED, ARCHIVED…).
max_itemsintegernoItems to read (default 100, maximum 500); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

Create and change (€29)

Served with the €29 plan.

spotify_ads_update_ad_delivery

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

Turns off (OFF) or restores (ON) delivery of an ad of the Spotify Ads account linked to the workspace. Reads it back before and after. Restoring puts money back at stake.

ParameterTypeRequiredDescription
ad_idstringyes
deliverystringyesValues: "ON", "OFF".
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_update_ad_set_bid

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

Changes the bid of a Spotify Ads ad set (per thousand impressions), in units of the account currency. Reads it back before and after.

ParameterTypeRequiredDescription
ad_set_idstringyes
bid_amountnumberyesThe bid, in units of the account currency (12.5 for 12.50).
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_update_ad_set_budget

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

Changes the budget of a Spotify Ads ad set, in units of the account currency; keeps its type (DAILY or LIFETIME) unless one is given. Reads it back before and after.

ParameterTypeRequiredDescription
ad_set_idstringyes
budget_amountnumberyesThe budget, in units of the account currency (12.5 for 12.50).
budget_typestringnoThe budget type; when omitted, the current type of the ad set. Values: "DAILY", "LIFETIME".
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_update_ad_set_delivery

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

Turns off (OFF) or restores (ON) delivery of an ad set of the Spotify Ads account linked to the workspace. Reads it back before and after. Restoring puts money back at stake.

ParameterTypeRequiredDescription
ad_set_idstringyes
deliverystringyesValues: "ON", "OFF".
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_update_ad_set_end_time

Spotify Ads: Update Ad Set End Time · create or change, €29 plan · creates an object on each call

Changes the end date of a Spotify Ads ad set (ISO 8601 in UTC, YYYY-MM-DDTHH:MM:SSZ). Reads it back before and after.

ParameterTypeRequiredDescription
ad_set_idstringyes
end_timestringyes
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

spotify_ads_update_campaign_status

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

Pauses (PAUSED) or reactivates (ACTIVE) a Spotify Ads campaign of the account linked to the workspace. Reads it back before and after. Reactivating puts money back at stake.

ParameterTypeRequiredDescription
campaign_idstringyes
statusstringyesValues: "ACTIVE", "PAUSED".
account_idstringnoID of the workspace's Spotify Ads ad account to read, when the workspace links several. Omitted: the workspace's only Spotify Ads account. An account that is not linked is refused, never replaced by another one.

On this page