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 lets Claude review multiple Sponsored Products reports together. It combines campaigns, products, targets, and search terms. The result identifies 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 can explain the findings. 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 must be harvested? | Search terms that can deserve tighter exact-match coverage. |
| Which advertised products can have inventory pressure? | Products where stock or days-of-cover cannot support current demand or spend. |
| Which campaigns or products deserve review first? | Ranked findings for manual investigation. |
| What must 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 can deserve tighter exact-match coverage or closer campaign control. |
| Inventory pressure | Advertised products where stock or days-of-cover cannot 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 spend inefficiently. |
| Harvest review | Which converting search terms can deserve tighter coverage. |
| Inventory-aware ads review | Which advertised products can 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 must 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 can 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 accurate 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 can 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 are candidates for 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 that I must 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 | Find harvest candidates with conversions and good efficiency. Find strong campaigns or products with no major waste. Find search terms that convert repeatedly. Confirm that advertised products have sufficient inventory. |
| Risk or opportunity signals | Find spend with no or weak sales. Find converting terms with insufficient control. Find ad spend on low-stock products. Find poor ACOS or ROAS across campaigns. Examine warnings about missing seller data. |
Common Analysis Patterns
Use Claude to turn diagnostics into an action plan.
| Pattern | Ask Claude to identify |
|---|---|
| Prioritized audit | Which findings must be reviewed first. |
| Waste cleanup | Which entities look like bid reduction or negative keyword candidates. |
| Harvest plan | Which search terms must be considered for exact match. |
| Inventory-aware ads | Which ads must be watched because stock can 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 all campaign changes manually after reviewing the findings.
Common Empty Result Causes
Empty or thin results can 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, identify the advertised products for a manual inventory review.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. Make all Amazon Ads or Seller Central changes 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 for each 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 can be limited if seller inventory data is unavailable. |
| Date format | Dates must use YYYY-MM-DD. |
| Result size | Use limit to keep findings concise. |
| Interpretation | Diagnostics must be treated as decision support, not automatic campaign management. |