# Spotify Ads

Source: https://pilot.braike.com/en/docs/regies/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_`.

<Callout title="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.
</Callout>

<Callout title="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](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 6 |
| [Create and change (€29)](#modification) | 6 |

## Other tools [#autres]

### `spotify_ads_get_ad_account` [#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]

**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]

**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_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]

**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]

**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) [#modification]

Served with the €29 plan.

### `spotify_ads_update_ad_delivery` [#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]

**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]

**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]

**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]

**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]

**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. |
