ads_amc_turn_on

Turn Amazon Marketing Cloud (AMC) on for this store's Ads account in one country: finds the advertiser's AMC instance — creating it the first time — and remembers it.

writeAmazon Adsads.amc-administration

Every other AMC tool needs it on; get_user_context's amc says, per store and country, whether it is. Ask the seller before the first call: an AMC instance cannot be deleted. Calling it again is safe; when AMC is on it only reads. Amazon Ads API · listInstances · GET /amc/instances Amazon Ads API · ListAdsAccounts · POST /adsAccounts/list Docs: https://advertising.amazon.com/API/docs/en-us/amc-administration#tag/Instance-management/operation/listInstances Docs: https://advertising.amazon.com/API/docs/en-us/account-management#tag/Account/operation/ListAdsAccounts Gate: commit — interactive: restate exactly what will happen, wait for a typed CONFIRM; autopilot: only within the seller's instruction and stated limits; otherwise ask.

Call it

In an AI client (MCP)

tools/call
{
  "name": "ads_amc_turn_on",
  "arguments": {
    "store": "myStore-US",
    "country_code": "<country_code>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_amc_turn_on \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","country_code":"<country_code>"}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
country_coderequiredstringthe Ads profile's 2-letter country code (e.g. 'US'). One AMC instance per country of the Ads account.

Result

Every tool answers {notification, data, human_action}; data carries:

  • the orchestrated result described below.
  • data.instance_id — the store's AMC instance.
  • data.creation_status — COMPLETED, or IN_PROGRESS while Amazon builds it (up to 5 minutes; call again to finish).
  • data.already_on — true when nothing was created or looked up at Amazon.

Gotchas

  • Gate: commit — the first call creates an instance at Amazon that cannot be removed.
  • The Amazon login that connected Ads must accept the AMC terms once per region (NA, EU, FE) at https://advertising.amazon.com/marketing-cloud; until then the call is refused with error_code amc_terms_not_accepted. Only the seller can do it.
  • Amazon offers AMC to advertisers with campaigns live in the last 28 days.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude