# AdRoll MCP

> AdRoll lets you manage every detail of your digital ad campaigns and retargeting efforts through natural conversation. List active campaigns, audit creative assets, segment audiences, and pull real-time performance reports—all without clicking a single dashboard button. Control complex advertising operations and track conversions across web and social channels instantly.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** retargeting, performance-marketing, ad-campaigns, conversion-tracking, digital-advertising

## Description

Managing large ad accounts means jumping between dashboards to check metrics, verify budget limits, or confirm audience status. This MCP lets your agent take over that entire process. You tell it what you need—like 'Show me the spend report for last week'—and it pulls structured data directly from AdRoll’s backend. It handles everything from listing all current campaigns to checking if a creative asset is ready for launch. Since this connector lives on Vinkius, your agent can talk to dozens of other services too, making your ad operations coordinator incredibly comprehensive. You get instant reports with clicks, impressions, and spend data, giving you the control needed to optimize ROI without leaving your chat window.

## Tools

### get_campaign
Retrieves specific details about a single advertising campaign.

### get_report
Generates performance metrics by accepting structured criteria as a JSON string for detailed analysis.

### list_adgroups
Lists all the ad groups associated with a specific campaign ID.

### list_ads
Retrieves every creative asset (ad) linked to a given advertiser profile.

### list_advertisables
Lists all active and inactive advertising profiles available in the account.

### list_campaigns
Provides a list of all campaigns associated with a specific advertiser profile ID.

### list_segments
Retrieves a complete directory listing of available audience retargeting segments.

## Prompt Examples

**Prompt:** 
```
List all my active advertising campaigns for profil EID '123'.
```

**Response:** 
```
I've retrieved your campaigns. For EID 123, you currently have 5 active campaigns, including 'Spring Sale' and 'Retargeting Global'. Would you like the detailed budget metadata for any of these?
```

**Prompt:** 
```
Show the performance report (clicks and spend) for last week.
```

**Response:** 
```
Fetching analytics... Last week, your account reached 120,000 impressions with 1,500 clicks and a total spend of $2,400.00. Shall I retrieve the high-fidelity breakdown by campaign?
```

**Prompt:** 
```
List the audience segments for advertisable '123'.
```

**Response:** 
```
Accessing audience graph... I found 10 active segments, including 'Cart Abandoners' and 'VIP Customers'. I've retrieved their current reach and user counts for you. Need help managing any of these targets?
```

## Capabilities

### Manage campaign performance
Retrieve detailed status, budgets, and operational metrics for all your advertising campaigns.

### Calculate ad performance reports
Generate comprehensive reports detailing clicks, impressions, and total spend over custom timeframes.

### Audit creative assets and groups
Access the complete directory of your ad groups and individual creatives to coordinate visual strategies.

### Define target audiences
List and manage all available retargeting segments, ensuring precise audience targeting for personalized ads.

### Verify account settings
Check foundational profile metadata and general account-level settings to confirm operational readiness.

## Use Cases

### Checking quarterly campaign health
A Marketing Manager needs to know the total spend across 15 different campaigns for Q2. They simply prompt their agent: 'What was the performance report (clicks and spend) for last quarter?' The MCP uses `get_report` to pull all necessary data instantly, bypassing manual dashboard compilation.

### Auditing ad group assets
A Growth Advertiser launches a new campaign and needs confirmation that the associated creative groups are set up correctly. They prompt: 'List ad groups for Campaign ID 456.' The MCP uses `list_adgroups` to confirm asset readiness before launch.

### Identifying stale audiences
A Media Buyer suspects a retargeting segment hasn't been updated. They ask the agent: 'List audience segments for client 789.' The MCP uses `list_segments` to show them all options and confirm which ones need refreshing.

### Cross-checking profile status
The team needs to know if a new ad account is ready to run. Instead of logging into the AdRoll portal, they ask their agent to 'List all advertisable profiles.' The MCP uses `list_advertisables` and reports on metadata instantly.

## Benefits

- Stop toggling between tabs. You can ask your agent to run a full performance report, getting clicks, impressions, and spend in one query using the `get_report` tool.
- You don't need to manually check every profile. The `list_advertisables` tool lets you audit all existing ad accounts instantly, confirming their operational status with a simple command.
- Keep your targeting precise by listing segments using `list_segments`. You immediately know which audience groups are active and ready for retargeting.
- Quickly assess campaign health. Use the `get_campaign` tool to pull specific budget details or status updates without navigating deep into ad tables.
- Audit all your creatives at once. With `list_ads`, you get a full view of every piece of visual marketing material associated with an advertiser.

## How It Works

The bottom line is that your agent acts as a dedicated ad operations coordinator, giving you instant data access without manual dashboard navigation.

1. Subscribe to the AdRoll MCP on Vinkius.
2. Retrieve your API Key or Personal Access Token from the AdRoll Developer Portal.
3. Connect your AI client to the MCP, and start querying performance metrics using natural language commands.

## Frequently Asked Questions

**Can AdRoll MCP track live advertising spend?**
Yes. The `get_report` tool lets you pull real-time metrics, including total spend and clicks, for specific timeframes directly from the platform.

**How many types of campaigns can I list with AdRoll MCP?**
You can list all campaign details using `list_campaigns` by providing a profile ID. The agent handles accessing and summarizing those various active accounts for you.

**Does AdRoll MCP help me find old ad creatives?**
Yes, the `list_ads` tool helps. You can pass an advertiser profile to list all historical and current creative assets associated with that account ID.

**What is the best way to check my retargeting audience size?**
You use the `list_segments` tool. It provides a full directory of your segments, letting you confirm which ones are active and ready for immediate targeting.

**Can I run multiple reports at once using AdRoll MCP?**
Yes. You simply ask the agent to compile several data points—like campaign performance *and* audience size—into one conversational response, rather than running separate reports manually.