Amazon Ads changes

Change Ad Budgets

Change the daily budget of your Sponsored Products campaigns.

This tool changes your Amazon Ads account

set_ad_budgets changes campaign budgets in your Amazon Ads account. Changes apply right away in your Amazon Ads account. Launch Fast records each change with what changed, when, and which AI app made it. To undo a change, ask your AI app to undo it. It uses undo_ad_change. Launch Fast tells the assistant to confirm each change with you first, unless you named the change exactly. Your AI app may also ask before it runs a change tool.

Field	Value
MCP tool	`set_ad_budgets`
Behavior	Makes a change in your Amazon Ads account. Destructive: the new budget replaces the old budget.
Cost	Free
Permission	Change Amazon Ads (Amazon Ads tools). Amazon verification is necessary.
Sign-in	OAuth only. API keys cannot make Ads changes. Your last Amazon verification (the code from your authenticator app) must be from the last 30 days.
Ad type	Sponsored Products only
Amazon connection	Amazon Ads
App view	None. The assistant shows the result as text and a table.

What It Does

set_ad_budgets sets a new daily budget on Sponsored Products campaigns. One call takes up to 50 campaigns. All budgets in one call must be raises, or all must be cuts. Put raises and cuts in separate calls.

When To Use It

Use it when a campaign runs out of budget too early, or when it spends too much. The campaign report shows spend and budget for each campaign.

Inputs

Input	Required	Values	Example
`budgets`	Yes	A list of 1 to 50 campaigns. All raises or all cuts.	See the rows below
`budgets[].campaign`	Yes	The campaign name, or its `campaign_id`	`SP Garlic Exact`
`budgets[].daily_budget`	Yes	The new daily budget, more than 0. A number or text such as "$25".	`25`
`marketplace`	No	Two letters, such as `US`, `CA`, `UK`, or `DE`. Give it only when you advertise in more than one marketplace.	`US`
`reason`	No	One line on why, up to 300 characters. Launch Fast saves it with the change. The default is "Asked for in chat."	`Raise budgets on campaigns that run out early`

What The Answer Contains

A status: applied, partly applied, not applied, going through, or unconfirmed.
A table with one row for each change: the campaign, the old and new daily budget, and the result.
The change id (it starts with ac-). Use it with get_ad_changes and undo_ad_change.
Notes about large changes, and the currency when it is not USD.
The day that the result is due. Ask for it then with get_ad_changes. Launch Fast compares the two weeks before the change with the two weeks after it, so the result shows about three weeks later.

Status	Meaning
`applied`	All changes reached Amazon Ads.
`partly applied`	Some changes reached Amazon Ads. The table shows what happened to the rest.
`not applied`	Nothing changed in Amazon Ads. The table shows why.
`going through`	Amazon was still applying the change when the answer came back. The answer waits up to 45 seconds. Launch Fast keeps applying the change, and if the call was cut off, it carries the change on within about 15 minutes. Check it in a minute with `get_ad_changes`.
`unconfirmed`	Amazon accepted the change but then showed a different value. Check the value in Amazon Ads before you change it again.

Example Prompts

Raise the daily budget of SP Garlic Press to $25.

Cut the budget by half on my campaigns with ACOS over 80% last month.

Common Errors

Error	What it means	What to do
`invalid_input`: raises and cuts in separate calls	The call raises some budgets and cuts others.	Make one call with the raises and one call with the cuts.
`invalid_input`: more than 50 items	The call has more than 50 campaigns.	Put the rest in another call.
`invalid_input`: an amount above 0	The budget is 0, negative, or not a number.	Give an amount such as `25` or "$25".
`invalid_input`: more than one campaign has this name	Two campaigns have the same name.	Use the `campaign_id` from the answer.
`not_found`	No Sponsored Products campaign has that name. The answer lists similar campaign names.	Use a name from the answer, or find it with `amazon_ads_entity_graph_lookup`.
`oauth_required`	You connected Launch Fast with an API key. API keys cannot change Amazon Ads.	Add Launch Fast as a connector in your AI app and sign in. See Getting started.
`mfa_required`	Your last Amazon verification is more than 30 days old, or Amazon access for this app ended.	Connect the app again and enter your authenticator code on the Launch Fast sign-in page. See Authentication.
`not_enabled`	Ad changes through Launch Fast are paused for now, or Amazon access for the app needs a fresh verification. The message says which.	For a fresh verification, verify again in Settings > MCP & API keys. For a pause, make the change in Amazon Ads.
`busy`	Another change on this Amazon Ads account is in progress.	Wait a minute and try again. Check the change with `get_ad_changes`.
Rate limit: `amazon_ads rate limit exceeded`	Your account made more than 10 Ads change calls in one minute. The limit counts all the change tools together.	Wait the number of seconds in the message, then try again.

amazon_ads_campaign_performance_lookup shows spend and budget for each campaign.
undo_ad_change puts the old budgets back.