# Criteo Retail Media API MCP for AI Agents MCP

> The Criteo Retail Media API MCP lets your AI agent handle complex retail ad campaigns directly from conversation. You can list campaigns, audit budgets and line items, pull performance reports, and explore product data across multiple retailer accounts—all without navigating the developer portal.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** retail-media, ad-campaigns, product-data, line-item-management, ad-performance

## Description

Managing advertising campaigns for retailers is a huge headache. It involves jumping between account dashboards, downloading CSVs full of metrics, and manually cross-referencing campaign settings with product listings. This MCP lets you skip all that clicking. You talk to your AI client, telling it exactly what data you need—like checking the status of all active campaigns or finding out which retailers are available for a specific brand. The system then talks directly to Criteo's API and gives you real-time, structured answers in conversation. Connecting this MCP through Vinkius means you get immediate access to dozens of other specialized connectors, giving your agent a complete view of your digital advertising operations. You can easily track everything from product discovery to final performance reports using just natural language.

## Tools

### get_retail_campaign_details
Gathers comprehensive settings and details for one specific campaign ID.

### get_retail_media_report
Requests and generates a detailed performance report for the retail media platform.

### list_advertiser_accounts
Provides a list of all advertising accounts managed in the retailer's media system.

### list_retail_budgets
Lists the currently active budgets associated with your retail media campaigns.

### list_retail_campaigns
Retrieves a complete list of all active retail media advertising campaigns in Criteo.

### list_line_item_keywords
Retrieves the specific keywords targeted by a single, designated line item.

### list_line_items
Retrieves a list of all individual ad groups or line items within a specific campaign.

### list_account_products
Shows all products that are available and associated with your retailer account.

### list_retailers
Lists every retail partner that is currently accessible within your advertising account.

### search_retail_campaigns_by_name
Finds specific retail campaigns by entering a keyword or name fragment.

## Prompt Examples

**Prompt:** 
```
Show me a performance breakdown for my campaigns last week.
```

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

| Metric | Value |
| :--- | :--- |
| Total Impressions | 1,250,000 |
| Attributed Sales | $45,000 |
| Average ROAS | 3.8x |

*Breakdown by Campaign:* 
* Back to School: $20k (ROAS: 3.5x) 
* Holiday Spotlight: $25k (ROAS: 4.1x)
```

**Prompt:** 
```
List all the active budgets for my current retail media campaigns.
```

**Response:** 
```
**Active Retail Budgets**

It looks like you have four active campaigns with these budgets:

* **Back to School 2024:** $15,000 remaining (Budget: $20k)
* **Electronics Spotlight:** $3,200 remaining (Budget: $5k)
* **Summer Promo:** $850 remaining (Budget: $1,000)
* **Partnership Alpha:** $14,900 remaining (Budget: $20k)
```

**Prompt:** 
```
What products are available for promotion in the North East region?
```

**Response:** 
```
**Products Available in North East Retailers**

I found 3 main product categories associated with your account in that region:

* **Category A:** (SKUs: P102, P105) - Available at Best Buy and Target.
* **Category B:** (SKUs: P211, P219) - Only available via Amazon Prime partners.
* **Category C:** (SKU: P300) - Limited stock; available only through Walmart.
```

## Capabilities

### Audit and list all retail campaigns
Retrieve comprehensive details for every campaign running across your connected advertiser accounts.

### Monitor ad groups and line items
Get real-time configuration, budget status, and performance data for specific advertising line items.

### Request performance reports by date range
Pull aggregated metrics on impressions, sales, and return on ad spend across your retail media efforts.

### Explore product and partner data
Discover available products for a brand or list all active retailer partners in the marketplace.

## Use Cases

### Checking ad performance after a sale
An e-commerce specialist needs to know the ROAS for last month's campaigns. They ask their agent to `get_retail_media_report` for 'last 30 days'. The agent returns an immediate, summarized table showing overall sales and average return on ad spend.

### Preparing a quarterly budget review
A retail media manager needs to verify spending limits. They ask the agent to `list_retail_budgets` for all campaigns. The agent lists every active budget, showing which ones are near their maximum limit.

### Auditing product availability
An account executive is planning a new partnership and needs to check inventory options. They use the tool to `list_account_products` for a specific brand, getting an immediate list of available SKUs they can promote.

### Troubleshooting keywords
An e-commerce specialist notices poor performance on one ad group and asks their agent about the targeted terms. The tool calls `list_line_item_keywords` and returns a list of all 20 keywords used by that specific line item.

## Benefits

- Stop downloading reports. Instead of manually pulling performance metrics, you can use `get_retail_media_report` to ask your agent for a report on last week's sales in plain language.
- Audit campaign structure instantly. With `list_campaigns` and `get_retail_campaign_details`, you can check budget allocation or specific settings without navigating multiple dashboards.
- Keep track of inventory. If you need to know what products a brand offers, use `list_account_products`. This saves hours of manual checking across partner sites.
- Know your audience. Need to see what keywords are working? Use `list_line_item_keywords` to audit the ad groups and identify underperforming terms immediately.
- Compare partners easily. Instead of looking up each retailer separately, use `list_retailers` to get a master list of all available partners in your account.

## How It Works

The bottom line is, you talk about campaign metrics and product listings, and your agent gets them for you.

1. Authorize your AI client using your Criteo Client ID and Secret key.
2. Ask your agent to perform a specific task, like 'List all campaigns that are currently under budget.'
3. The MCP executes the necessary API calls and returns the requested data or insights in conversational format.

## Frequently Asked Questions

**How does the Criteo Retail Media API MCP help me audit my campaigns?**
It lets you query campaign settings and performance metrics conversationally. Instead of downloading spreadsheets, you can ask for specific details—like budget status or line item keywords—and get a clean summary instantly.

**Can the Criteo Retail Media API MCP generate sales reports?**
Yes, it generates detailed performance reports. You just tell your agent what time frame you need (e.g., 'yesterday' or 'last month'), and it pulls the impressions and attributed sale data for you.

**What if I want to see which retailers are available?**
The Criteo Retail Media API MCP gives you a complete list of all retail partners connected to your account. This helps you plan promotions knowing exactly where and with whom you can advertise.

**Is the Criteo Retail Media API MCP good for checking product inventory?**
It's excellent for that. You can use it to list all products associated with your account, which is critical before launching any new ad campaign or promotion.

**Does the Criteo Retail Media API MCP work across different regions?**
Yes, you can query data by filtering for specific retail partners and locations. It helps narrow down product availability and performance metrics to exact geographic areas.