integrations tools spotify-ads
Spotify Ads MCP for your AI agent
Cogny's Spotify Ads integration exposes 22 tools (13 read, 9 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
New connections open once Spotify allowlists Cogny's app for the Ads API.
- 13readonly reads data.
- 9writecreates or changes something.
- 0destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Spotify Ads in Cogny. Every Spotify Ads tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Connecting and limits
Connecting signs you in with Spotify. The Spotify Ads API has no permission scopes to pick from: Cogny can reach the ad accounts your Spotify login has a role on in Spotify Ads Manager. After connecting you pick which of them the workspace may use; the others are refused.
Changes are made only after you confirm each one: pausing and resuming campaigns, ad sets and ads, changing an ad set's budget, uploading an audio file or an image, and creating a campaign, an audio ad set and an audio ad. A new ad set and a new ad are created with delivery off, so nothing is spent until you turn delivery on. Turning delivery on starts spending.
An audio ad needs three files: the audio (MP3, WAV or OGG, at most 30 seconds), a companion image and a logo (each square, at least 600×600, JPEG or PNG, at most 200 KB). They are uploaded from a public https link, up to 20 MB each. Cogny's create_audio_ad makes all three. An ad set targets one country; for several countries, make one ad set each. Spotify reviews every new ad before it can play.
Daily reports cover at most 90 days per request; hourly reports cover the last two weeks. Audience insight reports (age, gender, country, platform, genre and more) cover a campaign's or ad set's lifetime and only appear once it has delivered enough to pass Spotify's privacy threshold.
Known gaps
- Only audio ads can be built: no video, image or podcast-host-read ads, and no video uploads.
- An ad set's targeting is country (with optional regions and cities), age, gender, device platform, listener language, and music or podcast placement. Genre, interest, playlist, artist-fan and custom-audience targeting can't be set from Cogny yet.
- The upload, estimate and create tools are new (November 2026). If Spotify refuses a request, the tool answers with Spotify's own message.
- No tools for drafts. If Spotify doesn't let your login edit a published ad set or ad directly, make the change as a draft in Spotify Ads Manager.
- Campaigns can't be archived from Cogny, and an existing ad set's targeting, bid and schedule and an existing ad's text can't be edited yet.
- No tools for audiences beyond listing them, for the Spotify Pixel or Conversions API setup, or for business and member administration.
what each tool does.
Read 13 · only reads data
tool_list_ad_accountsReadList the Spotify ad accounts the connection can reach, with business, currency and role.tool_get_ad_accountReadGet one Spotify ad account's details: name, status, currency, country and industry.tool_get_campaignsReadList the campaigns in a Spotify ad account with status and objective.tool_get_ad_setsReadList ad sets with budget, schedule, bidding, targeting and whether each is paused.tool_get_adsReadList ads with tagline, call to action, assets, delivery and review status.tool_list_audiencesReadList the custom and lookalike audiences of a Spotify ad account with size and status.tool_get_aggregate_reportReadGet Spotify ad performance (impressions, reach, spend, clicks, completes, streams…) per campaign, ad set or ad.tool_get_insight_reportReadBreak one Spotify campaign or ad set's results down by audience: age, gender, country, platform, genre and more.tool_get_csv_reportReadCheck a CSV report started with tool_create_csv_report and get its download link once ready.tool_search_geo_targetsReadFind the countries, regions and cities Spotify ads can target, with their ids.tool_list_ad_categoriesReadFind the Spotify ad category (industry) id an ad set should carry, e.g.tool_estimate_audienceReadForecast an audio ad set before creating it: reach and impressions, a bid range, and whether the budget is likely to be spent.tool_list_assetsReadList the audio and image files uploaded to a Spotify ad account, with their ids and processing status.
Write 9 · creates or changes something
tool_create_csv_reportWriteStart a downloadable CSV performance report in Spotify Ads Manager.tool_update_campaign_statusWritePause or resume a Spotify campaign.tool_update_ad_set_deliveryWritePause (delivery OFF) or resume (delivery ON) a Spotify ad set.tool_update_ad_set_budgetWriteChange a Spotify ad set's budget.tool_update_ad_deliveryWritePause (delivery OFF) or resume (delivery ON) a single Spotify ad.tool_upload_assetWriteUpload an audio file or an image to a Spotify ad account from a URL, for use in an ad.tool_create_campaignWriteCreate a Spotify campaign: the empty container an ad set and its ads go into.tool_create_ad_setWriteCreate a Spotify audio ad set in a campaign: the budget, schedule, bid and audience its ads run with.tool_create_adWriteCreate a Spotify audio ad in an ad set from uploaded assets, and send it to Spotify's review.
Exact input schemas come from tools/list once Spotify Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.