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/mcp

Paste 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:read for the read tools, on every plan. mcp:tools adds 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 (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_metrics

Read

Sales, 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_metrics string[]
  • include_comparison boolean

get_parent_asin_metrics

Read

The same metrics for one parent product and its variations.

Returns
The window’s metrics and breakdowns for that parent.
Inputs (4)
  • parent_asin string, required
  • range "l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metrics string[]
  • include_comparison boolean

get_asin_metrics

Read

The same metrics for one ASIN, including Search Query Performance and keyword gaps.

Returns
The window’s metrics and breakdowns for that ASIN.
Inputs (4)
  • asin string, required
  • range "l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metrics string[]
  • include_comparison boolean

view_metrics_dashboard

Read

The 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", required
  • asin string
  • parent_asin string
  • range "l7d" | "l30d" | "l90d" | "last_month" | "last_quarter"
  • primary_metrics string[]
  • include_comparison boolean
  • sections object[], required
    • type "metric-cards", required
    • title string
    • metrics string[], required

Campaigns, targets and bids

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

query_campaigns

Read

Campaigns 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"
  • campaignIds string[]
  • name string
  • nameMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • state ("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • portfolioIds string[]
  • maxResults integer
  • nextToken string
  • goal "reviews"
  • includePlacementBids boolean

query_ad_groups

Read

Ad 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"
  • campaignIds string[]
  • adGroupIds string[]
  • name string
  • nameMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • state ("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResults integer
  • nextToken string

query_ads

Read

Ads: 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"
  • campaignIds string[]
  • adGroupIds string[]
  • adIds string[]
  • name string
  • nameMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • state ("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResults integer
  • nextToken string

query_targets

Read

Keyword 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"
  • campaignIds string[]
  • adGroupIds string[]
  • targetIds string[]
  • 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")[]
  • negative boolean
  • keyword string
  • keywordMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • productId string
  • productIds string[]
  • productIdMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • maxResults integer
  • nextToken string

query_portfolios

Read

Portfolios: name, state and budget.

Returns
A page of portfolios.
Inputs (6)
  • portfolioIds string[]
  • name string
  • nameMatchType "EXACT_MATCH" | "BROAD_MATCH"
  • state ("ENABLED" | "PAUSED" | "ARCHIVED")[]
  • maxResults integer
  • nextToken string

get_bid_recommendations

Read

Amazon’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)
  • campaignId string
  • adGroupId string
  • asins string[]
  • expressions object[]
    • type "KEYWORD_EXACT_MATCH" | "KEYWORD_BROAD_MATCH" | "KEYWORD_PHRASE_MATCH" | "CLOSE_MATCH" | "LOOSE_MATCH" | "SUBSTITUTES" | "COMPLEMENTS" | "ASIN_SAME_AS", required
    • value string
  • 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

Read

Read-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)
  • sql string, required
  • format "rows" | "csv"
  • scope "profile" | "seller"

query_results

Read

Read-only SQL over rows Autron kept from an earlier large result, addressed by that result’s handle.

Returns
Up to 500 rows.
Inputs (1)
  • sql string, required

Products, listings and brand assets

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

list_products

Read

The seller’s catalogue in their main marketplace, with stock and Amazon ad eligibility.

Returns
A page of products.
Inputs (11)
  • page number
  • per_page number
  • asin string
  • asins string[]
  • sku string
  • product_name string
  • search string
  • status string
  • sort_by "product_name" | "asin" | "sku"
  • sort_order "asc" | "desc"
  • include_resale boolean

validate_listing_content

Read

Checks 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)
  • title string
  • bullets string[]
  • searchTerms string

list_brand_assets

Read

The 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)
  • brandEntityId string

list_store_pages

Read

A brand’s live Brand Store pages.

Returns
Page names and URLs.
Inputs (1)
  • brandEntityId string, required

Goals and what changed

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

list_goals

Read

Advertising 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_asin string
  • page integer
  • per_page integer

query_action_log

Read

Every 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")[]
  • toolName string[]
  • from string
  • to string
  • pageIndex integer
  • pageSize integer
  • includePayloads boolean

get_autron_activity

Read

What 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_comparison boolean

get_review_automation

Read

Whether 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

Read

The Amazon seller accounts this user can work in, and which one is active.

Returns
Sellers with their marketplaces.
Inputs (1)
  • search_term string

Answers from the help centre

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

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 write

Creates 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)
  • campaigns object[], required
    • type "auto" | "keyword" | "product" | "product_category", required
    • asin string, required
    • sku string
    • keyword string
    • matchType "EXACT" | "BROAD" | "PHRASE"
    • targetProductId string
    • targetProductMatchType "PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"
    • targetCategoryId string
    • targetCategoryMatchType "MULTISIGNAL_BROAD"
    • targetCategoryBrandId string
    • dailyBudget number
    • bid number
    • startDate string
  • portfolioId string
  • outsideEngine boolean

create_sd_campaigns

Sensitive write

