Amazon Ads Tools
Ads Diagnostics
Scan Sponsored Products data for deterministic optimization findings from Claude with Launch Fast MCP.
Scan Sponsored Products data for deterministic optimization findings from Claude with Launch Fast MCP.
Amazon Ads Diagnostics helps Claude review multiple Sponsored Products reports together and surface practical findings. Instead of looking at campaigns, products, targets, and search terms one page at a time, this tool combines those views into focused diagnostics such as wasted spend, harvest opportunities, and inventory pressure.
Use this report when you want Claude to tell you what deserves attention first.
Decision support, not campaign management.
Diagnostics are based on report data and rule-style calculations. Claude may explain the findings, but this tool does not edit campaigns.
What This Report Shows
Amazon Ads Diagnostics is a cross-report Sponsored Products analysis tool.
| It can combine context from | Why it matters |
|---|---|
| Campaign performance | Shows campaign-level spend, sales, ACOS, ROAS, status, and budget context. |
| Advertised product performance | Shows which ASINs or SKUs receive spend and sales. |
| Targeting performance | Shows keyword and product target efficiency. |
| Search term performance | Shows shopper queries, waste, and harvest candidates. |
| Optional seller sales/order context | Helps connect ads findings to account activity when available. |
| Optional inventory context | Helps flag inventory pressure for advertised products when available. |
| Question | What diagnostics can show |
|---|---|
| Where is ad spend being wasted? | Entities spending without enough attributed return. |
| Which targets or search terms spend inefficiently? | Target and search term waste findings. |
| Which converting search terms should be harvested? | Search terms that may deserve tighter exact-match coverage. |
| Which advertised products may have inventory pressure? | Products where stock or days-of-cover may not support current demand or spend. |
| Which campaigns or products deserve review first? | Ranked findings for manual investigation. |
| What should I inspect first? | Cross-report priorities and drill-down suggestions. |
Think prioritized investigation list.
Campaign, Product, Targeting, and Search Term Performance show the underlying tables. Ads Diagnostics turns those tables into ranked findings.
How To Use This Report
Use Ads Diagnostics when you want a decision-oriented summary.
| Diagnostic view | Common interpretation |
|---|---|
| Waste findings | Campaigns, products, targets, or search terms spending without enough attributed return. |
| Harvest opportunities | Converting search terms that may deserve tighter exact-match coverage or closer campaign control. |
| Inventory pressure | Advertised products where stock or days-of-cover may not support current demand or spend. |
| Overview | Cross-report summary to decide where to drill down next. |
Diagnostics are deterministic. That means they are based on report data and rule-style calculations, not freeform campaign mutation.
Tool Details
| Field | Value |
|---|---|
| MCP tool | amazon_ads_performance_diagnostics |
| App UI | ui://launchfast/amazon-ads-performance-diagnostics |
| Behavior | Read-only |
| Amazon account required | Yes — Amazon Ads connection. Seller Central/SP-API connection is optional but useful for inventory/order context. |
| Best for | Ads audit summaries, waste scans, harvest candidates, inventory-aware ad review, prioritizing manual optimization work |
When To Use It
| Use case | What it helps you answer |
|---|---|
| Ads audit start | What deserves attention first. |
| Wasted spend review | Which entities are spending inefficiently. |
| Harvest review | Which converting search terms may deserve tighter coverage. |
| Inventory-aware ads review | Which advertised products may have stock pressure. |
| Manual priority list | What to inspect before making changes. |
| Seller-context review | How ads performance connects with seller-side sales or inventory context. |
| Action-list creation | Which findings should become manual optimization tasks. |
What It Returns
| Result area | What Claude can summarize |
|---|---|
| Cross-report summary | Overall ads diagnostic summary. |
| Ranked findings | Prioritized diagnostic findings. |
| Waste entities | Waste across campaigns, products, targets, and search terms. |
| Harvest candidates | Converting search terms that may be worth promoting into tighter coverage. |
| Inventory risks | Advertised product inventory risk findings when seller context is available. |
| Drill-down entities | Top campaigns, products, targets, and search terms for follow-up. |
| Coverage warnings | Warnings when seller-side context is unavailable or ambiguous. |
| Report context | Account, profile, marketplace, and date range context. |
Fields depend on available context.
The exact fields depend on synced Amazon Ads reporting data, optional seller account data, and filters used.
Actions
| Action | Use when | Required inputs | Optional inputs |
|---|---|---|---|
overview | You want a broad diagnostic summary, findings, and top entities. | None | date_from, date_to, connection_id, account_id, profile_id, marketplace_code, seller_connection_id, seller_id, campaign_id, campaign_name, advertised_asin, advertised_sku, limit |
waste_scan | You want campaigns, products, targets, or search terms spending without enough return. | None | date_from, date_to, connection_id, account_id, profile_id, marketplace_code, seller_connection_id, seller_id, campaign_id, campaign_name, advertised_asin, advertised_sku, limit |
harvest_opportunities | You want converting search terms that may be worth promoting into tighter coverage. | None | date_from, date_to, connection_id, account_id, profile_id, marketplace_code, seller_connection_id, seller_id, campaign_id, campaign_name, advertised_asin, advertised_sku, limit |
inventory_pressure | You want advertised products with stock or days-of-cover concerns. | None | date_from, date_to, connection_id, account_id, profile_id, marketplace_code, seller_connection_id, seller_id, campaign_id, campaign_name, advertised_asin, advertised_sku, limit |
Inputs
| Input | Required | Notes |
|---|---|---|
date_from | No | Inclusive start date in YYYY-MM-DD format. Defaults to a recent window if omitted. |
date_to | No | Inclusive end date in YYYY-MM-DD format. Defaults to today if omitted. |
connection_id | No | Optional Launch Fast Amazon Ads connection filter. |
account_id | No | Optional Amazon Ads account filter. |
profile_id | No | Optional Amazon Ads profile filter. Useful when multiple profiles are connected. |
marketplace_code | No | Optional marketplace or profile code filter. |
seller_connection_id | No | Optional Launch Fast Amazon seller connection ID for order and inventory context. |
seller_id | No | Optional Amazon seller ID for order and inventory context. |
campaign_id | No | Optional campaign filter. |
campaign_name | No | Optional campaign name filter. |
advertised_asin | No | Optional advertised ASIN filter. |
advertised_sku | No | Optional advertised SKU filter. |
limit | No | Maximum rows to include in findings or leaderboard sections. Supports 1-100. |
Example Prompts
Broad diagnostic scan:
Scan my Sponsored Products data for wasted spend and harvest opportunities from the last 30 days.Waste scan:
Find campaigns, products, targets, and search terms with wasted spend over the last 30 days.Harvest opportunities:
Find converting search terms that may be worth harvesting into exact-match campaigns.Inventory pressure:
Find inventory pressure risks for advertised products.Campaign-specific diagnosis:
Run Ads Diagnostics for campaign 900000001 from April 1 to April 30 and show the top findings.Product-specific diagnosis:
Diagnose ads performance for advertised ASIN B07HQM6NH8 and explain waste, harvest, and inventory risks.Priority list:
Give me the top 10 Sponsored Products issues I should manually review first.How To Read The Results
Read diagnostics as a prioritized investigation list, not an automatic change list.
| Signal type | Look for |
|---|---|
| Positive signals | Clear harvest candidates with conversions and reasonable efficiency, strong campaigns or products with no major waste flags, search terms that repeatedly convert, advertised products with enough inventory to support continued spend, or findings that point to a specific campaign, target, term, or product for follow-up. |
| Risk or opportunity signals | Spend with no or weak sales, search terms that convert but are not tightly controlled, products receiving spend while inventory is low, campaigns with poor ACOS or ROAS across multiple lower-level entities, targets that spend inefficiently across multiple campaigns, or coverage warnings showing seller inventory/order context could not be applied. |
Common Analysis Patterns
Use Claude to turn diagnostics into an action plan.
| Pattern | Ask Claude to identify |
|---|---|
| Prioritized audit | Which findings should be reviewed first. |
| Waste cleanup | Which entities look like bid reduction or negative keyword candidates. |
| Harvest plan | Which search terms should be considered for exact match. |
| Inventory-aware ads | Which ads should be watched because stock may be low. |
| Drill-down plan | Which detailed report to open next for each finding. |
| Campaign review | Which campaigns have both waste and harvest opportunities. |
| Product review | Which advertised products have ads issues plus inventory or listing concerns. |
Suggested Workflow
Start With Overview
Run overview for a broad cross-report summary.
Scan Waste
Use waste_scan to find inefficient spend.
Find Harvest Opportunities
Use harvest_opportunities to find converting shopper queries.
Check Inventory Pressure
Use inventory_pressure when seller inventory context is connected.
Drill Into Campaigns
Use Campaign Performance for campaign-level context.
Drill Into Products, Targets, And Terms
Use Product Performance for ASIN/SKU context, Targeting Performance for keywords and targets, and Search Term Performance for shopper-query detail.
Act Manually
Make any campaign changes manually after reviewing the findings.
Common Empty Result Causes
Empty or thin results may mean no matching synced rows were found.
| Cause | Recovery |
|---|---|
| Amazon Ads is not connected. | Connect Amazon Ads in Settings -> Authentication. |
| Sponsored Products reports have not synced yet. | Wait for reporting sync to finish. |
| Selected date range has no ads data. | Try a broader or more recent date range. |
| Filters are too narrow. | Remove campaign, product, seller, account, profile, marketplace, and connection filters. |
| Campaign or product filter does not match synced records. | Search campaign/product reports first, then use matching IDs or names. |
| Seller-side context is unavailable or ambiguous. | Connect Seller Central/SP-API or run diagnostics without seller filters. |
| Inventory context is limited. | Use Inventory separately or rerun with seller context if available. |
| Amazon has not made report data available yet. | Wait and retry later. |
Try this recovery prompt:
Try Ads Diagnostics again for the last 30 days and remove campaign, product, seller, account, profile, marketplace, and connection filters.For inventory pressure:
Run inventory_pressure with seller context if available, otherwise explain which advertised products need manual inventory follow-up.Safety Notes
Amazon Ads Diagnostics is read-only.
| It can inspect | It does not change |
|---|---|
| Synced Sponsored Products diagnostics across campaigns, products, targets, search terms, and optional seller inventory/order context. | Bids, budgets, campaigns, campaign status, keywords, negative keywords, targets, Amazon Ads account settings, inventory, listings, or prices. |
Claude can recommend manual optimization actions, but any Amazon Ads or Seller Central changes must be made outside this MCP tool.
Limits And Notes
| Area | Note |
|---|---|
| Connection | Requires a connected Amazon Ads account. |
| Rate limit | Amazon Ads reporting tools allow 120 reads/min per user. |
| Seller context | Seller Central/SP-API connection is optional but improves inventory and order context. |
| Data availability | Results depend on Sponsored Products reporting data synced into Launch Fast. |
| Inventory context | Inventory pressure findings may be limited if seller inventory data is unavailable. |
| Date format | Dates should use YYYY-MM-DD. |
| Result size | Use limit to keep findings concise. |
| Interpretation | Diagnostics should be treated as decision support, not automatic campaign management. |