Tool4seller

Resumes a READY AD_STRUCTURE_CREATE draft from persisted server state. This call may query Amazon Ads for keyword or ASIN candidates and suggested bids, including candidates not yet created in the account, or reuse saved recommendations. It persists workflow progress and decisions. It reconciles the last atomic plan, retains successful Amazon IDs, and prepares exactly the next Campaign, Ad Group, Product Ad, automatic-target bid, or Targeting plan. All Campaigns are prepared together, then all Ad Groups, then all Product Ads across every ad group in one multi-group plan; the Product Ad plan is completed before any targeting recommendation or bid decision can pause another structure. It never confirms or applies a write plan. For AUTO ad groups it persists the selected bid mode with the created adGroupId, synchronizes the four Amazon-created targets, obtains suggested bids when selected, and returns a separately confirmable AD_TARGETING_CHANGE plan. Partial writes retry only failed items. A 429 suggestion read includes per-target evidence; ambiguous create results require reconciliation and are never retried. For MANUAL ad groups without supplied positive targeting, it waits until Product Ads exist, persists Amazon candidates only for the recorded KEYWORD or ASIN TARGET family, accepts customer selection by candidateRef, obtains suggested or custom bids, accepts explicit customCandidates when recommendations are absent or rejected, and prepares separately confirmable Targeting plans. It accepts at most 100 selected candidates per ad group and reuses the exact suggested bids already shown to the customer. Once every manual decision is ready, it combines all MANUAL positive targeting groups into one batch plan, then combines all configured negative targeting across AUTO and MANUAL groups into one separate batch plan. AUTO-only drafts skip MANUAL processing and MANUAL-only drafts skip AUTO processing. When a plan is returned, pass applyContinuation unchanged to the matching operation-specific execution tool so a successful write automatically returns the next stage preview without asking the customer to advance. After an AUTO bid write, immediately present the returned MANUAL targeting preview or selection action in the same response when manual groups remain.

continue_workflow_draft

Diagnoses advertising efficiency with read-only advertising metrics for one store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

diagnose_ad_efficiency

Diagnoses profit anomalies with read-only profit, sales, and advertising signals for one store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

diagnose_profit_anomaly

Diagnoses sales changes with read-only sales, traffic, advertising, and inventory signals for one store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

diagnose_sales_change

Lists supported business workflows and their already-exposed MCP tools for diagnosis, advertising draft collection, and individual advertising operations. Returns navigation and input guidance only; does not prepare plans, execute queries, or apply advertising changes. Returns MCP reporting date limits and range-splitting guidance.

discover_capabilities

Returns the current user's default currency, time zone, display language, and creation time.

get_current_user

Returns the current owned workflow draft without modifying it, including its effective expiry state, optimistic-lock version, missing inputs, validation errors, recommended next actions, and persisted continuation state.

get_workflow_draft

Gets a workflow plan without modifying it, returning its effective expiry state, persisted execution status, item errors, upstream diagnostics, and explicit old/new values. After a timeout or disconnected apply call, query this exact plan (or retry apply with the same idempotency key); never create a replacement plan until its outcome is terminal and any INDETERMINATE items have been reconciled.

get_workflow_plan

Reviews inventory risk with read-only inventory and inventory alert signals for one store. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

inventory_risk_review

Returns paginated FBA inbound shipment items for up to 100 shipment IDs.

list_inbound_shipment_items

Returns paginated FBA inbound shipments for authorized sellers.

list_inbound_shipments

Returns sellers, marketplaces, SP API status, Advertising API status, and active status for the current user.

list_stores

Prepares an immutable, separately confirmable Amazon Ads plan. Changes ad-group default bids, states, or names. Persists an internal plan without changing advertising entities.

prepare_ad_group_changes

Prepares an immutable, separately confirmable Amazon Ads plan. Creates advertising ad groups. Persists an internal plan without changing advertising entities.

prepare_ad_group_creation

Prepares an immutable, separately confirmable Amazon Ads plan. Changes campaign budgets, states, or names. Persists an internal plan without changing advertising entities.

prepare_campaign_changes

Prepares an immutable, separately confirmable Amazon Ads plan. Creates Sponsored Products campaigns. Persists an internal plan without changing advertising entities.

