Adverso
Browse all topics

Read and write

What your AI can read today, what it will be able to change on Amazon, and how you stay in control.

Adverso MCP has two kinds of tools. Read tools answer questions. Write tools change something on Amazon: a bid, a budget, a keyword.

Two access levels

You choose the level for each marketplace in the dashboard.

LevelWhat your AI can doDefault
ReadAsk anything. Change nothing.yes
Read + writeAsk anything, and make the changes listed below.no, you switch it on

list_accounts returns the level of each marketplace in access, so your AI knows where it may make changes.

What your AI can read

Fourteen tools, live today. Details are in the tool reference, and every field they return is in All fields.

ToolAccessWhat it answersAd types
list_accountsreadThe accounts and marketplaces you can read, and which days have data.All
get_account_overviewreadTotals for a period, per ad type and per day.All
get_campaignsreadPerformance per campaign.SP · SB · SD
get_ad_groupsreadPerformance per ad group.SP · SB · SD
get_keywordsreadPerformance per keyword and per target.SP · SB · SD
get_search_termsreadWhat shoppers actually searched for.SP · SB
get_placementsreadPerformance per placement.SP · SB
get_productsreadAdvertising performance per product.SP · SD
get_adsreadPerformance per Sponsored Brands ad.SB
get_purchased_productsreadWhat was bought after a click, when it was not the advertised product.SP · SB · SD
get_matched_targetsreadWhere Sponsored Display ads actually showed.SD
get_invalid_trafficreadImpressions and clicks Amazon discarded as invalid.SP · SB · SD
get_product_historyreadBest-seller rank, price and availability of each product, day by day.All
get_structurereadThe account as it is set up now.SP · SB · SD

What your AI will be able to change

ToolAccessStatusWhat it changesAd types
update_bidswriteplannedSet bids on keywords and targets. Up to 100 per call.SP · SB · SD
add_keywordswriteplannedAdd exact, phrase or broad keywords to an ad group.SP · SB
add_negativeswriteplannedAdd negative keywords or negative product targets, at ad group or campaign level.SP · SB · SD
update_budgetswriteplannedChange campaign daily budgets.SP · SB · SD
update_placementswriteplannedSet the bid adjustment per placement, from 0% to 900%.SP
update_bidding_strategywriteplannedSwitch a campaign between dynamic down only, up and down, and fixed bids.SP
set_campaign_statewriteplannedPause or enable campaigns, ad groups, keywords and targets.SP · SB · SD
update_portfolioswriteplannedSet portfolio budget caps and move campaigns between portfolios.All
create_campaignswriteplannedCreate a campaign with its ad group, product ads and targets. It starts paused.SP

Not every ad type gets every change:

Ad typeread livewrite planned
Sponsored ProductsEverything on this siteBids, keywords, negatives, budgets, placement adjustments, bidding strategy, pause and enable, new campaigns
Sponsored BrandsEverything on this siteBids, keywords, negatives, budgets, pause and enable
Sponsored DisplayEverything on this siteBids, budgets, negative targets, pause and enable

How you stay in control

  • Write is off until you switch it on. Every marketplace starts on Read. Switching one marketplace to Read + write does not change the others.
  • Your AI asks first. The approval happens in your AI client: it shows the change it wants to make and waits for your yes. Do not choose "always allow" for write tools.
  • A client without a person has no approval step. A script or an automated agent runs whatever it decides. Keep such clients on marketplaces set to Read.
  • Every change is logged. get_change_history will return what was changed, when, and by which client.
  • One call changes at most 100 items.

More read tools on the way

ToolAccessStatusWhat it answersAd types
get_change_historyreadplannedEvery change made through Adverso MCP: what, when and by which client.All
get_total_salesreadplannedAd sales next to total and organic sales per product.All
get_hourly_performancereadplannedImpressions, clicks, spend and orders by hour of day.SP · SB
get_budget_recommendationsreadplannedAmazon's suggested budgets and estimated missed sales per campaign.SP
get_bid_recommendationsreadplannedAmazon's suggested bid range for a keyword or target.SP
get_keyword_recommendationsreadplannedAmazon's suggested keywords for an ad group or a product.SP

Two things you may be looking for already exist under another name: product and automatic targets come from get_keywords, and negatives from get_structure with type set to negatives.