Connecting

How a client signs in.

Transport
Streamable HTTP at the server URL above.
Sign-in
OAuth authorization code flow with PKCE (S256 only) and dynamic client registration. Clients are public and need no secret. Metadata at /.well-known/oauth-authorization-server.
Scopes
mcp:read for the read tools, on every plan. mcp:tools adds the tools that change an account, on the Agent and Pro plans. Anyone can choose read-only when they sign in.
Tokens
Access tokens last 90 days, refresh tokens a year and rotate on use. Revoke a connection any time in Settings › AI assistants.
Seller
Tools work on the connection’s active seller. Every read tool also takes an optional seller_id (from list_sellers) to run that one call against another seller the user can see.
Read · Every plan

Tools that read your account.

How your ads and sales are doing

Sales, spend, ACoS and TACoS for the account, a parent or one ASIN.

get_seller_metricsSales, ad spend, ACoS, TACoS and other metrics for the whole seller account over a fixed window, broken down by product, campaign, search term and placement.Read
Returns
The window’s metrics, optionally against the previous window, with their breakdowns.
Inputs (3)
  • range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metricsstring[]
  • include_comparisonboolean
get_parent_asin_metricsThe same metrics for one parent product and its variations.Read
Returns
The window’s metrics and breakdowns for that parent.
Inputs (4)
  • parent_asinstring, required
  • range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metricsstring[]
  • include_comparisonboolean
get_asin_metricsThe same metrics for one ASIN, including Search Query Performance and keyword gaps.Read
Returns
The window’s metrics and breakdowns for that ASIN.
Inputs (4)
  • asinstring, required
  • range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metricsstring[]
  • include_comparisonboolean
view_metrics_dashboardThe metrics above, laid out as charts for assistants that can show an embedded view.Read
Returns
The metrics and the chart sections asked for; the charts themselves where the assistant can draw them.
Inputs (7)
  • scope"seller" | "asin" | "parent_asin", required
  • asinstring
  • parent_asinstring
  • range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metricsstring[]
  • include_comparisonboolean
  • sectionsobject[], required
    • type"metric-cards", required
    • titlestring
    • metricsstring[], required

Campaigns, targets and bids

Every campaign, ad group, ad, target and portfolio, with Amazon’s suggested bids.

