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.
| Level | What your AI can do | Default |
|---|---|---|
| Read | Ask anything. Change nothing. | yes |
| Read + write | Ask 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.
| Tool | Access | What it answers | Ad types |
|---|---|---|---|
| list_accounts | read | The accounts and marketplaces you can read, and which days have data. | All |
| get_account_overview | read | Totals for a period, per ad type and per day. | All |
| get_campaigns | read | Performance per campaign. | SP · SB · SD |
| get_ad_groups | read | Performance per ad group. | SP · SB · SD |
| get_keywords | read | Performance per keyword and per target. | SP · SB · SD |
| get_search_terms | read | What shoppers actually searched for. | SP · SB |
| get_placements | read | Performance per placement. | SP · SB |
| get_products | read | Advertising performance per product. | SP · SD |
| get_ads | read | Performance per Sponsored Brands ad. | SB |
| get_purchased_products | read | What was bought after a click, when it was not the advertised product. | SP · SB · SD |
| get_matched_targets | read | Where Sponsored Display ads actually showed. | SD |
| get_invalid_traffic | read | Impressions and clicks Amazon discarded as invalid. | SP · SB · SD |
| get_product_history | read | Best-seller rank, price and availability of each product, day by day. | All |
| get_structure | read | The account as it is set up now. | SP · SB · SD |
What your AI will be able to change
| Tool | Access | Status | What it changes | Ad types |
|---|---|---|---|---|
| update_bids | write | planned | Set bids on keywords and targets. Up to 100 per call. | SP · SB · SD |
| add_keywords | write | planned | Add exact, phrase or broad keywords to an ad group. | SP · SB |
| add_negatives | write | planned | Add negative keywords or negative product targets, at ad group or campaign level. | SP · SB · SD |
| update_budgets | write | planned | Change campaign daily budgets. | SP · SB · SD |
| update_placements | write | planned | Set the bid adjustment per placement, from 0% to 900%. | SP |
| update_bidding_strategy | write | planned | Switch a campaign between dynamic down only, up and down, and fixed bids. | SP |
| set_campaign_state | write | planned | Pause or enable campaigns, ad groups, keywords and targets. | SP · SB · SD |
| update_portfolios | write | planned | Set portfolio budget caps and move campaigns between portfolios. | All |
| create_campaigns | write | planned | Create a campaign with its ad group, product ads and targets. It starts paused. | SP |
Not every ad type gets every change:
| Ad type | read live | write planned |
|---|---|---|
| Sponsored Products | Everything on this site | Bids, keywords, negatives, budgets, placement adjustments, bidding strategy, pause and enable, new campaigns |
| Sponsored Brands | Everything on this site | Bids, keywords, negatives, budgets, pause and enable |
| Sponsored Display | Everything on this site | Bids, 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_historywill return what was changed, when, and by which client. - One call changes at most 100 items.
More read tools on the way
| Tool | Access | Status | What it answers | Ad types |
|---|---|---|---|---|
| get_change_history | read | planned | Every change made through Adverso MCP: what, when and by which client. | All |
| get_total_sales | read | planned | Ad sales next to total and organic sales per product. | All |
| get_hourly_performance | read | planned | Impressions, clicks, spend and orders by hour of day. | SP · SB |
| get_budget_recommendations | read | planned | Amazon's suggested budgets and estimated missed sales per campaign. | SP |
| get_bid_recommendations | read | planned | Amazon's suggested bid range for a keyword or target. | SP |
| get_keyword_recommendations | read | planned | Amazon'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.