Amazon Advertising MCP Tools

list_profiles

List Amazon Advertising Profiles

List all Amazon advertising profiles for the authenticated user. Returns profile IDs and MCP activation status. Do not suggest activating profiles that are already activated.

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.

list_rules

List Automation Rules

List all automation rules for your account. Rules automate bid adjustments, keyword harvesting, negative matching, and search term management across your Amazon advertising profiles.

get_rule_details

Automation Rule Details

Get detailed information about a specific automation rule including metric filters, action settings, schedule, and which profiles it applies to.

get_rule_outcomes

Rule Execution Outcomes

Get recent execution results for an automation rule. Shows what changes the rule made or recommended, including bid adjustments, keyword additions, and negative matches.

get_recent_rule_activity

Recent Automation Activity

Get recent automation activity across all rules. Shows a combined view of what all your automation rules have been doing, with rule names, action types, and execution counts.

create_rule

Create Automation Rule

Create a new automation rule for Amazon advertising. Supports bid increase/decrease and pause target actions with metric filters, scheduling, and profile scope.

get_alert_summary

Alert Summary Dashboard

Get a summary of pending alerts across all your Amazon advertising profiles. Shows alert counts by profile and by type including budget warnings, performance spikes, non-converting keywords, and more.

list_alerts

List Profile Alerts

List Amazon advertising alerts for a specific profile. Shows all pending and recent alerts with severity, type, and summary. Filterable by status and alert type.

get_alert_details

Alert Details

Get full details for a specific alert including actionable data. Budget alerts show campaigns hitting caps. Health check alerts show specific keywords, search terms, or targets with metrics. Spike alerts show affected campaigns and magnitude.

acknowledge_alert

Acknowledge Alert

Acknowledge a push alert to dismiss it. Acknowledged alerts stop appearing in API responses. Alerts are automatically surfaced in every MCP tool response when pending.

list_alert_rules

List Alert Rules

List configured alert rules for your account. Alert rules monitor metrics like ACOS, spend, impressions, etc. and notify you when thresholds are exceeded. Rules can be global (all profiles) or profile-specific.

create_alert_rule

Create Alert Rule

Create a new alert rule to monitor a metric and get notified when it crosses a threshold. Supports 11 metrics, relative or absolute thresholds, multiple check periods, and profile/campaign/ASIN-level monitoring.

update_alert_rule

Update Alert Rule

Update an existing alert rule. Change any configurable parameter including metric, threshold, period, hierarchy, or threshold type.

delete_alert_rule

Delete Alert Rule

Delete an alert rule. This soft-deletes the rule so it stops monitoring but can be recovered if needed.