Help us improve
Share bugs, ideas, or general feedback.
From amazon-ads
Guide for using the Marketplace Ad Pros MCP server to manage and analyze Amazon Advertising accounts. Use when working with Amazon Ads campaigns, performance reports, bid/budget recommendations, keyword research, or product data through the MCP tools.
npx claudepluginhub marketplaceadpros/skill-amazon-adsHow this skill is triggered — by the user, by Claude, or both
Slash command
/amazon-ads:amazon-adsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are connected to the Marketplace Ad Pros MCP server for Amazon Advertising management, reporting, and optimization. This guide explains how to use the available tools effectively.
Plans and creates Amazon Sponsored Products campaigns end-to-end via Hyper MCP. Manages keywords, bids, product targeting, negative keywords, budget rules, and performance reports.
Analyzes Amazon Ads campaigns including Sponsored Products, Sponsored Brands, Sponsored Display, and basic DSP. Useful for PPC audits, ACOS/TACOS optimization, and retail media strategy.
Manages ad campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads via Adspirer MCP server. Analyzes performance, researches keywords, creates campaigns, optimizes budgets.
Share bugs, ideas, or general feedback.
You are connected to the Marketplace Ad Pros MCP server for Amazon Advertising management, reporting, and optimization. This guide explains how to use the available tools effectively.
integration_id (UUID).account_id (UUID) and a numeric profile_id. Most tools accept either.Always begin by identifying the user's context:
whoami to confirm the authenticated user and their plan status.list_brands to see all brands and their associated advertising profiles. This is the fastest way to get integration_id and account_id values you need for other tools.If list_brands returns no brands but the user has integrations, use list_amazon_ads_integrations then list_amazon_ads_integration_accounts to find profiles.
ask_report_analyst is the primary tool for any question about metrics, performance, spend, sales, ACOS, impressions, clicks, conversions, or search terms. It queries historical report data stored in the system.
When to use:
How to write good questions for the analyst:
Example questions:
"For the last 14 days, show me the best performing products/ASINs by total sales14d. Include cost, sales14d, purchases14d, ACOS, and impressions for each product. Sort by sales14d descending. Top 20."
"For the last 7 days, which keywords have spend > $10 but zero sales14d? Include the campaign name, ad group name, keyword text, match type, cost, impressions, and clicks."
"Show me daily spend and sales14d totals for the last 30 days so I can see the trend."
"What are my top 10 search terms by conversions (purchases14d) in the last 14 days? Include impressions, clicks, cost, sales14d, and the campaign they came from."
Scoping options for ask_report_analyst:
integration_id + account_idbrand_id to query across all profiles in that brandbrand_ids arrayaccount_ids arrayintegration_ids arrayquestion is required; scope params are optional but recommended for accuracy.Use these tools to explore what campaigns, ad groups, keywords, and targets exist:
| Tool | Use When |
|---|---|
list_amazon_ads_campaigns | User wants to see their campaigns, check campaign states, or you need campaign IDs for deeper exploration |
list_amazon_ads_campaign_ad_groups | Need to drill into a campaign's ad groups |
list_amazon_ads_campaign_keywords | Need to see keyword targets in a campaign/ad group |
list_amazon_ads_campaign_targets | Need to see product/category targeting clauses (ASIN targeting, category targeting) |
list_amazon_ads_campaign_product_ads | Need to see which products are advertised in a campaign |
These tools require integration_id and account_id at minimum. Campaigns require those two. Ad groups, keywords, targets, and product ads also require campaign_id. Keywords, targets, and product ads optionally accept ad_group_id to narrow results.
All list tools cap results at 100 items. Use state_filter (ENABLED, PAUSED, ARCHIVED) to narrow results. Default is typically ENABLED.
| Tool | Use When |
|---|---|
get_amazon_ads_account_recs | User wants a general overview of optimization opportunities across bid, budget, and targeting for an account |
get_amazon_ads_ad_group_bid_recs | User wants Amazon's recommended bids for targets in a specific ad group |
get_amazon_ads_ad_group_keyword_recs | User wants new keyword suggestions for an ad group, including impression share data |
get_amazon_ads_campaign_budget_rule_recs | User wants to know about upcoming events (Prime Day, holidays) and suggested budget increases |
get_amazon_ads_campaigns_budget_recs | User wants to check if campaigns are running out of budget, with estimated missed opportunities |
| Tool | Use When |
|---|---|
get_amazon_ads_product_metadata | Need product details (title, price, category, BSR, brand, availability) for specific ASINs |
list_brands | See all brands and their associated profiles |
create_brand | Create a new brand to organize profiles under |
assign_profiles_to_brand | Assign or reassign advertising profiles to brands |
get_optimization_guide | Get the agency's playbook/guide for how they optimize campaigns |
list_brands to identify the accountask_report_analyst with a broad question like "For the last 14 days, show me a summary of total spend, sales14d, ACOS, impressions, and clicks across all campaigns."get_amazon_ads_account_recs to surface any optimization recommendationslist_brands to get IDsask_report_analyst: "For the last 14 days, show campaigns ranked by spend. Include cost, sales14d, ACOS, impressions, clicks. Top 20."list_amazon_ads_campaigns to get campaign IDsget_amazon_ads_campaigns_budget_recs to check if top campaigns are running out of budgetask_report_analyst: "For the last 30 days, which keywords have cost > $50 but zero sales14d? Include campaign name, keyword text, match type, cost, impressions, clicks."ask_report_analyst: "For the last 30 days, which search terms have cost > $20 but zero purchases14d? Include the search term, campaign, cost, clicks."list_amazon_ads_campaigns to find the campaignlist_amazon_ads_campaign_ad_groups to find the ad groupget_amazon_ads_ad_group_keyword_recs for Amazon's keyword suggestions with impression share dataask_report_analyst: "What are my top converting search terms in the last 30 days that are not already exact match keywords?"ask_report_analyst: "Top 10 ASINs by sales14d in the last 14 days. Include ASIN, cost, sales14d, ACOS, impressions."get_amazon_ads_product_metadata with those ASINs to get product details (title, price, BSR, availability)list_amazon_ads_campaigns to identify key campaignsget_amazon_ads_campaign_budget_rule_recs for each campaign to see suggested budget increases for upcoming eventsask_report_analyst: "Show me performance during last year's Prime Day period (July 11-12, 2025) vs the week before. Include spend, sales14d, ACOS."ask_report_analyst tool is by far the most powerful tool. Use it for any data/metrics question. Frame questions in natural language with specific date ranges, metrics, and sort orders.integration_id + account_id. Get these from list_brands first.brand_id scoping on ask_report_analyst when the user thinks in terms of brands rather than individual profiles.sales14d, purchases14d). This means a sale is attributed to an ad click if it happens within 14 days.