# Liftoff MCP > Liftoff connects your advertising account to any AI agent, automating complex mobile marketing reports and analytics. You can list campaigns, request deep performance data for specific dates, or get immediate spend metrics—all through simple conversation. Stop jumping between ad dashboards just to pull a single number. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** mobile-advertising, campaign-performance, user-acquisition, marketing-analytics, ad-spend ## Description Connecting Liftoff directly gives your AI client access to all your mobile advertising metadata. Instead of logging into the platform and clicking through dozens of tabs, you simply ask for what you need. Your agent can list apps, campaigns, and creative assets so you know exactly what data exists. Need to check spend right now? You can query immediate metrics in plain language. If you're looking at historical trends, you just request a detailed performance report, specifying the start and end dates. The system handles the lengthy report generation process, telling your agent when it’s done so you can download the results easily. This level of direct access is what makes platforms like Vinkius essential, pulling complex ad data into natural conversations. ## Tools ### list_liftoff_apps Retrieves a complete list of all mobile applications associated with your Liftoff account. ### list_liftoff_campaigns Fetches a comprehensive listing of every active and past advertising campaign name. ### request_performance_report Starts an asynchronous job to build a detailed performance report for the start and end dates you specify. ### list_liftoff_creatives Lists all creative assets used in your advertising campaigns. ### download_report_results Gets the finalized data payload for a report after the generation process is complete. ### get_report_status Checks the current status of any initiated performance report request. ### get_spend_metrics Provides an immediate, synchronous view of your total ad spend and install counts for a specific period. ## Prompt Examples **Prompt:** ``` List all active advertising campaigns in Liftoff. ``` **Response:** ``` I've retrieved your campaigns. You have 12 active campaigns, including 'Spring Sale 2024', 'iOS Retargeting', and 'Android Global Launch'. Which one would you like to see metrics for? ``` **Prompt:** ``` Show recent spend and installs for campaign ID 'camp-123'. ``` **Response:** ``` I've queried the spend report. For campaign 'camp-123' today, you've spent $1,250.00 and generated 450 installs with a conversion rate of 3.2%. ``` **Prompt:** ``` Request a performance report for the month of July in JSON format. ``` **Response:** ``` I've submitted the report request for July (Start: 2024-07-01, End: 2024-07-31). The report ID is 'rep-98765'. I will monitor its status for you. ``` ## Capabilities ### Map out campaign structure List every application, advertising campaign, and creative asset in your account. ### Request historical performance reports Start a deep-dive report for any specified date range so you can analyze past trends. ### Get immediate spend metrics Fetch synchronous data, providing real-time totals for ad spending and installs right now. ### Track report status Check if a requested performance report is ready to view or download. ### Filter specific datasets Limit data views by app, campaign name, country, or platform type. ## Use Cases ### Checking mid-day budget burn A UA Manager needs to know the current day's spend and install rate for a new campaign. They prompt their agent: 'What were the spend metrics today for Campaign X?' The agent uses `get_spend_metrics` and provides the exact numbers instantly, allowing them to adjust bids immediately. ### Comparing quarterly performance A Data Analyst needs to compare Q1 vs. Q2 data across 5 different apps. They ask their agent to 'Request a performance report for April and May.' The agent uses `request_performance_report` and then monitors the status using `get_report_status` until both files are ready to download. ### Investigating poor app performance A Growth Marketer notices one country is underperforming. They prompt their agent: 'Show me all campaigns and creatives for Brazil.' The agent executes `list_liftoff_campaigns` and `list_liftoff_creatives`, allowing the marketer to pinpoint which asset needs replacement. ### Auditing campaign structure A team member joins and needs to know what's running. They ask their agent, 'List all apps, campaigns, and creatives.' The agent runs `list_liftoff_apps`, then `list_liftoff_campaigns` and `list_liftoff_creatives` sequentially, giving the new employee a full system overview. ## Benefits - Immediate Spend Checks: Use `get_spend_metrics` to instantly check spend and install totals. You don't have to wait for an overnight report to know if you hit your daily goals. - Automated Reporting Workflow: Instead of manually requesting and waiting for files, use `request_performance_report`. Your agent monitors the status using `get_report_status` until the data is ready to download via `download_report_results`. - Full Campaign Visibility: Need context? You can first run `list_liftoff_apps`, then `list_liftoff_campaigns`, and finally filter by dimensions, all within one chat session. - Deep Metadata Access: Get a full view of your assets using `list_liftoff_creatives` to ensure you are tracking performance against the right creative versions. - Saves Time on Data Collection: You stop spending hours compiling data from multiple dashboards. The MCP centralizes access, letting your AI client pull metrics directly into natural conversation. ## How It Works The bottom line is you get hands-free access to complex ad analytics without writing any code or navigating multiple dashboard menus. 1. Subscribe to the Liftoff MCP and provide your unique API Key and Secret. 2. Connect this MCP to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent a specific question, like 'What was the spend last week for App X?' and review the resulting data. ## Frequently Asked Questions **How do I use the Liftoff MCP to get current spend metrics?** You run `get_spend_metrics` by asking your agent for 'current spend and installs.' The tool provides synchronous data immediately, so you don't have to wait hours for a report. **Is the Liftoff MCP better than downloading reports manually?** Yes. Manually downloading reports is slow and requires multiple files. This MCP centralizes access; you can request the data using `request_performance_report` and your agent manages the whole process for you. **Can I use Liftoff MCP to see all my campaigns?** Absolutely. Run `list_liftoff_campaigns` to get a comprehensive list of every campaign running in your account, making it easy to scope your analysis. **What if the report I need is old? Can Liftoff MCP handle that?** Yes. You use `request_performance_report` and specify historical start and end dates. The tool will generate a deep-dive report for you to review later. **Does the Liftoff MCP only work with specific ad clients?** No. Because it's an MCP, your agent can connect to any compatible client, including Claude and Cursor, letting you analyze data wherever you already work.