Tool reference
The 44 tools your AI app can call, what each one does and which ones can change anything (five, all behind a preview).
Updated
In short
WavyCloud exposes 17 Amazon Ads API tools and 27 Selling Partner API tools to your AI app. All of them read, except five ads tools that change bids, budgets, keyword state or negatives. Those five return a dry-run preview unless the call includes confirm: true.
How tools work
You never call these yourself. You ask a question, and your AI app picks the tools it needs, calls them through WavyCloud and reads the results. Knowing the list helps you ask sharper questions and check what the AI actually did.
A few rules apply to every tool:
- Money comes back as an amount plus a currency code (Seller Central) or a plain number in the profile's currency (Amazon Ads).
- Dates are ISO 8601. Ads report dates are
YYYY-MM-DDin the ad profile's time zone. - Long lists are paged. When a result includes
nextToken, the AI passes it back to get the next page. - Marketplace defaults to the one you set in WavyCloud. Ask for another by name or ID.
Amazon Ads API tools
Scoped to one ad profile. Sponsored Products only for now.
| Tool | What it does | Access |
|---|---|---|
amazon_ads_connection_status | Checks the ads connection and default profile | Read |
amazon_ads_list_profiles | Lists the ad profiles you connected | Read |
amazon_ads_list_campaigns | Campaigns with state, budget and targeting type | Read |
amazon_ads_list_ad_groups | Ad groups and default bids | Read |
amazon_ads_list_product_ads | Which ASINs and SKUs advertise where | Read |
amazon_ads_list_keywords | Keywords with match type, bid and state | Read |
amazon_ads_list_targets | Product and category targets, auto-targeting groups | Read |
amazon_ads_list_negative_keywords | Negative exact and negative phrase keywords | Read |
amazon_ads_get_keyword_bid_recommendations | Amazon's suggested bids for keywords | Read |
amazon_ads_create_report | Queues a report: search terms, keywords, targets or campaigns | Read |
amazon_ads_get_report | Checks whether a report is ready | Read |
amazon_ads_get_report_document | Downloads and unpacks a finished report | Read |
amazon_ads_update_campaigns | Changes campaign state or daily budget | Write, preview first |
amazon_ads_update_keyword_bids | Changes keyword bids | Write, preview first |
amazon_ads_update_target_bids | Changes product target bids | Write, preview first |
amazon_ads_update_keyword_state | Pauses or enables keywords | Write, preview first |
amazon_ads_create_negative_keywords | Adds negative exact or phrase keywords | Write, preview first |
Selling Partner API tools
Seller Central data. Every one of these is read-only. Nothing here can change a listing, a price or your inventory.
| Tool | What it does |
|---|---|
amazon_connection_status | Checks the Seller Central connection |
amazon_get_seller_account | Your seller account and marketplaces |
amazon_list_orders | Orders by date, status or channel |
amazon_get_order | One order's details, without buyer name or address |
amazon_get_order_items | The items in an order |
amazon_get_order_metrics | Sales, units and order counts by hour, day, week or month |
amazon_get_fba_inventory | FBA inventory by SKU: available, inbound, reserved |
amazon_list_fba_inbound_shipments | Inbound shipments to Amazon's warehouses |
amazon_get_fba_inbound_shipment_items | The items in an inbound shipment |
amazon_awd_list_inventory | Amazon Warehousing and Distribution inventory |
amazon_awd_list_inbound_shipments | AWD inbound shipments |
amazon_awd_get_inbound_shipment | One AWD inbound shipment |
amazon_list_financial_event_groups | Settlement periods and their totals |
amazon_list_financial_events | Fees, refunds, reimbursements and adjustments |
amazon_list_transactions | Transactions, the same data as the Payments view |
amazon_list_settlement_reports | Settlement reports Amazon has generated |
amazon_search_catalog_items | Searches the catalog by keyword or identifier |
amazon_get_catalog_item | One ASIN's catalog details |
amazon_get_pricing | Your price for an ASIN or SKU |
amazon_get_competitive_pricing | Competitive prices and the Buy Box price |
amazon_get_item_offers | All offers on an ASIN |
amazon_get_listing_offers | Offers for one of your SKUs |
amazon_list_reports | Reports you've already requested |
amazon_create_report | Queues a Seller Central report from a fixed list of types |
amazon_get_report | Checks whether a report is ready |
amazon_get_report_document | Downloads a finished report and parses it into rows |
amazon_sp_api_get | A read-only request to any other allowed SP-API endpoint |
The five tools that can change things
The five write tools all behave the same way:
- Called without
confirm: true, they change nothing and return a preview of the exact payload. - Your AI app shows you the preview. You read it.
- Only if you agree does the AI repeat the call with
confirm: true. - Each call takes at most 100 items. Bigger changes go in batches you approve one at a time.
Nothing else can be created, deleted or renamed. Changes, previews and approvals has the details.
Frequently asked questions
Can WavyCloud create or delete campaigns?
No. It can change campaign state and budgets, keyword and target bids, keyword state and negatives. Creating, deleting or renaming campaigns stays in the ads console.
Why does my AI app say it has too many tools?
Some clients cap how many tools they load at once. Turn off the tools you don't need in that app's MCP or connector settings.
Related
Still stuck? Email hello@wavycloud.com and a human will answer.