Liftoff MCP. Get ad spend, install metrics, and campaign data instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Liftoff MCP Server connects your AI client directly to mobile advertising performance data via the Liftoff REST API. Use this server to list campaigns, request detailed historical reports, check real-time spend metrics, and monitor creative assets—all through natural conversation.
What your AI agents can do
Download report results
Retrieves the final, compiled dataset for a performance report once the background job is finished.
Get report status
Checks the current progress of an asynchronous report request (v1) to see if it's pending, running, or complete.
Get spend metrics
Provides immediate access to synchronous spend and key performance metrics (v2).
The agent checks and lists every app, campaign, and creative asset tied to your Liftoff account.
You ask the agent for a report covering specific start and end dates; it submits the job and tracks the ID.
The server queries synchronous data, returning immediate figures on spending and installs for quick operational checks.
You check if a background report is finished using get_report_status, and then download the actual data with download_report_results.
The agent narrows down results, allowing you to filter performance logs based on app, country, or platform.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Liftoff MCP Server: 7 Tools for Ad Metrics Retrieval
Use these tools to list assets, request deep-dive reports, check real-time spend data, and manage your entire mobile advertising performance lifecycle.
019d75c7download report results
Retrieves the final, compiled dataset for a performance report once the background job is finished.
019d75c7get report status
Checks the current progress of an asynchronous report request (v1) to see if it's pending, running, or complete.
019d75c7get spend metrics
Provides immediate access to synchronous spend and key performance metrics (v2).
019d75c7list liftoff apps
Lists every mobile application registered within your Liftoff advertising account.
019d75c7list liftoff campaigns
Retrieves a list of all active and historical advertising campaigns you run.
019d75c7list liftoff creatives
Lists every individual creative asset (like images or video ads) available for use in your campaigns.
019d75c7request performance report
Starts a background job to generate a detailed performance report covering a specified date range (v1).
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Liftoff, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI client connects directly to your Liftoff advertising account through this MCP Server. You'll use it to automate mobile ad performance tracking, listing assets, and generating deep-dive reports using natural conversation.
Listing Your Ad Infrastructure
To get a full picture of what you're running, the agent first checks all your active and historical resources. You can ask it to list every registered mobile application tied to your account using list_liftoff_apps. For campaigns, it pulls up a comprehensive list of every active or past advertising campaign with list_liftoff_campaigns.
It also checks for creative assets—those images or videos you're running in the ads—by calling list_liftoff_creatives. When you need to narrow down results across these lists, the agent lets you filter the performance logs by specific dimensions like app name, country, or platform.
Checking Real-Time Performance Metrics
If you just need quick operational data without waiting for a full report, the server queries synchronous metrics immediately. You use get_spend_metrics to get live figures on spending and key install counts right away. This is perfect for checking performance during peak hours or confirming budget burn rates on the fly.
Generating Detailed Performance Reports
When you need deep historical analysis, you can't rely on instant checks; you gotta run a background job. You start this process by telling the agent to request a detailed report using request_performance_report, specifying both your start and end dates for the data set. This action doesn’t give you numbers right away; it just starts the job, returning a unique ID that tracks the task.
To know what's happening with that background process, you check its status with get_report_status. You can repeatedly ask this until the server reports the status as complete. Once the report is finished and ready to go, you use download_report_results to pull down the actual, compiled dataset for your review. This workflow allows your agent to manage the entire lifecycle of a complex data request—from submission to final download.
This setup means you don't have to jump between dashboards or write complicated API calls. You just tell your AI client what you need—whether it’s listing all assets, getting current spend metrics for quick checks, or running an intensive historical report spanning months—and the server handles the whole data retrieval process.
How Liftoff MCP Works
- 1 Subscribe to the Liftoff server and input your API Key and Secret.
- 2 Instruct your AI client (e.g., 'What were my installs last week?').
- 3 The agent translates that request into a series of tool calls, executes them against the Liftoff API, and returns clean data.
The bottom line is you talk to your agent like talking to a coworker; it handles the complex API calls behind the scenes.
Who Is Liftoff MCP For?
This is for Growth Marketers and UA Managers who hate manually clicking through dashboards. If you spend time copying data from spreadsheets or waiting on an analyst, this saves you hours every week. It turns raw ad metrics into conversational facts.
They use get_spend_metrics to check today's spend and installs immediately without logging into the web dashboard.
They automate the extraction of performance logs by calling request_performance_report for large, structured datasets they need in their workflow.
They quickly check install trends and click-through rates across multiple countries using natural language commands against the server's data.
What Changes When You Connect
- Real-time spend checks: Use
get_spend_metricsto query synchronous data. You get instant operational awareness of spending and installs without waiting for a dashboard refresh. - Campaign visibility: Running
list_liftoff_campaignslets you map performance IDs to readable names instantly, so you know exactly what campaign drove the results. - Deep historical dives: Initiate long-term data pulls with
request_performance_report. You get structured reports for analyzing trends over months or quarters. - Asset management: Use
list_liftoff_creativesandlist_liftoff_appsto quickly audit your entire advertising library, making sure no assets are forgotten. - Workflow automation: The agent handles the whole cycle. You ask for data; it runs
request_performance_report, waits for completion usingget_report_status, and then pulls the results viadownload_report_results.
Real-World Use Cases
Quickly checking daily budget burn
The UA Manager needs to know if they're overspending right now. Instead of navigating multiple tabs, they ask the agent to 'show recent spend and installs for campaign ID X'. The agent uses get_spend_metrics and gives them a direct answer in seconds.
Auditing all campaigns before Q3 planning
A Growth Marketer needs to see every possible ad group. They run the tool chain: first, they call list_liftoff_apps to scope their data, then use list_liftoff_campaigns to get a master list, and finally ask for request_performance_report spanning 2023-2024.
Building a custom report for finance
The Data Analyst needs a full dataset of performance logs for Q1. They instruct the agent to run request_performance_report (specifying dates). The agent monitors status with get_report_status, and once finished, pulls the clean data using download_report_results.
Identifying creative gaps across regions
The marketer wants to check if a new ad format is working in Brazil vs. Germany. They use natural language filtering against the campaign data, which processes metadata gathered from list_liftoff_creatives and filters it by country.
The Tradeoffs
Trying to get live metrics via a report request
Asking the agent, 'Give me yesterday's spend data right now.' The system tries to run request_performance_report because it only knows how to handle async jobs, leading to unnecessary delay and complexity.
→
If you need metrics now, use the synchronous tool: get_spend_metrics. That skips the long report queue entirely. Use request_performance_report only for historical deep dives.
Copying campaign IDs manually
A user has to open the web console, find 20 campaigns, and copy all the unique IDs into their prompt to track them. This is slow and error-prone.
→
First, run list_liftoff_campaigns. The agent gives you a clean list of IDs right in the chat, so you can reference names or select IDs directly without leaving your conversation.
Assuming all assets are available
The user asks for performance data but forgets to check which creative assets were actually launched. The agent returns sparse data and the user gets confused about why.
→
Before running any query, start by calling list_liftoff_creatives to verify your active ad pool. Then use that list when referencing campaigns.
When It Fits, When It Doesn't
Use this server if you need to pull specific performance metrics (spend, installs) or structured reports from Liftoff's API using natural language conversation. The tools are perfect for UA Managers who live in dashboards and Data Analysts who need clean datasets.
Don't use it if your goal is simply visualization. If you just want a fancy dashboard, you build that separately (a data visualization tool handles that). Also, don't rely on this to fix API credential issues—you must handle the key setup yourself before any tools work.
However, if you need to cross-reference ad spend with other platforms or need complex statistical modeling beyond simple sums, you might need a specialized ETL (Extract, Transform, Load) service instead of just an MCP server. This tool gives you the raw data; you do the heavy lifting on analysis.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Liftoff. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 7 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Sifting through campaign dashboards is a waste of time.
Right now, getting a performance overview means jumping between the main dashboard, the campaign list view, and then downloading granular reports—all while copy-pasting IDs into spreadsheets. If you need to check spend metrics for Campaign A vs. Campaign B right now, it's a multi-step process that takes minutes just to gather the inputs.
With this MCP server, you ask your agent directly: 'What were the install numbers and total spend for Campaigns X and Y yesterday?' The system runs `get_spend_metrics` instantly and hands you the comparison in one go. No clicking, no copy-pasting. Just the answer.
Liftoff MCP Server: Access Campaign Data with `list_liftoff_campaigns`
Before writing a single query or asking for metrics, you have to know what's out there. Manually listing all campaigns requires logging into the platform and clicking through every tab until you find the master ID list. It’s tedious, and half the time, you miss an old, paused campaign that still matters.
Now, run `list_liftoff_campaigns`. The agent pulls the entire inventory of IDs and names directly to your chat window. This gives you a complete, clean dataset instantly, letting you scope out all potential data points before running any reports.
Common Questions About Liftoff MCP
How do I check current spending using get_spend_metrics? +
You simply ask the agent to 'show spend for last 24 hours'. The get_spend_metrics tool executes immediately, providing synchronous figures on your ad spend and install counts without needing to run a full report.
What's the difference between getting a report status using get_report_status and downloading it? +
get_report_status only tells you if the background job is done. You must wait for the agent to confirm 'Completed,' then you run download_report_results to actually retrieve the data file.
Can I list all apps using list_liftoff_apps? +
Yes, running list_liftoff_apps pulls a clean inventory of every mobile application linked to your account. This is useful for scoping out which campaigns you are tracking.
I need data from the last quarter; should I use request_performance_report? +
Yes, request_performance_report is for large, historical data sets over a range of dates. You must specify both your start and end date when you make this request.
What metadata does the `list_liftoff_campaigns` tool provide? +
It returns a comprehensive list of all campaigns, including their unique IDs and current naming structures. This is vital because it lets your agent map a readable campaign name to the required internal ID needed for running other reports.
How can I use `list_liftoff_creatives` to find specific ad assets? +
The tool retrieves all creative assets, allowing you to filter or search by asset type and status. If you know the name or ID of a creative, running this command helps verify its current existence before attempting to analyze performance data.
When should I use `get_spend_metrics` instead of `request_performance_report`? +
Use get_spend_metrics when you need immediate, synchronous financial and install numbers (v2). Use request_performance_report only for deep dives into historical data that requires an asynchronous job to process.
What is the prerequisite step before calling `download_report_results`? +
You must first run get_report_status and wait for the report status to show 'completed'. The download tool requires a finalized report ID, so confirming its readiness prevents errors.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
ANP (Revendedores de Combustíveis)
Access official Brazilian fuel and LPG reseller data from ANP — query gas stations and cooking gas providers by location or CNPJ.
MiiTel
Analyze phone conversations with AI that scores call quality, identifies sentiment, and provides coaching insights for sales teams.
Logflare (Log Management Analytics)
Streamline log management and analytics via Logflare — ingest events, execute ad-hoc SQL queries, and trigger pre-configured endpoints directly from your AI agent.
You might also like
Clustdoc
Collect client documents, track submission progress, and streamline onboarding with organized intake workflows.
PingPong
Global multi-currency payment platform for E-commerce — manage accounts, balances, and payouts via AI.
OpenTrivia
Access a massive database of trivia questions — fetch quizzes by category, manage session tokens, and track global question statistics.