prepare_campaign_creation

Prepares an immutable, separately confirmable Amazon Ads plan. Changes advertising ad states or supported Sponsored Brands ad names. Persists an internal plan without changing advertising entities.

prepare_product_ad_changes

Prepares an immutable, separately confirmable Amazon Ads plan. Creates Sponsored Products product ads or Sponsored Display product ads. Persists an internal plan without changing advertising entities.

prepare_product_ad_creation

Prepares an immutable, separately confirmable Amazon Ads plan. Changes positive keyword or ASIN targeting bids or states, or re-enables/archives negative keyword or ASIN targeting. Negative targeting has no bid actions; archiving is irreversible. Persists an internal plan without changing advertising entities.

prepare_targeting_changes

Prepares an immutable, separately confirmable Amazon Ads plan. Creates positive keyword, positive ASIN, negative keyword, or negative ASIN targeting entities. A batch may contain multiple targeting groups. Persists an internal plan without changing advertising entities.

prepare_targeting_creation

Creates or incrementally updates an AD_STRUCTURE_CREATE draft. Collect the Sponsored Products Campaign/Ad Group/Product Ad structure and any targeting the customer already supplied. One MANUAL ad group can contain only one positive targeting family: KEYWORD or ASIN TARGET. If positive targeting is omitted, collect manualTargetingFamily=KEYWORD|TARGET before execution. If the customer wants both, model separate manual Campaign/Ad Group structures from the start and assign one family to each; never put both into one ad group. Every ad group needs a negative-targeting decision: supplied allowed negative items automatically record negativeTargetingMode=CONFIGURED; when none are supplied, recommend negatives and ask the customer to choose CONFIGURED or NONE. AUTO permits both negative keywords and negative ASINs; a MANUAL KEYWORD group permits only negative keywords, and a MANUAL TARGET group permits only negative ASINs. Continuation prepares all Campaigns together, then all Ad Groups, then all Product Ads across every ad group in one multi-group plan before any AUTO bid decision or MANUAL recommendation can pause the draft. After all Product Ads exist, continuation queries and persists Amazon recommendations only for each manual ad group's recorded family, asks the customer to choose up to 100 candidates, obtains suggested or custom bids, then combines all ready MANUAL positive targeting into one Targeting batch plan. It subsequently combines every configured negative targeting item across AUTO and MANUAL structures into one separate negative Targeting batch plan. AUTO-only drafts skip the MANUAL stage and MANUAL-only drafts skip the AUTO stage. If recommendations are absent or rejected, submit customer-approved customCandidates of the same family to the continuation; do not recreate the already-created structure. For every AUTO ad group, explain that Amazon creates exactly four targets after the ad group exists and record automaticTargetBidding.mode as KEEP_DEFAULT, AMAZON_SUGGESTED, CUSTOM, or DECIDE_LATER; CUSTOM requires all four official theme bids. Never model those themes as manually created targets. Every supplied nested entity requires a stable clientRef. Updating requires draftId and expectedDraftVersion; arrays merge by clientRef and remove only through removeClientRefs. When the draft is READY, call continue_workflow_draft. The server then persists the current atomic plan, created Amazon IDs, recommendation choices, and bid choice so later calls safely resume. Every returned write plan must still be shown, explicitly confirmed, and applied. Pass applyContinuation to the matching operation-specific execution tool so successful writes automatically prepare the next stage; never ask the customer for permission merely to advance. Recommendation 429 responses are recoverable and do not create a write plan. During draft collection, accept syntactically valid SKU/ASIN values without querying Inventory or Listings; production Product Ad plan preparation performs product resolution.

prepare_workflow_draft

Returns store-level advertising performance or paginated advertising performance metrics grouped by SKU, ASIN, or parent ASIN for a single store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_advertising

Returns current advertising ad groups with stable IDs, name, state, serving status, default bid, parent campaign including campaignType, and Amazon createdAt/updatedAt timestamps as UTC ISO-8601 instants. Results can proceed to AD_AD_GROUP_CHANGE, AD_AD_CREATE, or AD_TARGETING_CREATE. AD_AD_CREATE resolves the product-specific creative: SP uses PRODUCT_AD/productCreative and SD uses COMPONENT/responsive eCommerce componentCreative. Choose targeting inputs from campaign.campaignType: Sponsored Display supports ASIN Targets and negative ASIN Targets only, never keywords or negative keywords.

