# Liftoff MCP for AI Agents AI Agent Connect

> Liftoff lets you connect your mobile advertising account to an AI agent to handle the heavy lifting of campaign reporting. Instead of jumping between tabs to find spend totals or creative performance, your agent pulls the data directly from the Liftoff API. It's built for anyone who needs to monitor user acquisition metrics without the manual export headache.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_XnJFwhdXMkaMRW0hsYx6q1JkS5sKFXgfozYVJFAg/ai-agent-connect
- **Tags:** mobile-advertising, campaign-performance, user-acquisition, marketing-analytics, ad-spend

## Description

Liftoff lets you connect your mobile advertising account to an AI agent to handle the heavy lifting of campaign reporting. Most mobile marketers spend half their day copy-pasting data from dashboards into spreadsheets just to see how a campaign is actually performing. It's a tedious cycle of exports, filters, and manual calculations that slows down decision-making. This Connector changes that by giving your AI agent direct access to your Liftoff advertising data. You can just ask your agent to show you the spend for a specific app or pull a performance report for last month, and it handles the request, monitors the progress, and delivers the results. It turns a multi-step data gathering process into a simple conversation. By adding this to your setup on Vinkius, you're basically giving your team a way to query live marketing metrics instantly. You get to spend less time on data entry and more time actually optimizing your growth strategy.

## Tools

### list_liftoff_apps
This tool shows all the apps connected to your Liftoff account. It's a quick way to verify which products are being promoted.

### list_liftoff_campaigns
This tool lists all advertising campaigns in your account. It helps you keep track of all active and paused efforts in one place.

### list_liftoff_creatives
This tool pulls a full list of every creative asset in your account. It's great for identifying which ads are running in which campaigns.

### download_report_results
This tool retrieves the final data from a report that's finished. It saves you from having to go find the file yourself in the dashboard.

### get_report_status
This tool shows if your requested report is still processing. It lets you know exactly when the data is ready for you to use.

### get_spend_metrics
This tool pulls synchronous spend and performance data instantly. Use it for a quick check on today's numbers without waiting for a report.

### request_performance_report
Use this tool to start a deep-dive report for a specific date range. It's the best way to get historical data for your audits.

## Prompt Examples

**Prompt:** 
```
What was our total spend on the 'Summer Launch' campaign yesterday?
```

**Response:** 
```
I've checked the spend metrics for the 'Summer Launch' campaign. Yesterday, the total spend was **$4,250.00** with **1,120 installs**.

| Metric | Value |
| :--- | :--- |
| Spend | $4,250.00 |
| Installs | 1,120 |
| CPI | $3.82 |
```

**Prompt:** 
```
Can you pull a performance report for the month of August?
```

**Response:** 
```
I've submitted a request for the August performance report. The request ID is `rep-55432`. I'll keep an eye on it and let you know as soon as the results are ready to download. 🕒
```

**Prompt:** 
```
List all the creative assets we have for the Android app.
```

**Response:** 
```
I've retrieved the creative assets for your Android app. You have **14 active creatives**, including:

* Video_Promo_01
* Static_Banner_Blue
* Interactive_Story_A

Would you like to see the performance for any of these?
```

## Capabilities

### Pull real-time spend metrics
Liftoff lets you get immediate visibility into how much you're spending on active campaigns.

### Request historical reports
Liftoff allows you to trigger deep-dive performance reports for specific date ranges.

### Monitor report progress
Liftoff helps you check the status of long-running data requests to know when they're ready.

### List all creative assets
Liftoff lets you see every piece of creative in your account to map IDs to names.

### Filter by marketing dimensions
Liftoff lets you narrow down data by country, platform, or specific app.

### Download finished reports
Liftoff lets you grab the final data from a completed request without manual intervention.

## Use Cases

### Checking daily budget
A UA manager asks 'How much did we spend on the iOS campaign today?' and the agent uses get_spend_metrics to give an instant answer.

### Monthly performance audit
An analyst asks for a July performance report. The agent uses request_performance_report, monitors it, and then uses download_report_results.

### Creative inventory check
A marketer wants to see all assets for a specific app. The agent uses list_liftoff_apps and list_liftoff_creatives to provide a complete list.

### Multi-country spend check
A growth lead asks for spend by country. The agent filters the data using the dimension filters to show a breakdown of different regions.

## Benefits

- Stop manual data exports: Use get_spend_metrics to pull today's spend instantly instead of downloading CSVs from a dashboard.
- Automate historical audits: Trigger request_performance_report to get deep dives into past months without manual filtering.
- Faster creative mapping: Use list_liftoff_creatives to instantly connect your internal creative names with Liftoff IDs.
- Real-time spend tracking: Keep a constant eye on your budget using get_spend_metrics for immediate operational awareness.
- Streamlined report monitoring: Use get_report_status and download_report_results to handle long-running data requests without checking the portal.

## How It Works

The bottom line is you get a direct line from your AI agent to your Liftoff performance data without the manual export work.

1. Subscribe to the Liftoff MCP on Vinkius.
2. Provide your Liftoff API Key and API Secret in your client settings.
3. Ask your agent to pull spend metrics or list campaigns in plain English.

## Frequently Asked Questions

**Can I use the Liftoff MCP to see my daily ad spend?**
Yes, you can ask your agent for real-time spend metrics to see exactly how much you're spending on active campaigns right now.

**How does the Liftoff MCP handle large historical reports?**
It uses an asynchronous request system. You can ask for a report, and the agent will track its progress and let you know when it's ready for download.

**Can I see my creative assets using the Liftoff MCP?**
Yes, the agent can pull a full list of your creative assets so you can quickly identify which ads are running.

**Does the Liftoff MCP work for both iOS and Android?**
Yes, it allows you to filter your advertising data by platform, so you can see performance for both iOS and Android users.

**How do I connect my Liftoff account to my AI agent?**
You just need to subscribe to the Connector on Vinkius and enter your Liftoff API Key and Secret in your client settings.

**Can I filter my Liftoff data by country?**
Yes, you can ask your agent to show you performance data filtered by specific countries or other dimensions like app and platform.

**How do I get my API Key and Secret?**
You must contact your Liftoff (Vungle) Account Manager to receive your specialized Reporting API credentials.

**What is the difference between Reporting v1 and v2?**
Reporting v1 is asynchronous and used for large, detailed historical datasets. Reporting v2 is synchronous and provides quick access to spend and install metrics.

**Can I filter data by country?**
Yes, by including 'country' in the `dimensions` parameter of the spend report, or by configuring the group_by settings in a v1 report request.