MCP server
Every tool, and what it changes.
42 tools: 24 read your Amazon account and 18 change it. Reading works on every plan; changes need the Agent plan, and the 14 that can spend money or can’t be undone should be confirmed every time.
Server URL
https://agent.autron.ai/api/mcpPaste it into any assistant that takes a remote MCP server. You’ll sign in with your Autron account.
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:readfor the read tools, on every plan.mcp:toolsadds the tools that change an account, on the Agent plan. 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(fromlist_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_metrics
ReadSales, 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.
- 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_metrics
ReadThe same metrics for one parent product and its variations.
- Returns
- The window’s metrics and breakdowns for that parent.
Inputs (4)
parent_asinstring, requiredrange"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"primary_metricsstring[]include_comparisonboolean
get_asin_metrics
ReadThe same metrics for one ASIN, including Search Query Performance and keyword gaps.
- Returns
- The window’s metrics and breakdowns for that ASIN.
Inputs (4)
asinstring, requiredrange"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"primary_metricsstring[]include_comparisonboolean
view_metrics_dashboard
ReadThe metrics above, laid out as charts for assistants that can show an embedded view.
- 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", requiredasinstringparent_asinstringrange"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"primary_metricsstring[]include_comparisonbooleansectionsobject[], requiredtype"metric-cards", requiredtitlestringmetricsstring[], required
Campaigns, targets and bids
Every campaign, ad group, ad, target and portfolio, with Amazon’s suggested bids.
query_campaigns
ReadCampaigns on the Amazon Ads account: name, state, ad product, daily budget, portfolio, start date, and whether Autron’s ad engine runs it.
- Returns
- A page of campaigns and a token for the next page.
Inputs (10)
adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"campaignIdsstring[]namestringnameMatchType"EXACT_MATCH" | "BROAD_MATCH"state("ENABLED" | "PAUSED" | "ARCHIVED")[]portfolioIdsstring[]maxResultsintegernextTokenstringgoal"reviews"includePlacementBidsboolean
query_ad_groups
ReadAd groups: name, parent campaign, state and default bid.
- Returns
- Up to 50 ad groups per page.
Inputs (8)
adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"campaignIdsstring[]adGroupIdsstring[]namestringnameMatchType"EXACT_MATCH" | "BROAD_MATCH"state("ENABLED" | "PAUSED" | "ARCHIVED")[]maxResultsintegernextTokenstring
query_ads
ReadAds: the ASIN or SKU advertised, its ad group and campaign, and state.
- Returns
- Up to 50 ads per page.
Inputs (9)
adProduct"SPONSORED_PRODUCTS" | "SPONSORED_BRANDS" | "SPONSORED_DISPLAY" | "SPONSORED_TELEVISION"campaignIdsstring[]adGroupIdsstring[]adIdsstring[]namestringnameMatchType"EXACT_MATCH" | "BROAD_MATCH"state("ENABLED" | "PAUSED" | "ARCHIVED")[]maxResultsintegernextTokenstring
query_targets
ReadKeyword and product targets, including negatives: match type, bid, expression and state.
- 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")[]negativebooleankeywordstringkeywordMatchType"EXACT_MATCH" | "BROAD_MATCH"productIdstringproductIdsstring[]productIdMatchType"EXACT_MATCH" | "BROAD_MATCH"maxResultsintegernextTokenstring
query_portfolios
ReadPortfolios: name, state and budget.
- Returns
- A page of portfolios.
Inputs (6)
portfolioIdsstring[]namestringnameMatchType"EXACT_MATCH" | "BROAD_MATCH"state("ENABLED" | "PAUSED" | "ARCHIVED")[]maxResultsintegernextTokenstring
get_bid_recommendations
ReadAmazon’s suggested bid range (low, suggested, high) for Sponsored Products targets, live or planned.
- Returns
- A range per target, with the live bid where the target exists.
Inputs (5)
campaignIdstringadGroupIdstringasinsstring[]expressionsobject[]type"KEYWORD_EXACT_MATCH" | "KEYWORD_BROAD_MATCH" | "KEYWORD_PHRASE_MATCH" | "CLOSE_MATCH" | "LOOSE_MATCH" | "SUBSTITUTES" | "COMPLEMENTS" | "ASIN_SAME_AS", requiredvaluestring
biddingStrategy"LEGACY_FOR_SALES" | "AUTO_FOR_SALES" | "MANUAL"
Questions your dashboards can’t answer
The long-tail questions about your own Amazon history.
query_analytics
ReadRead-only SQL over the seller’s own Amazon history, for questions the metrics tools can’t answer.
- Returns
- Up to 1,000 rows, or a CSV link for up to 50,000 rows that works for 30 days.
Inputs (3)
sqlstring, requiredformat"rows" | "csv"scope"profile" | "seller"
query_results
ReadRead-only SQL over rows Autron kept from an earlier large result, addressed by that result’s handle.
- Returns
- Up to 500 rows.
Inputs (1)
sqlstring, required
Products, listings and brand assets
Your catalogue, listing checks, brand assets and Store pages.
list_products
ReadThe seller’s catalogue in their main marketplace, with stock and Amazon ad eligibility.
- Returns
- A page of products.
Inputs (11)
pagenumberper_pagenumberasinstringasinsstring[]skustringproduct_namestringsearchstringstatusstringsort_by"product_name" | "asin" | "sku"sort_order"asc" | "desc"include_resaleboolean
validate_listing_content
ReadChecks a proposed title, bullets or search terms for trademarks, banned phrases, special characters and length limits.
- Returns
- Exact counts, the problems found and a cleaned-up version. Nothing is sent to Amazon.
Inputs (3)
titlestringbulletsstring[]searchTermsstring
list_brand_assets
ReadThe seller’s brands, with their registered videos and Store logos, for Sponsored Brands video.
- Returns
- Brands, videos with their processing status, and logos.
Inputs (1)
brandEntityIdstring
list_store_pages
ReadA brand’s live Brand Store pages.
- 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_goals
ReadAdvertising goals, and which products Autron’s ad engine runs.
- Returns
- Goals with their target and state, and each product’s ACoS over the last 30 days.
Inputs (4)
goal_state"enabled" | "disabled"product_asinstringpageintegerper_pageinteger
query_action_log
ReadEvery change made through Autron’s tools on this ad account, newest first, and who made it.
- 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[]fromstringtostringpageIndexintegerpageSizeintegerincludePayloadsboolean
get_autron_activity
ReadWhat Autron’s ad engine did in a period: bids optimised, campaigns and targets created, hours saved.
- Returns
- Counters, with the change from the previous period.
Inputs (2)
range"l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"include_comparisonboolean
get_review_automation
ReadWhether review-request automation is on for the seller’s marketplace.
- Returns
- On or off, and how many days after delivery requests go out.
No inputs.
list_sellers
ReadThe Amazon seller accounts this user can work in, and which one is active.
- Returns
- Sellers with their marketplaces.
Inputs (1)
search_termstring
Answers from the help centre
How Autron and Amazon work, quoted from the pages themselves.
autron_help_center_search
ReadSearches Autron’s help centre.
- Returns
- The best-matching articles, the full text of the top one, and its link.
Inputs (1)
querystring, required
autron_website_search
ReadSearches autron.ai, using OpenAI’s web search.
- Returns
- Relevant passages and links.
Inputs (1)
querystring, required
amazon_seller_central_search
ReadSearches Amazon Seller Central help for the seller’s home marketplace, using OpenAI’s web search.
- Returns
- Relevant passages and links.
Inputs (1)
querystring, required
Act · Agent plan
Tools that change your account
Launch campaigns
Sponsored Products and Sponsored Display. Sponsored Brands video starts in the Autron app.
create_sp_campaigns
Sensitive writeCreates Sponsored Products campaigns, each with one ad group, ad and target.
- 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[], requiredtype"auto" | "keyword" | "product" | "product_category", requiredasinstring, requiredskustringkeywordstringmatchType"EXACT" | "BROAD" | "PHRASE"targetProductIdstringtargetProductMatchType"PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"targetCategoryIdstringtargetCategoryMatchType"MULTISIGNAL_BROAD"targetCategoryBrandIdstringdailyBudgetnumberbidnumberstartDatestring
portfolioIdstringoutsideEngineboolean
create_sd_campaigns
Sensitive writeCreates Sponsored Display campaigns aimed at products, categories or shoppers who viewed a product.
- 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[], requiredtype"product" | "product_category" | "product_audience", requiredasinstring, requiredskustring, requiredtargetProductIdstringtargetProductMatchTypestringaudienceMatchTypestringtargetCategoryIdstringtargetCategoryBrandIdstringaudienceAsinstringaudienceEvent"VIEW" | "PURCHASE"audienceLookbackDaysnumbercostType"CPC" | "VCPM"dailyBudgetnumberbidnumberstartDatestring
portfolioIdstring
create_sb_campaigns
Sensitive writeCreates Sponsored Brands video campaigns from a registered video.
- 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[], requiredvideoAssetIdstringcreativeAssetIdstringbrandEntityIdstringvideoAssetVersionstringvideoOrientation"horizontal" | "vertical"landingPageType"STORE" | "DETAIL_PAGE", requiredlandingPageUrlstringasinsstring[]targeting"keyword" | "product" | object, requiredtypeanykeywordanyexpressionanyvalueanytextanymatchTypeanyproductIdanyasinSameAsanyasinanyproductanyasinsanybudgetanydailyBudgetanybidanydefaultBidany
keywordstringheadlinestringbrandLogoAssetIdstringmatchType"EXACT" | "BROAD" | "PHRASE"budgetnumberbidnumberdailyBudgetnumberdefaultBidnumberstartDatestring
portfolioIdstring
create_video_asset
WriteRegisters a video uploaded to Autron as an Amazon creative asset, ready for a Sponsored Brands video campaign.
- 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, requiredfilenamestring, requiredbrandEntityIdstring, requiredvideoOrientation"horizontal" | "vertical", requiredproductAsinsstring[], required
Change bids, budgets and placements
Target bids, placement adjustments, budgets and campaign state.
update_target_bids
Sensitive writeSets new bids on keyword and product targets.
- 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[], requiredtargetIdstring, requirednewBidnumber, required
update_campaign_placement_bids
Sensitive writeSets placement adjustments on campaigns: Top of Search, Rest of Search, product pages, Amazon Business and the home page.
- 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[], requiredcampaignIdstring, requiredtopOfSearchinteger | nullrestOfSearchinteger | nullproductPagesinteger | nullamazonBusinessinteger | nullhomePageinteger | nullclearAllboolean
update_campaigns
Sensitive writeEnables or pauses campaigns, or changes their name, daily budget or portfolio.
- 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[], requiredcampaignIdstring, requiredstate"ENABLED" | "PAUSED"namestringdailyBudgetnumberportfolioIdstring | null
Add and archive
New ads and targets, or archive what isn’t working.
add_ads
Sensitive writeAdds ads for a seller SKU to existing Sponsored Products or Sponsored Display ad groups.
- 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[], requiredadGroupIdstring, requiredskustring, required
add_targets
Sensitive writeAdds keyword, product, category or audience targets, or negatives, to existing ad groups.
- 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[], requiredadGroupIdstring, requiredtype"keyword" | "product" | "product_category" | "product_audience", requirednegativebooleanbidnumberkeywordstringmatchType"EXACT" | "BROAD" | "PHRASE"targetProductIdstringtargetProductMatchType"PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"targetCategoryIdstringtargetCategoryMatchType"MULTISIGNAL_BROAD"targetCategoryBrandIdstringaudienceAsinstringaudienceEvent"VIEW" | "PURCHASE"audienceLookbackDaysnumber
archive_campaigns
Sensitive writeArchives campaigns.
- 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_targets
Sensitive writeArchives targets, including negatives.
- 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, or hold a target back.
create_goal
Sensitive writeCreates an advertising goal for one product, a set of products, or the whole account.
- 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", requiredstrategy"maximum_acos" | "maximum_tacos"strategy_valuenumbergoal_type"product" | "global"product_asinstringproduct_asinsstring[]state"enabled" | "disabled"
update_goals
Sensitive writeSwitches goals, or the ad engine itself, on or off, or changes their target.
- 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[], requiredtype"product" | "global", requiredproduct_asinstringproduct_namestringstate"enabled" | "disabled"product_asinsstring[]objective"maximize_sales" | "maximize_profit"strategy"maximum_acos" | "maximum_tacos"strategy_valuenumberuse_global_goal_idstring
seed_ad_engine_targets
Sensitive writeHands Autron’s ad engine keywords or ASINs to launch, or negatives to mute.
- Changes
- Nothing changes on Amazon during the call. On its next daily run the engine builds and funds one campaign per keyword, 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, requiredproduct_namestringtargetsstring[], required
product_asinstringproduct_namestringdirection"positive" | "negative"type"keyword" | "product"match_types("exact" | "phrase" | "broad")[]targetsstring[]action"add" | "remove"replace_directionboolean
manage_directives
WriteLists, 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.
- 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", requireddirectiveType"hands_off" | "push"entityType"target" | "campaign" | "negative_keyword"listDirectiveType"hands_off" | "hold" | "block" | "push"resultsbooleanendedWithinDaysintegerentityIdsstring[]allbooleanbidCeilingnumberceilingsobject[]entityIdstring, requiredbidCeilingnumber, required
expiresInDaysintegerendsAtstringreasonstringlabelsobject[]entityIdstring, requiredlabelstring, required
extendDaysintegerpermanentboolean
Costs, reviews and workspaces
Product costs for real margins, review requests, and switching seller.
create_product_cost
WriteRecords a product’s cost of goods, shipping and other unit costs.
- 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, requiredproduct_asinstringproduct_namestringcost_of_goods_per_unitnumbershipping_cost_per_unitnumbermisc_cost_per_unitnumber
set_review_automation
Sensitive writeTurns review-request automation on or off, and sets how long after delivery it asks.
- 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", requiredsolicitation_delayinteger
switch_seller
WriteChanges which seller account and marketplace the connection works in.
- 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, requiredmarketplace_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: 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
readOnlyHintanddestructiveHint, 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_required— The connection is read-only. Reconnect and allow changes to use this tool.plan_required— Changing an account needs the Agent plan.credits_exhausted— The account has no credits left until its daily allowance refills or more are added.seller_not_found,seller_unresolvable— The seller_id doesn’t match a seller this user can see. Call list_sellers.missing_context— No Amazon Ads account is connected for this seller.invalid_input— An input failed validation; the message names it.product_not_found,marketplace_not_found— A 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_request— The same call is still in progress.amazon_api_error,auth_error— Amazon refused the request, or the Amazon connection needs reconnecting in Autron.no_seller_db— Analytics for this seller aren’t ready yet; the metrics tools still work.- HTTP 401 — the 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_analyticsreturns up to 1,000 rows, or up to 50,000 as a CSV link that works for 30 days.- Batch sizes are on each tool above.