# Ad Changes

Source: https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes

See the Amazon Ads changes made through Launch Fast by an AI app or by Launchie, with the profit change of each change.

| Field             | Value                                                                          |
| ----------------- | ------------------------------------------------------------------------------ |
| MCP tool          | `get_ad_changes`                                                               |
| Behavior          | Read-only. It does not change your Amazon Ads account.                         |
| Cost              | Free                                                                           |
| Permission        | **Campaign performance** (Amazon Ads tools). Amazon verification is necessary. |
| Amazon connection | Amazon Ads                                                                     |
| App view          | None. The assistant shows the list as a table.                                 |

## What It Does

`get_ad_changes` lists the changes made to your Amazon Ads through Launch Fast. It shows changes by an AI app and by Launchie, the assistant in the Launch Fast app. For each change, it shows what changed and how it did.

Launch Fast measures the result as the profit change in the two weeks after the change, against the two weeks before it. Until the result is in, the detail of the change shows the day that it is due.

Campaign renames and Launchie settings changes are not in the list.

You can also see this history in Ad Changes in the Launch Fast iOS app. It is read-only there. To undo a change, ask your AI app. It uses [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change).

## When To Use It

* To see the changes made this month and their results.
* To find the `ac-` id of a change before you undo it.
* To check a change that was in progress when its answer came back.

## Inputs

| Input    | Required | Values                                                                  | Example                         |
| -------- | -------- | ----------------------------------------------------------------------- | ------------------------------- |
| `change` | No       | One change id, for its detail. Leave it out for the list.               | `ac-5k2x7tq3mvfcd2s4nt6ye6wpra` |
| `days`   | No       | The period of the list: `7`, `30` (default), or `90` days               | `90`                            |
| `cursor` | No       | The next page of the list, from the answer. Leave it out with `change`. |                                 |

## What The Answer Contains

The list shows up to 25 changes on each page, with these columns:

| Column          | Meaning                                                                    |
| --------------- | -------------------------------------------------------------------------- |
| `change`        | The change id                                                              |
| `what`          | What changed                                                               |
| `campaigns`     | The campaigns it changed. For an undo, the campaigns it put back.          |
| `applied_on`    | The day it was applied, in UTC                                             |
| `made_by`       | The AI app or Launchie                                                     |
| `state`         | `measured`, `measuring`, `reversed`, `not applied`, `no result`, or `undo` |
| `profit_change` | The profit change, when the change is measured                             |

| State         | Meaning                                                                                                                          |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `measured`    | The result is in.                                                                                                                |
| `measuring`   | The result is not in yet.                                                                                                        |
| `reversed`    | An undo or a later change put this change back, or a later change on the same setting took it over. It has no result of its own. |
| `not applied` | Amazon did not apply the change.                                                                                                 |
| `no result`   | The ads data for those weeks never arrived.                                                                                      |
| `undo`        | This change is an undo. It put back an earlier change.                                                                           |

A change in state `undo` is the undo itself. The change that it put back shows as `reversed`. When the page has an undo, the answer adds a note that says to count only the `reversed` changes as undone.

The list also adds up the profit change of the changes that are measured or still measuring. When no change in the period is measured or measuring, the summary says "None has a profit result yet." and the `profit_change` total is null, not $0.00.

The detail of one change shows each value that changed, its result, and the day that the result is due.

## Example Prompts

```text
What ad changes did we make in the last 30 days, and how did they do?
```

```text
Show the detail of change ac-5k2x7tq3mvfcd2s4nt6ye6wpra.
```

```text
Which changes from the last 90 days lost profit?
```

## Common Errors

| Error                                 | What it means                              | What to do                                                                                                  |
| ------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| `invalid_input`: days is 7, 30, or 90 | `days` has a different value.              | Use `7`, `30`, or `90`.                                                                                     |
| `invalid_input`: not an `ac-` id      | `change` is not a change id.               | Use an id from the list.                                                                                    |
| `not_found`: no Amazon Ads account    | Amazon Ads is not connected.               | Connect Amazon Ads in Launch Fast **Settings > Amazon**. See [Amazon Ads setup](https://docs.launchfastlegacyx.com/mcp/ads/setup).            |
| `not_found`: no ad change             | No change with that id is in your account. | List your changes without `change`.                                                                         |
| `mfa_required`                        | Amazon access for this AI app ended.       | Verify again in Launch Fast under **Settings > MCP & API keys**. See [Authentication](https://docs.launchfastlegacyx.com/mcp/authentication). |

## Related Tools

* [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change) puts back a change from the list.
* [`amazon_ads_campaign_performance_lookup`](https://docs.launchfastlegacyx.com/mcp/ads/campaign-performance) shows how a campaign did after a change.