# Amazon Ads MCP MCP

> Amazon Ads MCP connects your agent directly to Amazon's advertising ecosystem. You can manage campaigns across Sponsored Products and Sponsored Brands, audit profiles, monitor active ad groups, track keywords, and pull performance reports for analysis. It lets you run full-stack e-commerce campaign oversight right from your chat interface.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** sponsored-products, campaign-management, ad-reporting, bidding-strategy, ecommerce-marketing, performance-tracking

## Description

Managing ads on Amazon shouldn't feel like jumping between six different dashboards. This MCP gives your agent the ability to handle your entire advertising strategy through natural conversation. You can start by listing profiles across global marketplaces, then drill down to audit active Sponsored Products or Sponsored Brands campaigns and their budgets. Need to check if a keyword is performing? Your agent lists targeted keywords for review. When you're done auditing, you simply request an asynchronous performance report detailing clicks, impressions, and ad spend. Whether you’re managing bidding strategies or tracking ROAS, this MCP makes it possible. You connect this entire capability set through Vinkius, giving your AI client one central point to manage complex e-commerce advertising tasks.

## Tools

### get_report_status
Checks the current status of a performance report that was requested previously.

### list_profiles
Lists all connected Amazon advertising profiles, helping you manage campaigns across different marketplaces.

### list_sb_campaigns
Retrieves a list of currently running Sponsored Brands campaigns for review.

### list_sb_keywords
Lists all targeted keywords used within your Sponsored Brands campaigns.

### list_sp_ad_groups
Retrieves a list of ad groups for Sponsored Products, helping you organize bids and copy.

### list_sp_campaigns
Lists all active Sponsored Products campaigns to monitor daily budgets and performance scope.

### list_sp_keywords
Displays the specific keywords targeted by your Sponsored Products ads.

### request_sp_report
Sends a request to generate a comprehensive performance report for your Sponsored Products campaigns.

## Prompt Examples

**Prompt:** 
```
List my Amazon Ads profiles.
```

**Response:** 
```
I've retrieved your advertising profiles. You have 2 profiles active: 'US Marketplace' (ID: 123456) and 'Canada Marketplace' (ID: 789012). Which profile's campaigns would you like to review?
```

**Prompt:** 
```
Show me the active Sponsored Products campaigns for profile ID '123456'.
```

**Response:** 
```
I've listed the active Sponsored Products campaigns for that profile. There are 5 running campaigns, including 'Holiday Promo' with a daily budget of $50.00 and 'Brand Defense' with a budget of $25.00.
```

**Prompt:** 
```
Request a campaign performance report for yesterday (Profile ID '123456').
```

**Response:** 
```
I have successfully requested the Sponsored Products campaign report for yesterday. The Report ID is 'rep-abc-123'. Because Amazon generates reports asynchronously, it is currently processing. Would you like me to check its status and download the data now?
```

## Capabilities

### Retrieve all Amazon Ads profiles
Lists every advertiser profile you own across different global marketplaces.

### List active campaign structures
Retrieves lists of both Sponsored Products and Sponsored Brands campaigns, showing their status and budgets.

### Audit ad groups and keywords
Checks the structure by listing specific ad groups or targeted keywords for review.

### Request performance data reports
Initiates a process to generate detailed, asynchronous reports covering your campaign's click, impression, and spend data.

## Use Cases

### Campaign Audit Before Launch
A new Product Manager needs to ensure all ad groups are correctly structured before launching a promotion. They ask the agent to run `list_sp_campaigns` first, then iterate through every campaign using `list_sp_ad_groups` to verify the setup is correct across the board.

### Daily Performance Check
A Marketing Lead gets an alert that ad spend spiked. They ask the agent for a performance report and then use `get_report_status` to check if the data is ready, solving the problem without opening any external dashboards.

### Brand Visibility Review
A Brand Manager notices competitor activity on key terms. They immediately ask the agent to list Sponsored Brands campaigns and keywords using `list_sb_campaigns` and `list_sb_keywords` to ensure their brand defense is active.

### Data Consolidation for BI Tools
A Data Analyst needs raw data for a custom dashboard. Instead of downloading reports manually, they use the agent to run `request_sp_report`, then wait and poll the status with `get_report_status` until the data is ready for consumption.

## Benefits

- Instead of manually checking multiple platforms for ad spend, you can use `list_profiles` to get an overview of campaigns across all your global marketplaces. It keeps everything centralized.
- Need to check if your bids are working? You can list specific keywords using `list_sp_keywords` and review the associated ad groups via `list_sp_ad_groups`, making immediate optimizations easy.
- Don't wait for end-of-month reports. Use `request_sp_report` to pull performance data asynchronously, giving you actionable insights faster than manual exports.
- Monitoring brand presence is simple. You can use `list_sb_campaigns` and `list_sb_keywords` together to audit Sponsored Brands visibility on critical search terms.
- The agent handles the complexity of campaign orchestration. It reads budgets from `list_sp_campaigns` and lets you see exactly what's running without having to copy-paste IDs.

## How It Works

The bottom line is that you connect your credentials once and then use natural language commands to audit and request data across all ad types.

1. First, authorize the MCP by supplying your Amazon Ads Client ID, Secret, Refresh Token, and Region.
2. Next, instruct your agent to list the specific campaigns or profiles you want to audit (e.g., 'list all SP campaigns').
3. Finally, tell the agent what data you need—for instance, 'request a performance report for last week'—and wait for it to check status using `get_report_status`.

## Frequently Asked Questions

**How do I find my Amazon Ads API credentials?**
You need to create a 'Login with Amazon' application in the Amazon Developer Console to get your Client ID and Client Secret. Then, you generate a Refresh Token. The agent will use these to obtain short-lived Access Tokens.

**How do I choose the correct region?**
Select the region that matches your target marketplace: **NA** (North America - US, CA, MX, BR), **EU** (Europe - UK, DE, FR, IT, ES, etc.), or **FE** (Far East - JP, AU, SG).

**Why do reports take time to generate?**
Amazon Ads reporting API is asynchronous. When you request a report using the `request_sp_report` tool, it returns a `reportId`. You must wait a few moments and use the `get_report_status` tool to download the data once it's ready.

**When I use `list_profiles`, how do I tell the agent which account to check next?**
The agent automatically passes context IDs between tools. After running `list_profiles`, simply reference the specific Marketplace ID, and your subsequent call to list campaigns or keywords will be scoped only to that profile.

**If I run `list_sb_keywords` and get zero results, what should I do?**
The agent confirms the lack of data. You can then ask the AI client to check for other keywords or review your targeting parameters instead. It keeps the workflow going.

**After calling `request_sp_report`, how quickly can I get the data?**
The report is generated asynchronously, meaning it takes time. You must use the Report ID returned by the request to run `get_report_status` until Amazon confirms the file is ready for download.

**What information does the agent pull when I list all campaigns using `list_sp_campaigns`?**
The tool lists active and paused Sponsored Products campaigns. For each campaign, it provides its unique ID, current status, and associated budget details.

**If I need to see my total ad spend, should I use `list_sp_keywords` or request a report?**
You must use `request_sp_report`. Listing keywords only shows the list of targeted terms. The performance report is required to calculate actual spending and key metrics like impressions.