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
| Family | Tools |
|---|---|
| Other tools | 6 |
| Create and change (€29) | 6 |
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
level | string | yes | The level of the rows. Values: "AD_ACCOUNT", "CAMPAIGN", "AD_SET", "AD". |
granularity | string | no | DAY (default): one row per entity and per day; LIFETIME: one row per entity over the period. Values: "DAY", "LIFETIME". |
start_date | string | yes | First day, YYYY-MM-DD (UTC), inclusive. |
end_date | string | yes | Last day, YYYY-MM-DD (UTC), inclusive; at most 90 days after the first. |
metrics | string[] | no | The 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". |
ids | string[] | no | Read only these entities of the requested level (50 at most; not at the AD_ACCOUNT level). |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
adset_ids | string[] | no | Read only the ads of these ad sets (50 at most). |
statuses | string[] | no | Filter by Spotify status (ACTIVE, REJECTED, PENDING_APPROVAL…). |
max_items | integer | no | Items to read (default 100, maximum 500); reponse.tronque says whether more remain. |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_ids | string[] | no | Read only the ad sets of these campaigns (50 at most). |
statuses | string[] | no | Filter by Spotify status (ACTIVE, COMPLETED, PENDING_APPROVAL…). |
max_items | integer | no | Items to read (default 100, maximum 500); reponse.tronque says whether more remain. |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
asset_ids | string[] | yes | The assets to read (50 at most). |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_ids | string[] | no | Read only these campaigns (50 at most). |
statuses | string[] | no | Filter by Spotify status (ACTIVE, PAUSED, ARCHIVED…). |
max_items | integer | no | Items to read (default 100, maximum 500); reponse.tronque says whether more remain. |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_id | string | yes | |
delivery | string | yes | Values: "ON", "OFF". |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_set_id | string | yes | |
bid_amount | number | yes | The bid, in units of the account currency (12.5 for 12.50). |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_set_id | string | yes | |
budget_amount | number | yes | The budget, in units of the account currency (12.5 for 12.50). |
budget_type | string | no | The budget type; when omitted, the current type of the ad set. Values: "DAILY", "LIFETIME". |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_set_id | string | yes | |
delivery | string | yes | Values: "ON", "OFF". |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_set_id | string | yes | |
end_time | string | yes | |
account_id | string | no | ID 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | yes | |
status | string | yes | Values: "ACTIVE", "PAUSED". |
account_id | string | no | ID 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. |