Amazon Advertising MCP Tools

list_profiles

List Amazon Advertising Profiles

List all Amazon advertising profiles for the authenticated user. Returns profile IDs that can be used in other commands.

list_mcp_profiles

List MCP-Activated Profiles

List all Amazon advertising profiles with their MCP activation status. Shows which profiles are ready for querying, which need activation, and which are currently importing data.

activate_mcp_profile

Activate Profile for MCP

Activate an Amazon advertising profile for MCP access. This triggers data import from Amazon Ads API into our query-optimized database.

check_mcp_status

Check MCP Import Status

Check the MCP data import status for a specific profile by number. Shows progress of data retrieval and when the profile will be ready for queries.

list_campaigns

List Amazon PPC Campaigns

List Amazon advertising campaigns for a specific profile. Filter by status and targeting type. Supports Sponsored Products, Sponsored Brands, and Sponsored Display campaigns.

get_campaign

Get Campaign Details

Get detailed information about a specific Amazon PPC campaign including budget, bidding strategy, targeting settings, and current status.

search_campaigns

Search Campaigns by Name

Search for Amazon PPC campaigns by name. Useful when you know the campaign name but not the ID, or want to find campaigns matching a pattern.

list_keywords

List Amazon PPC Keywords

List keywords for a profile or campaign. Filter by status and match type. Shows keyword text, bid, match type, and current status.

get_performance

Get Account Performance

Get aggregate performance metrics for all campaigns in a profile over a date range. Returns totals for impressions, clicks, spend, sales, orders, ACOS, and ROAS.

get_campaign_performance

Get Campaign Performance

Get individual campaign performance metrics with flexible sorting and filtering. Perfect for finding top performers, worst performers, or campaigns matching specific criteria.

get_wasted_spend

Find Wasted Spend

Find campaigns, keywords, or search terms that are wasting money (spending without converting). Identify budget leaks, money pits, and underperforming entities that should be optimized or paused.

get_search_term_performance

Search Term Performance

Get search term performance metrics with flexible sorting. Shows which customer search queries are driving sales or wasting spend. Essential for keyword harvesting and negative keyword discovery.

compare_periods

Compare Time Periods

Compare performance between two date ranges, showing percent changes and trends. Compares metrics like sales, spend, ACOS, ROAS between current and previous periods.

diagnose_change

Diagnose Performance Changes

Root cause analysis for metric changes. Identifies PRIMARY DRIVERS from account to campaign to keyword level. Shows WHY a metric changed by decomposing it into contributing factors.

get_asin_performance

ASIN Performance Analysis

Get performance metrics grouped by advertised ASIN. Shows which products are driving sales or wasting spend. Essential for product-level advertising analysis.

get_match_type_performance

Match Type Performance

Get performance breakdown by keyword match type (exact, phrase, broad, auto). Compare efficiency across different targeting strategies to optimize your keyword mix.

get_dayofweek_performance

Day of Week Performance

Get performance breakdown by day of week (Monday-Sunday). Identify which days perform best for scheduling and day-parting decisions.

get_platform_performance

Platform Performance Comparison

Get performance breakdown by advertising platform (Sponsored Products, Sponsored Brands, Sponsored Display). Compare efficiency across SP, SB, and SD to optimize budget allocation.