# Amazon DSP MCP for AI Agents MCP

> Amazon DSP connects your AI client directly to professional programmatic advertising orchestration. Manage display and video campaigns, audit audience segments, and track performance reports using natural conversation. Your agent handles everything from campaign setup to deep performance analysis, making complex ad spending management simple.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** programmatic-advertising, display-ads, video-ads, audience-targeting, campaign-optimization, ad-tech

## Description

Connecting Amazon DSP via this MCP gives your AI client the power to handle programmatic advertising strategy right in chat. Forget clicking through multiple dashboards; you can manage display and video campaigns—from listing active campaigns to monitoring their budgets. Need to check targeting? Your agent retrieves details for ad groups, verifying pacing settings instantly. You can audit creative assets against brand guidelines or fetch custom audience segments used for specific targeting. For performance, simply ask your agent to request reports covering impressions, reach, and conversions. It's all about making complex campaign oversight conversational. By connecting through Vinkius, you get access to this DSP management MCP alongside thousands of other industry tools.

## Tools

### list_campaigns
Lists all available advertising campaigns in your DSP account.

### get_campaign_details
Retrieves the specific metadata and status for a single campaign.

### list_ad_groups
Lists all active ad groups (Line Items) within an advertising campaign.

### list_creatives
Audits and lists creative assets attached to specific campaigns.

### list_audiences
Retrieves the list of custom audience segments used for targeting purposes.

### request_report
Starts the process to generate a performance report for a specific time period.

### get_report_status
Checks the current status of an initiated performance report request.

## Prompt Examples

**Prompt:** 
```
What were my performance metrics last week? I want to see the totals.
```

**Response:** 
```
**Performance Summary: Last 7 Days**

| Metric | Value |
| :--- | :--- |
| Impressions | 1,245,000 |
| Reach | 890,000 |
| Conversions | 312 |
| Cost Spent | $14,550.00 |

*Note: This report was generated successfully and covers all active campaigns.*
```

**Prompt:** 
```
Check the ad groups for 'Summer Sale' campaign ID.
```

**Response:** 
```
**Ad Group Review: Summer Sale (ID 9876)**

Found **3** running ad groups:
*   **SG_Tier1:** Targeting US/CA. Pacing is at 95% capacity.
*   **SG_Video:** Targeting video viewers. Currently underperforming; consider a bid review.
*   **SG_Retargeting:** Targeting site visitors. Pacing looks stable, running smoothly.
```

**Prompt:** 
```
List all active campaigns and tell me which ones are near their budget limit.
```

**Response:** 
```
**Campaign Status Overview**

Here's a list of your 5 primary campaigns:
1.  *Q3 Lead Gen:* Budget remaining: $4,500 (20% used).
2.  ***Brand Awareness***: **WARNING!** Budget remaining: $890 (97% used). Action recommended.
3.  *Product Launch:* Budget remaining: $12,100 (5% used).
4.  *Seasonal Sale:* Budget remaining: $1,100 (85% used).
```

## Capabilities

### List campaigns
Retrieves a list of all active and inactive advertising campaigns within your Amazon DSP account.

### Get campaign metadata
Fetches detailed information about specific campaigns, including budget status and delivery dates.

### List ad groups
Provides a comprehensive list of all ad groups (Line Items) associated with a selected campaign for review.

### List creatives
Audits and lists creative assets used in campaigns, ensuring brand compliance across active ads.

### List audiences
Retrieves a list of custom audience segments that are currently being utilized for programmatic targeting.

### Request performance report
Initiates the generation of a deep performance report, covering impressions, reach, and conversions for specified date ranges.

### Check report status
Checks if an asynchronous performance report has finished processing or provides an estimated completion time.

## Use Cases

### Campaign Budget Checkup
A Programmatic Trader needs to know if their top 5 campaigns are hitting budget limits. They ask the agent, which uses `list_campaigns` and `get_campaign_details`. The agent responds with a summary table, flagging exactly which campaign is projected to run out of spend in the next 48 hours.

### Creative Compliance Audit
An Agency Account Manager needs assurance that all ads for a major client use approved logos. They ask the agent to audit creatives, invoking `list_creatives`, which instantly lists every active asset and flags any that violate brand specifications.

### Performance Deep Dive
A Media Buyer wants to optimize bidding for a specific quarter. They use the agent to request a report (`request_report`) for Q2, then monitor its status until it's ready, getting full impressions and conversion data to adjust their strategy.

### Targeting Verification
A Marketing Analyst needs to confirm which audience segments are currently active. They ask the agent to list audiences (`list_audiences`), receiving a clean list of custom segment IDs they can cross-reference with their internal data warehouse.

## Benefits

- Streamlines campaign management. You can use the `list_campaigns` tool to instantly check status, budgets, and overall delivery without navigating complex menus.
- Deepens targeting visibility. Use `list_audiences` to retrieve custom segments, letting you confirm exactly which audiences drive your programmatic reach.
- Saves time on audits. Need to know if a campaign is compliant? The `list_creatives` tool audits all associated assets against your brand guidelines instantly.
- Simplifies performance analysis. Instead of waiting for manual exports, use the `request_report` tool and then monitor it with `get_report_status` right through chat.
- Provides granular oversight. With access to ad groups via `list_ad_groups`, you can verify pacing settings and ensure your targeting is precise before optimization.

## How It Works

The bottom line is, you talk to your AI client like you're talking to an account manager; it handles the complex API calls needed to get the answers.

1. Subscribe to this MCP and input your Amazon DSP credentials: Client ID, Client Secret, Refresh Token, Region, and Advertiser ID.
2. Your AI client authenticates the connection through Vinkius, granting it read/write access to your advertising accounts.
3. You simply ask your agent a question—like 'What's the performance for Q2?'—and the MCP executes the necessary tools to fetch and compile the data.

## Frequently Asked Questions

**How do I find my Amazon DSP 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. You also need your Advertiser ID.

**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, it returns a `reportId`. You must wait a few moments and use the check status tool to download the data once it's ready.