query_campaignsCampaigns on the Amazon Ads account: name, state, ad product, daily budget, portfolio, start date, and whether Autron’s ad engine runs it.Read
Returns
A page of campaigns and a token for the next page.
Inputs (10)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"
  • campaignIdsstring[]
  • namestring
  • nameMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • state("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • portfolioIdsstring[]
  • maxResultsinteger
  • nextTokenstring
  • goal"reviews"
  • includePlacementBidsboolean
query_ad_groupsAd groups: name, parent campaign, state and default bid.Read
Returns
Up to 50 ad groups per page.
Inputs (8)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"
  • campaignIdsstring[]
  • adGroupIdsstring[]
  • namestring
  • nameMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • state("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResultsinteger
  • nextTokenstring
query_adsAds: the ASIN or SKU advertised, its ad group and campaign, and state.Read
Returns
Up to 50 ads per page.
Inputs (9)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"
  • campaignIdsstring[]
  • adGroupIdsstring[]
  • adIdsstring[]
  • namestring
  • nameMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • state("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResultsinteger
  • nextTokenstring
query_targetsKeyword and product targets, including negatives: match type, bid, expression and state.Read
Returns
Up to 50 targets per page.
Inputs (15)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"
  • campaignIdsstring[]
  • adGroupIdsstring[]
  • targetIdsstring[]
  • state("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • targetType("KEYWORD" | "PRODUCT" | "PRODUCT_CATEGORY" | "PRODUCT_AUDIENCE" | "AUDIENCE" | "THEME")[]
  • matchType("EXACT" | "PHRASE" | "BROAD" | "PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING" | "PRODUCT_SUBSTITUTES" | "MULTISIGNAL_BROAD")[]
  • negativeboolean
  • keywordstring
  • keywordMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • productIdstring
  • productIdsstring[]
  • productIdMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • maxResultsinteger
  • nextTokenstring
query_portfoliosPortfolios: name, state and budget.Read
Returns
A page of portfolios.
Inputs (6)
  • portfolioIdsstring[]
  • namestring
  • nameMatchType"EXACT_MATCH" | "BROAD_MATCH"
  • state("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResultsinteger
  • nextTokenstring

Questions your dashboards can’t answer

The long-tail questions about your own Amazon history.

query_analyticsRead-only SQL over the seller’s own Amazon history, for questions the metrics tools can’t answer.Read
Returns
Up to 1,000 rows, returned in the conversation.
Inputs (2)
  • sqlstring, required
  • scope"profile" | "seller"

Products, listings and brand assets

Your catalogue, listing checks, brand assets and Store pages.

list_productsThe seller’s catalogue in their main marketplace, with stock and Amazon ad eligibility.Read
Returns
A page of products.
Inputs (11)
  • pagenumber
  • per_pagenumber
  • asinstring
  • asinsstring[]
  • skustring
  • product_namestring
  • searchstring
  • statusstring
  • sort_by"product_name" | "asin" | "sku"
  • sort_order"asc" | "desc"
  • include_resaleboolean
validate_listing_contentChecks a proposed title, bullets or search terms for trademarks, banned phrases, special characters and length limits.Read
Returns
Exact counts, the problems found and a cleaned-up version. Nothing is sent to Amazon.
Inputs (3)
  • titlestring
  • bulletsstring[]
  • searchTermsstring
list_brand_assetsThe seller’s brands, with their registered videos and Store logos, for Sponsored Brands video.Read
Returns
Brands, videos with their processing status, and logos.
Inputs (1)
  • brandEntityIdstring
list_store_pagesA brand’s live Brand Store pages.Read
Returns
Page names and URLs.
Inputs (1)
  • brandEntityIdstring, required

Goals and what changed

Your goals, the changes made through Autron, and the engine’s recent work.

list_goalsAdvertising goals, and which products Autron’s ad engine runs.Read
Returns
Goals with their target and state, and each product’s ACoS over the last 30 days.
Inputs (4)
  • goal_state"enabled" | "disabled"
  • product_asinstring
  • pageinteger
  • per_pageinteger
query_action_logEvery change made through Autron’s tools on this ad account, newest first, and who made it.Read
Returns
Tool, status (pending, success, partial, failed or rolled back), time, the person’s name and a preview of the request; full payloads on request.
Inputs (7)
  • status("pending" | "success" | "partial" | "failed" | "rolled_back")[]
  • toolNamestring[]
  • fromstring
  • tostring
  • pageIndexinteger
  • pageSizeinteger
  • includePayloadsboolean
get_autron_activityWhat Autron’s ad engine did in a period: bids optimised, campaigns and targets created, hours saved.Read
Returns
Counters, with the change from the previous period.
Inputs (2)
  • range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • include_comparisonboolean
get_review_automationWhether review-request automation is on for the seller’s marketplace.Read
Returns
On or off, and how many days after delivery requests go out.
Inputs
No inputs.
list_spend_plansThe seller’s spend plans — the money they want spent on advertising per day, per month or over set dates, on the account, a portfolio or a product — and, once Autron’s Bid Kernel has run with a plan, how it is pacing.Read
Returns
Each plan in plain words with its dates, cap and reserve, and the kernel’s latest reading: on pace, ahead or behind, spent against expected, what is left and what today allows.
Inputs (1)
  • includeEndedboolean
list_sellersThe Amazon seller accounts this user can work in, and which one is active.Read
Returns
Sellers with their marketplaces.
Inputs (1)
  • search_termstring

Answers from the help centre

How Autron and Amazon work, quoted from the pages themselves.

Act · Agent and Pro

Tools that change your account.

Launch campaigns

Sponsored Products, Sponsored Display and Sponsored Brands collections. Sponsored Brands video starts in the Autron app, where the video is attached.

create_sp_campaignsCreates Sponsored Products campaigns, each with one ad group, ad and target.Sensitive write
Changes
Live campaigns on the Amazon Ads account, which start spending against their daily budget.
Undo
Pause them with update_campaigns. Archiving is permanent.
Limit
20 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (3)
  • campaignsobject[], required
    • type"auto" | "keyword" | "product" | "product_category", required
    • asinstring, required
    • skustring
    • keywordstring
    • matchType"EXACT" | "BROAD" | "PHRASE"
    • targetProductIdstring
    • targetProductMatchType"PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"
    • targetCategoryIdstring
    • targetCategoryMatchType"MULTISIGNAL_BROAD"
    • targetCategoryBrandIdstring
    • dailyBudgetnumber
    • bidnumber
    • startDatestring
  • portfolioIdstring
  • outsideEngineboolean
create_sd_campaignsCreates Sponsored Display campaigns aimed at products, categories or shoppers who viewed a product.Sensitive write
Changes
Live campaigns on the Amazon Ads account, which start spending against their daily budget.
Undo
Pause them with update_campaigns. Archiving is permanent.
Limit
20 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (2)
  • campaignsobject[], required
    • type"product" | "product_category" | "product_audience", required
    • asinstring, required
    • skustring, required
    • targetProductIdstring
    • targetProductMatchTypestring
    • audienceMatchTypestring
    • targetCategoryIdstring
    • targetCategoryBrandIdstring
    • audienceAsinstring
    • audienceEvent"VIEW" | "PURCHASE"
    • audienceLookbackDaysnumber
    • costType"CPC" | "VCPM"
    • dailyBudgetnumber
    • bidnumber
    • startDatestring
  • portfolioIdstring
create_sb_campaignsCreates Sponsored Brands video campaigns from a registered video.Sensitive write
Changes
Live campaigns on the Amazon Ads account, which start spending against their daily budget.
Undo
Pause them with update_campaigns. Archiving is permanent.
Limit
20 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (2)
  • campaignsobject[], required
    • videoAssetIdstring
    • creativeAssetIdstring
    • brandEntityIdstring
    • videoAssetVersionstring
    • videoOrientation"horizontal" | "vertical"
    • landingPageType"STORE" | "DETAIL_PAGE", required
    • landingPageUrlstring
    • asinsstring[]
    • targeting"keyword" | "product" | object, required
      • typeany
      • keywordany
      • expressionany
      • valueany
      • textany
      • matchTypeany
      • productIdany
      • asinSameAsany
      • asinany
      • productany
      • asinsany
      • budgetany
      • dailyBudgetany
      • bidany
      • defaultBidany
    • keywordstring
    • headlinestring
    • brandLogoAssetIdstring
    • matchType"EXACT" | "BROAD" | "PHRASE"
    • budgetnumber
    • bidnumber
    • dailyBudgetnumber
    • defaultBidnumber
    • startDatestring
  • portfolioIdstring
create_sb_collection_campaignsCreates Sponsored Brands collection campaigns: a manual collection of 3 to 10 chosen products, or an automatic one Amazon fills from the brand's catalog. No video needed.Sensitive write
Changes
Live campaigns on the Amazon Ads account, which start spending against their daily budget.
Undo
Pause them with update_campaigns. Archiving is permanent.
Limit
20 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (2)
  • campaignsobject[], required
    • type"auto" | "manual"
    • asinsstring[]
    • excludeAsinsstring[]
    • landingPageType"ASIN_LIST" | "STORE"
    • landingPageUrlstring
    • titlestring
    • brandLogoAssetIdstring
    • brandEntityIdstring
    • targeting"keyword" | "product" | object, required
      • typeany
      • keywordany
      • expressionany
      • valueany
      • textany
      • matchTypeany
      • productIdany
      • asinSameAsany
      • asinany
      • productany
      • asinsany
      • budgetany
      • dailyBudgetany
      • bidany
      • defaultBidany
      • excludeAsinsany
      • titleany
      • landingPageTypeany
      • landingPageUrlany
      • brandLogoAssetIdany
      • brandEntityIdany
    • keywordstring
    • matchType"EXACT" | "BROAD" | "PHRASE"
    • budgetnumber
    • bidnumber
    • dailyBudgetnumber
    • defaultBidnumber
    • startDatestring
  • portfolioIdstring
create_video_assetRegisters a video uploaded to Autron as an Amazon creative asset, ready for a Sponsored Brands video campaign.Write
Changes
Adds the video to the brand’s Amazon Creative Asset Library. Spends nothing.
Undo
None through Autron; the video stays in the library unused.
Limit
One video per call.
Returns
The asset and its processing status, or Amazon’s reasons for rejecting the video.
Inputs (5)
  • blobUrlstring, required
  • filenamestring, required
  • brandEntityIdstring, required
  • videoOrientation"horizontal" | "vertical", required
  • productAsinsstring[], required

Change bids, budgets and placements

Suggested bid ranges, target bids, placement adjustments, budgets and campaign state.

get_bid_recommendationsAmazon’s suggested bid range (low, suggested, high) for Sponsored Products targets, live or planned.Read
Returns
A range per target, with the live bid where the target exists.
Inputs (5)
  • campaignIdstring
  • adGroupIdstring
  • asinsstring[]
  • expressionsobject[]
    • type"KEYWORD_EXACT_MATCH" | "KEYWORD_BROAD_MATCH" | "KEYWORD_PHRASE_MATCH" | "CLOSE_MATCH" | "LOOSE_MATCH" | "SUBSTITUTES" | "COMPLEMENTS" | "ASIN_SAME_AS", required
    • valuestring
  • biddingStrategy"LEGACY_FOR_SALES" | "AUTO_FOR_SALES" | "MANUAL"
update_target_bidsSets new bids on keyword and product targets.Sensitive write
Changes
Bids on the Amazon Ads account, from the next auction. A higher bid can raise spend.
Undo
Set the old bid again; the action log keeps it.
Limit
1,000 targets per call.
Returns
How many bids changed, and any that failed.
Inputs (1)
  • updatesobject[], required
    • targetIdstring, required
    • newBidnumber, required
update_campaign_placement_bidsSets placement adjustments on campaigns: Top of Search, Rest of Search, product pages, Amazon Business and the home page.Sensitive write
Changes
Placement adjustments on the Amazon Ads account: 0% to +900% on Sponsored Products, −99% to +900% on Sponsored Brands. A higher adjustment can raise spend.
Undo
Set the old adjustment again.
Limit
50 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (2)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION" | "AMAZON_DSP"
  • updatesobject[], required
    • campaignIdstring, required
    • topOfSearchinteger | null
    • restOfSearchinteger | null
    • productPagesinteger | null
    • amazonBusinessinteger | null
    • homePageinteger | null
    • clearAllboolean
update_campaignsEnables or pauses campaigns, or changes their name, daily budget or portfolio.Sensitive write
Changes
Campaigns on the Amazon Ads account. Enabling a campaign or raising its budget can raise spend.
Undo
Set the old value again.
Limit
50 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (1)
  • updatesobject[], required
    • campaignIdstring, required
    • state"ENABLED" | "PAUSED"
    • namestring
    • dailyBudgetnumber
    • portfolioIdstring | null

Add and archive

New ads and targets, or archive what isn’t working.

add_adsAdds ads for a seller SKU to existing Sponsored Products or Sponsored Display ad groups.Sensitive write
Changes
New, enabled ads, which spend through their campaign.
Undo
Pause the campaign, or archive the ad (permanent).
Limit
100 ads per call.
Returns
Each ad created, already there, or failed.
Inputs (2)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_DISPLAY"
  • adsobject[], required
    • adGroupIdstring, required
    • skustring, required
add_targetsAdds keyword, product, category or audience targets, or negatives, to existing ad groups.Sensitive write
Changes
New, enabled targets, which can spend; or negatives, which stop matching traffic and which Autron’s ad engine then leaves in place.
Undo
Archive the target (permanent).
Limit
100 targets per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (2)
  • adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY"
  • targetsobject[], required
    • adGroupIdstring, required
    • type"keyword" | "product" | "product_category" | "product_audience", required
    • negativeboolean
    • bidnumber
    • keywordstring
    • matchType"EXACT" | "BROAD" | "PHRASE"
    • targetProductIdstring
    • targetProductMatchType"PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"
    • targetCategoryIdstring
    • targetCategoryMatchType"MULTISIGNAL_BROAD"
    • targetCategoryBrandIdstring
    • audienceAsinstring
    • audienceEvent"VIEW" | "PURCHASE"
    • audienceLookbackDaysnumber
archive_campaignsArchives campaigns.Sensitive write
Changes
The campaigns stop for good: Amazon can’t re-enable an archived campaign.
Undo
None. To stop a campaign for now, pause it with update_campaigns.
Limit
100 campaigns per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (1)
  • campaignIdsstring[], required
archive_targetsArchives targets, including negatives.Sensitive write
Changes
The targets stop for good: Amazon can’t re-enable an archived target.
Undo
None. Add the target again as a new one.
Limit
100 targets per call.
Returns
Each item’s success or failure; one failure doesn’t stop the rest.
Inputs (1)
  • targetIdsstring[], required

Steer the ad engine

Set and change goals, hand it targets, hold a target back, or give it a spending envelope.

create_goalCreates an advertising goal for one product, a set of products, or the whole account.Sensitive write
Changes
Autron’s ad engine starts advertising those products to the goal’s target, which spends money.
Undo
Switch the goal off with update_goals.
Limit
500 products per call.
Returns
A confirmation, in plain text.
Inputs (7)
  • objective"maximize_sales" | "maximize_profit", required
  • strategy"maximum_acos" | "maximum_tacos"
  • strategy_valuenumber
  • goal_type"product" | "global"
  • product_asinstring
  • product_asinsstring[]
  • state"enabled" | "disabled"
update_goalsSwitches goals, or the ad engine itself, on or off, or changes their target.Sensitive write
Changes
Starts or stops Autron’s ad engine on products, or changes the ACoS or TACoS it aims for.
Undo
Set the old state or target again.
Returns
A confirmation, in plain text.
Inputs (10)
  • public_idsstring[], required
  • type"product" | "global", required
  • product_asinstring
  • product_namestring
  • state"enabled" | "disabled"
  • product_asinsstring[]
  • objective"maximize_sales" | "maximize_profit"
  • strategy"maximum_acos" | "maximum_tacos"
  • strategy_valuenumber
  • use_global_goal_idstring
seed_ad_engine_targetsHands Autron’s ad engine keywords or ASINs to launch, or negatives to mute.Sensitive write
Changes
Nothing changes on Amazon during the call. From its next daily run the engine builds and funds one campaign per keyword, up to 20 a day ahead of its own finds, and applies negatives to every campaign it runs for the product.
Undo
Pause or archive what the engine builds.
Limit
10 products and 100 targets each per call.
Returns
Per product, what was accepted and whether it waits for the product to be switched on.
Inputs (9)
  • productsobject[]
    • product_asinstring, required
    • product_namestring
    • targetsstring[], required
  • product_asinstring
  • product_namestring
  • direction"positive" | "negative"
  • type"keyword" | "product"
  • match_types("exact" | "phrase" | "broad")[]
  • targetsstring[]
  • action"add" | "remove"
  • replace_directionboolean
manage_directivesLists, adds, extends or releases the places where the seller has stepped in and Autron’s ad engine stands back: holds, bid ceilings and negative blocks.Write
Changes
Autron’s own settings only; no Amazon call. Releasing a block lets the engine remove that negative later.
Undo
Add or release it again.
Limit
1,000 campaigns or targets per call.
Returns
What was added, extended or released, or the rows asked for.
Inputs (16)
  • action"list" | "create" | "release" | "extend", required
  • directiveType"hands_off" | "push"
  • entityType"target" | "campaign" | "negative_keyword"
  • listDirectiveType"hands_off" | "hold" | "block" | "push"
  • resultsboolean
  • endedWithinDaysinteger
  • entityIdsstring[]
  • allboolean
  • bidCeilingnumber
  • ceilingsobject[]
    • entityIdstring, required
    • bidCeilingnumber, required
  • expiresInDaysinteger
  • endsAtstring
  • reasonstring
  • labelsobject[]
    • entityIdstring, required
    • labelstring, required
  • extendDaysinteger
  • permanentboolean
set_spend_planSets, edits or ends a spend plan: an amount per day, per calendar month or in total over set dates, as a hard cap or a soft ceiling, with a share held back for events.Write
Changes
Autron only, no Amazon call: the plan the Bid Kernel paces campaign budgets to from its next run. On an account the kernel does not run yet, nothing changes until it does.
Undo
Set it again, or end it.
Returns
The plan as set, in plain words.
Inputs (12)
  • action"set" | "end", required
  • scope"account" | "portfolio" | "product", required
  • portfolioIdstring
  • asinstring
  • amountnumber
  • period"daily" | "monthly" | "fixed"
  • startsOnstring
  • endsOnstring
  • noEndboolean
  • cap"hard" | "soft"
  • reservednumber
  • reasonstring

Costs, reviews and workspaces

Product costs for real margins, review requests, and switching seller.

create_product_costRecords a product’s cost of goods, shipping and other unit costs.Write
Changes
Autron only: a new cost entry, used for profit figures. Spends nothing.
Undo
Record a newer cost.
Returns
A confirmation, in plain text.
Inputs (6)
  • product_public_idstring, required
  • product_asinstring
  • product_namestring
  • cost_of_goods_per_unitnumber
  • shipping_cost_per_unitnumber
  • misc_cost_per_unitnumber
set_review_automationTurns review-request automation on or off, and sets how long after delivery it asks.Sensitive write
Changes
While on, Autron asks Amazon to send each eligible buyer Amazon’s own standard review request, once, 8 to 30 days after delivery.
Undo
Turn it off.
Returns
A confirmation, in plain text.
Inputs (2)
  • state"enabled" | "disabled", required
  • solicitation_delayinteger
switch_sellerChanges which seller account and marketplace the connection works in.Write
Changes
Autron only: the connection’s active seller, which is also the user’s default seller in the Autron app.
Undo
Switch back.
Returns
The newly active seller and marketplace.
Inputs (2)
  • seller_idstring, required
  • marketplace_idstring
Reference

Changes, errors and limits.

How changes behave

  • A change runs once, when it is called. Goals and seeds are the exception. Autron’s ad engine acts on them in its next run.
  • A batch reports each item’s success or failure, and one failure doesn’t stop the rest.
  • Every change to Amazon Ads made through these tools is recorded in the action log with its status. That is pending, success, partial, failed or rolled back. Read it with query_action_log.
  • An identical call made while the first is still pending is refused with duplicate_request. After a timeout, check the action log before trying again.
  • Archiving is permanent on Amazon. To stop a campaign or target for now, pause it or lower its bid.
  • Every tool carries MCP’s readOnlyHint and destructiveHint, so an assistant can ask before each change. Sensitive writes should be confirmed every time.

Errors

A refused call answers in the tool result, as { "ok": false, "error", "message" }. The message is written to be shown to the person.

  • scope_requiredThe connection is read-only. Reconnect and allow changes to use this tool.
  • plan_requiredChanging an account needs the Agent or Pro plan.
  • credits_exhaustedThe account has no credits left until its daily allowance refills or more are added.
  • seller_not_found seller_unresolvableThe seller_id doesn’t match a seller this user can see. Call list_sellers.
  • missing_contextNo Amazon Ads account is connected for this seller.
  • invalid_inputAn input failed validation. The message names it.
  • product_not_found marketplace_not_foundA product or marketplace named in the call isn’t on this seller’s account. Look it up again with list_products or list_sellers.
  • duplicate_requestThe same call is still in progress.
  • amazon_api_error auth_errorAmazon refused the request, or the Amazon connection needs reconnecting in Autron.
  • no_seller_dbAnalytics for this seller aren’t ready yet. The metrics tools still work.
  • HTTP 401The token expired or was revoked. Sign in again.

Limits

  • Each call costs one Autron credit, reads included. A refused call costs nothing. The Free plan gets 5 credits a day, up to 30 held.
  • A result is capped at 50,000 characters. Long lists come in pages.
  • query_analytics returns up to 1,000 rows, in the conversation.
  • Batch sizes are on each tool above.

Ready to connect?

Add Autron to Claude or ChatGPT, or paste the server URL into any assistant that takes a remote MCP server.