Creates 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)
  • campaigns object[], required
    • type "product" | "product_category" | "product_audience", required
    • asin string, required
    • sku string, required
    • targetProductId string
    • targetProductMatchType string
    • audienceMatchType string
    • targetCategoryId string
    • targetCategoryBrandId string
    • audienceAsin string
    • audienceEvent "VIEW" | "PURCHASE"
    • audienceLookbackDays number
    • costType "CPC" | "VCPM"
    • dailyBudget number
    • bid number
    • startDate string
  • portfolioId string

create_sb_campaigns

Sensitive write

Creates 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)
  • campaigns object[], required
    • videoAssetId string
    • creativeAssetId string
    • brandEntityId string
    • videoAssetVersion string
    • videoOrientation "horizontal" | "vertical"
    • landingPageType "STORE" | "DETAIL_PAGE", required
    • landingPageUrl string
    • asins string[]
    • targeting "keyword" | "product" | object, required
      • type any
      • keyword any
      • expression any
      • value any
      • text any
      • matchType any
      • productId any
      • asinSameAs any
      • asin any
      • product any
      • asins any
      • budget any
      • dailyBudget any
      • bid any
      • defaultBid any
    • keyword string
    • headline string
    • brandLogoAssetId string
    • matchType "EXACT" | "BROAD" | "PHRASE"
    • budget number
    • bid number
    • dailyBudget number
    • defaultBid number
    • startDate string
  • portfolioId string

create_video_asset

Write

Registers 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)
  • blobUrl string, required
  • filename string, required
  • brandEntityId string, required
  • videoOrientation "horizontal" | "vertical", required
  • productAsins string[], required

Change bids, budgets and placements

Target bids, placement adjustments, budgets and campaign state.

update_target_bids

Sensitive write

Sets 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)
  • updates object[], required
    • targetId string, required
    • newBid number, required

update_campaign_placement_bids

Sensitive write

Sets 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"
  • updates object[], required
    • campaignId string, required
    • topOfSearch integer | null
    • restOfSearch integer | null
    • productPages integer | null
    • amazonBusiness integer | null
    • homePage integer | null
    • clearAll boolean

update_campaigns

Sensitive write

Enables 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)
  • updates object[], required
    • campaignId string, required
    • state "ENABLED" | "PAUSED"
    • name string
    • dailyBudget number
    • portfolioId string | null

Add and archive

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

add_ads

Sensitive write

Adds 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"
  • ads object[], required
    • adGroupId string, required
    • sku string, required

add_targets

Sensitive write

Adds 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"
  • targets object[], required
    • adGroupId string, required
    • type "keyword" | "product" | "product_category" | "product_audience", required
    • negative boolean
    • bid number
    • keyword string
    • matchType "EXACT" | "BROAD" | "PHRASE"
    • targetProductId string
    • targetProductMatchType "PRODUCT_EXACT" | "PRODUCT_SIMILAR" | "PRODUCT_COMPLEMENTS" | "PRODUCT_REMARKETING"
    • targetCategoryId string
    • targetCategoryMatchType "MULTISIGNAL_BROAD"
    • targetCategoryBrandId string
    • audienceAsin string
    • audienceEvent "VIEW" | "PURCHASE"
    • audienceLookbackDays number

archive_campaigns

Sensitive write

Archives 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)
  • campaignIds string[], required

archive_targets

Sensitive write

Archives 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)
  • targetIds string[], required

Steer the ad engine

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

create_goal

Sensitive write

Creates 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", required
  • strategy "maximum_acos" | "maximum_tacos"
  • strategy_value number
  • goal_type "product" | "global"
  • product_asin string
  • product_asins string[]
  • state "enabled" | "disabled"

update_goals

Sensitive write

Switches 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_ids string[], required
  • type "product" | "global", required
  • product_asin string
  • product_name string
  • state "enabled" | "disabled"
  • product_asins string[]
  • objective "maximize_sales" | "maximize_profit"
  • strategy "maximum_acos" | "maximum_tacos"
  • strategy_value number
  • use_global_goal_id string

seed_ad_engine_targets

Sensitive write

Hands 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)
  • products object[]
    • product_asin string, required
    • product_name string
    • targets string[], required
  • product_asin string
  • product_name string
  • direction "positive" | "negative"
  • type "keyword" | "product"
  • match_types ("exact" | "phrase" | "broad")[]
  • targets string[]
  • action "add" | "remove"
  • replace_direction boolean

manage_directives

Write

Lists, 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", required
  • directiveType "hands_off" | "push"
  • entityType "target" | "campaign" | "negative_keyword"
  • listDirectiveType "hands_off" | "hold" | "block" | "push"
  • results boolean
  • endedWithinDays integer
  • entityIds string[]
  • all boolean
  • bidCeiling number
  • ceilings object[]
    • entityId string, required
    • bidCeiling number, required
  • expiresInDays integer
  • endsAt string
  • reason string
  • labels object[]
    • entityId string, required
    • label string, required
  • extendDays integer
  • permanent boolean

Costs, reviews and workspaces

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

create_product_cost

Write

Records 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_id string, required
  • product_asin string
  • product_name string
  • cost_of_goods_per_unit number
  • shipping_cost_per_unit number
  • misc_cost_per_unit number

set_review_automation

Sensitive write

Turns 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", required
  • solicitation_delay integer

switch_seller

Write

Changes 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_id string, required
  • marketplace_id string

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 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_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_analytics returns 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.

Ready to connect?