query_advertising_ad_groups

Returns current Sponsored Products, Sponsored Display, and Sponsored Brands ads with stable ad IDs, product identity or name, state, serving status, parent references, and Amazon createdAt/updatedAt timestamps as UTC ISO-8601 instants. Results can proceed to AD_AD_CHANGE for confirmed ENABLED/PAUSED state changes or Sponsored Brands name changes.

query_advertising_ads

Read-only POST that returns current Amazon suggested bids and bid ranges for 1 to 100 Sponsored Products, Sponsored Brands, or Sponsored Display targeting items. For an existing keyword or target, provide targetingType and targetingId only. For a candidate that has not been created, first create its ad group, then provide targetingType, adGroupId, and targeting; this operation does not create the candidate. The server resolves the advertising product, Campaign, and Ad Group from synchronized data, so clients do not provide adProduct or campaignId. Compatible items in the same product, Campaign, Ad Group, and targeting type are combined into one Amazon recommendation request. Successful group responses are cached briefly and reused for identical requests. If a group is rate-limited, earlier successful groups are preserved, later groups of the same advertising product are not sent, and other advertising products continue. Retry only retryItemIndexes after retryAfterSeconds; do not immediately repeat the complete request when requestFingerprint is unchanged. Rate-limited and deliberately skipped unfinished items both retain the backward-compatible TOO_MANY_REQUESTS code; details distinguish them. Retrieves bid recommendations from Amazon Ads using the authorized advertising profile, or reuses cached recommendation results. Supports existing targets and supplied keyword or product targeting candidates that have not been created in the advertising account. This is a read-only tool: it neither creates targeting entities nor applies the returned bid. Use it when a bid decision needs Amazon's recommendation; historical CPC is not a suggested bid. Never repeat an unchanged request in the same assistant turn. Reuse successful items and the same requestFingerprint response. On TOO_MANY_REQUESTS, wait at least retryAfterSeconds and call this tool again with only retryItemIndexes.

query_advertising_bid_recommendations

Returns advertising campaign performance or daily campaign performance. Summary reports support standardized campaign attribute and aggregated metric filters. When the user specifies any supported attribute or metric condition, pass it through filters in the first call; do not retrieve unfiltered pages and filter locally. Paginate only the filtered result. Always retain and present each campaign's current budget from budget.currencyAmount with budget.currencyCode. For budget changes, show current budget -> planned budget before requesting confirmation. Results can proceed to AD_CAMPAIGN_CHANGE for customer-confirmed daily-budget, ENABLED/PAUSED state, or name changes, and Sponsored Products, Sponsored Display, or Sponsored Brands campaigns can proceed to AD_AD_GROUP_CREATE. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_advertising_campaigns

Returns paginated negative keyword or negative ASIN management records with stable IDs, state, serving status, match details, parent campaign/ad group references, and Amazon createdAt/updatedAt timestamps as UTC ISO-8601 instants. Historical ENABLED, PAUSED, and ARCHIVED states remain queryable. Results can proceed to AD_TARGETING_CHANGE to re-enable legacy PAUSED entities or archive PAUSED/ENABLED entities; PAUSED is not a writable target state, ARCHIVED is terminal, and negative targeting entities do not support bid actions or performance metrics.

query_advertising_negative_targets

Returns current Amazon Ads portfolios with stable portfolio IDs, names, states, serving status, budget policy and amount, budget dates, in-budget status, and Amazon createdAt/updatedAt timestamps as UTC ISO-8601 instants. This management query does not return performance metrics.

query_advertising_portfolios

Returns purchased product performance attributed to advertised products. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_advertising_purchased_products

Returns product-scoped buyer search term performance or product-ASIN search term performance. When a manual AD_STRUCTURE_CREATE draft has productAds but lacks positive targeting, use dimension=sku|asin|parentAsin with values to find evidence-backed keyword or product-target candidates. Sort by adOrders, adSales, or roas to surface historical performers. The returned average CPC can be presented as a historical bid reference, but it is not an Amazon suggested bid. Show the supporting metrics and obtain customer approval before adding any candidate or bid to the draft. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_advertising_search_terms

