# Add Negative Keywords

Source: https://docs.launchfastlegacyx.com/mcp/ads-changes/add-negative-keywords

Add negative keywords to a Sponsored Products campaign or ad group from your AI app. Its ads then stop showing for those searches.

> **This tool changes your Amazon Ads account**
> `add_negative_keywords` adds negative keywords to 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`](https://docs.launchfastlegacyx.com/mcp/ads-changes/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          | `add_negative_keywords`                                                                                                                                                                                       |
| Behavior          | Makes a change in your Amazon Ads account. Marked destructive, so your AI app may ask before it runs. It adds negatives and does not remove or replace anything, but the ads stop showing for those searches. |
| 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

`add_negative_keywords` adds negative keywords to one Sponsored Products campaign or ad group. The ads then stop showing for those searches. Each negative is `exact` or `phrase`. One call takes up to 100 negatives.

Without `ad_group`, the negatives apply to the full campaign. With `ad_group`, they apply to that ad group only.

## When To Use It

Use it to block a search term that spends without sales. Find these terms in the [search term report](https://docs.launchfastlegacyx.com/mcp/ads/search-term-performance) or in the waste list of an [Ads diagnostic](https://docs.launchfastlegacyx.com/mcp/ads/ads-diagnostics).

## Inputs

| Input                | Required | Values                                                                                                           | Example                                   |
| -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| `campaign`           | Yes      | The campaign name, or its `campaign_id`                                                                          | `SP Garlic Broad`                         |
| `ad_group`           | No       | The ad group name, for ad group negatives. Leave it out for the full campaign.                                   | `Garlic Press Broad`                      |
| `keywords`           | Yes      | A list of 1 to 100 negatives                                                                                     | See the rows below                        |
| `keywords[].keyword` | Yes      | The search to stop showing for                                                                                   | `electric garlic chopper`                 |
| `keywords[].match`   | Yes      | `exact` or `phrase`                                                                                              | `phrase`                                  |
| `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." | `Block searches that spend with no sales` |

## What The Answer Contains

* A status: `applied`, `partly applied`, `not applied`, `going through`, or `unconfirmed`.
* A table with the negatives added to the campaign or ad group, and the result.
* The change id (it starts with `ac-`). Use it with [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes) and [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/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`](https://docs.launchfastlegacyx.com/mcp/ads-changes/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

```text
Add "electric garlic chopper" as a phrase negative in SP Garlic Broad.
```

```text
Block the search terms that spent more than $20 last month with no sales.
```

## Common Errors

| Error                                                    | What it means                                                                                                                                                            | What to do                                                                                                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_input`: Amazon Ads will not take these keywords | A negative is listed twice, it would block an exact keyword of the same campaign or ad group, or it breaks an Amazon rule. The answer names each one and the cause.      | Remove those negatives. The answer gives the call without them.                                                                                                  |
| `invalid_input`: match is `exact` or `phrase`            | A negative has no match type, or it has `broad`.                                                                                                                         | Give `exact` or `phrase`.                                                                                                                                        |
| `invalid_input`: more than 100 items                     | The call has more than 100 negatives.                                                                                                                                    | Put the rest in another call.                                                                                                                                    |
| `not_found`                                              | No Sponsored Products campaign has that name, or the campaign has no ad group with that name. The answer lists similar campaign names, or the ad groups of the campaign. | Use a name from the answer, or find it with [`amazon_ads_entity_graph_lookup`](https://docs.launchfastlegacyx.com/mcp/ads/entity-graph).                                                           |
| `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](https://docs.launchfastlegacyx.com/mcp/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](https://docs.launchfastlegacyx.com/mcp/authentication#how-long-amazon-access-lasts). |
| `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](https://launchfastlegacyx.com/settings/mcp). 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`](https://docs.launchfastlegacyx.com/mcp/ads-changes/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.                                                                                                       |

## Related Tools

* [`amazon_ads_search_term_performance_lookup`](https://docs.launchfastlegacyx.com/mcp/ads/search-term-performance) finds searches that spend without sales.
* [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change) removes the added negatives.