Read-only POST that returns Amazon-recommended keyword or ASIN targeting candidates before targeting entities are created. Supply exactly one source: adGroupId, or asins with adProduct. With adGroupId, the server resolves Campaign, advertising product, advertised ASINs, Sponsored Brands creative context, and Sponsored Display tactic from synchronized data. Sponsored Products supports KEYWORD and TARGET recommendations, Sponsored Brands supports KEYWORD and TARGET recommendations, and Sponsored Display supports TARGET recommendations only. Sponsored Display ASIN product recommendations require tactic T00020 because Amazon v3.3 does not support PRODUCT recommendations for T00030. TARGET currently means recommended ASIN product targets; category, brand, and audience recommendations are not included. Sponsored Products and Sponsored Brands TARGET responses can return nextToken for the next page. Pass that token back unchanged while keeping the original recommendation context. If Amazon rate-limits any page, the server does not retry and returns HTTP 429 with code TOO_MANY_REQUESTS; retain previously received items and retry only the failed page with the same nextToken. Each returned targeting object can be copied into a candidate bid-recommendation item together with the created adGroupId and targetingType, then used to create the selected target. This operation does not create or update advertising entities. Recommendations are retrieved from the Amazon Ads recommendation APIs using the authorized advertising profile and supplied context. Returned candidates are not limited to targeting entities already present in the user's advertising account. Use this tool first when the customer has not selected targeting candidates, then pass selected targeting objects to query_advertising_bid_recommendations before creation.

query_advertising_target_recommendations

Queries advertising keyword, explicit ASIN, product-category, automatic theme, or keyword-group theme target performance, including current targets with zero traffic in the date range. Product-scoped historical keyword or explicit-ASIN results can provide evidence for targeting candidates when a manual AD_STRUCTURE_CREATE draft lacks positive targeting. Average CPC is a historical bid reference, not an Amazon suggested bid; show supporting metrics and obtain customer approval before reusing a target or bid. dimension/values provide product scope; filters enables store-level target attribute and aggregated metric search and cannot be combined with product scope. When the user specifies a supported attribute or metric condition, pass it through filters in the first call; do not retrieve unfiltered pages and filter locally. Paginate only the filtered result. Query results can proceed to AD_TARGETING_CHANGE for bid or ENABLED/PAUSED state changes. Enabled and paused positive Targets can change bids without enabling them first; archived entities are not writable. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_advertising_targets

Returns paginated inventory listing data for a single store. FBA-specific fields are populated only for AFN inventory and are null for MFN inventory when not applicable.

query_inventory

Returns low stock, excess stock, long-term storage, or recommended removal inventory alerts.

query_inventory_alerts

Returns store-level profit summaries or paginated profit data by SKU, ASIN, or parent ASIN for a single store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_profit

Returns paginated rating data for parent ASINs that have review tracking enabled in a single store. Parent ASINs without review tracking or rating data are omitted from the response.

query_review_ratings

Returns sales summaries, daily sales summaries, SKU sales, or daily SKU sales for a business date range. The range is inclusive and each request may contain at most 95 calendar days. When splitting a longer range, set endDate to startDate plus 94 days, then start the next range at the previous endDate plus 1 day; a 95-day difference between startDate and endDate would contain 96 inclusive days and is invalid. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_sales

Returns sales traffic summaries or paginated sales traffic metrics by ASIN or parent ASIN for a single store and business date range. MCP reporting and workflow metric date ranges use yyyy-MM-dd and include both startDate and endDate, with at most 95 calendar days per range. For longer read-only reports, split into non-overlapping windows: endDate = startDate plus 94 days, capped at the requested end date; the next startDate is the previous endDate plus 1 day. Apply the same limit independently to comparison ranges. Do not average ratios such as ACOS or ROAS across windows; recompute them from summed base metrics. Do not automatically split advertising write plans or metric-based selectors; obtain a supported analysis window from the user. This reporting limit does not apply to campaign scheduling dates.

query_sales_traffic