MCP App Store
by KeenEthics
Lily Apple Ads icon

Lily Apple Ads MCP Server for ChatGPT

By Spore AI, Inc.

Overview

Lily Apple Ads connects ChatGPT to Apple Ads performance and keyword-level revenue attribution (RevenueCat, AppsFlyer, and more). Inspect apps, accounts, campaigns, ad groups, keywords, ROAS, and revenue by keyword. Diagnose recent performance, generate optimization plans, review campaign changes, and apply Apple Ads updates only after your confirmation.

How to connect

  1. ChatGPT: Open the Lily Apple Ads listing in the ChatGPT app directory and choose Connect. ChatGPT listing Lily Apple Ads exposes 24 tools here.

Tools

lily_ads_doctor

ChatGPT
MCP equivalent of CLI lily ads doctor: checks Lily login, analytics entitlement, scopes, and accessible apps. Connection checks only: appleAdsReady does not verify app SDK code, RevenueCat AdServices configuration, sync freshness, or production attribution. setupVerification lists these evidence gaps. Write scope is not required for a setup check. It does not expose Apple private keys.

lily_ads_explain_changes

ChatGPT
Explain why yesterday's Apple Ads performance changed versus the previous day. Joins retained dimension-level delivery snapshots, provider-separated attributed revenue cohorts, and Lily's execution audit. Matching operations are correlation evidence, not guaranteed causation.

lily_ads_list_accounts

ChatGPT
List Lily-authorized Apple Ads accounts and app scopes available to this ChatGPT connection. Start here before reading or preparing Apple Ads changes.

lily_ads_list_adgroups

ChatGPT
Read ad groups inside one campaign after verifying the campaign belongs to the requested Lily-authorized app scope.

lily_ads_list_apps

ChatGPT
List Lily-accessible Apple Ads apps and their appId/adamId for revenue queries. Call this first when the user asks for ROAS, revenue, or Apple Ads performance without giving an app ID. If exactly one app is returned, use that appId directly instead of asking the user.

lily_ads_list_campaigns

ChatGPT
Read campaigns for one Lily-authorized Apple Ads app, including biddingStrategy and campaign-level targetCpa. Requires appId/adamId, and only returns campaigns in that app scope. Use these campaign fields to distinguish a MAX_CONVERSIONS Target CPA from an ad group cpaGoal.

lily_ads_list_changes

ChatGPT
Read Lily's Apple Ads execution audit trail for one authorized app. Use this when the user asks what changed today, yesterday, or recently, including Dashboard/manual changes, confirmed Ask Lily actions, Autopilot, and experiments. This does not include changes made directly in Apple's own web console.

lily_ads_list_keywords

ChatGPT
Read keywords inside one ad group after verifying the campaign belongs to the requested Lily-authorized app scope. Keyword bid answers should include the keyword Max CPT/bid, parent ad group Default Bid, and parent ad group CPA Goal in one response. For a keyword's configured CPA Goal when the campaign/ad group is unknown, prefer lily_ads_lookup_keyword_settings.

lily_ads_lookup_keyword_settings

ChatGPT
Business-first lookup for a keyword's current Apple Ads settings. Use this when the user asks 'what is this keyword bid/CPT/default bid/CPA goal/target CPA/CPA cap?' and only gives keyword text. It searches campaigns/ad groups in the authorized app and returns keyword bidAmount plus the parent ad group defaultBidAmount and configured cpaGoal. Do not use lily_ads_suggestions_cpa for current configured CPA Goal; it returns Apple's live advisory target CPA suggestion, not current settings.

lily_ads_plan_apply

ChatGPT
Apply the Apple Ads changes only after the user explicitly clicks Confirm in the Lily Ads review panel. The confirmation token is hidden from the model and supplied by the widget.

lily_ads_plan_cancel

ChatGPT
Reject pending Lily Ads actions after the user clicks Cancel in the ChatGPT panel. No Apple Ads writes are performed.

lily_ads_plan_create

ChatGPT
Stage a review-only Apple Ads campaign package after the user accepts a recommended plan. Supports Search Results and Search Tab campaigns, ad group, CPA goal, keywords, negative keywords, and optional custom product page metadata. Search Tab packages do not require keywords. This only creates a temporary confirmation card in Lily; it does not change Apple Ads until the user clicks Confirm in the rendered panel.

lily_ads_plan_prepare

ChatGPT
Stage one review-only Apple Ads change card. Supports budgets, status launch/pause, CPA goals, bids, keywords, negative keywords, and ad group settings. This only creates temporary Lily approval tokens; it does not change Apple Ads until the user clicks Confirm in the rendered panel. For one user request, put all related changes in one actions array so the user approves once.

lily_ads_plan_preview

ChatGPT
Preview the same business-first campaign package shape as CLI lily ads plan create. This noauth preview never writes to Apple Ads and returns JSON for user review.

lily_ads_plan_recommend

ChatGPT
Business-first equivalent of CLI lily ads plan recommend: use when the user asks to create, scale, or launch a new Apple Ads campaign but has not provided every setting. First discover the app and recent performance when possible, then choose safe draft defaults, explain assumptions, and ask the user to approve or modify. This is review-only and never writes to Apple Ads.

lily_ads_plan_render

ChatGPT
Render a campaign plan review widget for ChatGPT. This is review-only and does not create campaigns.

lily_ads_platform_readiness

ChatGPT
MCP equivalent of CLI lily ads platform readiness: reports Lily readiness for Campaign Management API v5 and Apple Ads Platform API v1 migration.

lily_ads_recommendations_apply

ChatGPT
Reserved equivalent of CLI lily ads recommendations apply. Apple exposes apply endpoints for target CPA and daily-budget recommendations, but Lily keeps this write disabled until its confirmation-gated write contract is verified.

lily_ads_reports_campaigns

ChatGPT
Run the MCP equivalent of CLI lily ads reports campaigns: Apple Ads spend/performance enriched with Lily keyword-level revenue when available. If appId is unknown, call lily_ads_list_apps first. For broad 'data怎么样' questions, prefer lily_ads_reports_diagnose so the answer includes business judgment instead of only a table.

lily_ads_reports_diagnose

ChatGPT
Diagnose Apple Ads performance from the same revenue-aware reporting layer used by CLI reports. Use this for broad questions such as '数据怎么样', 'how is performance', 'how was ROAS', or 'what should I do next'. If appId is unknown, call lily_ads_list_apps first; if exactly one app is returned, use it directly. Default to the recent completed 7-day window unless the user asks for a specific date. No Apple Ads writes are performed.

lily_ads_revenue_render

ChatGPT
Render a compact ChatGPT widget for a Lily Ads revenue summary or campaign report.

lily_ads_revenue_summary

ChatGPT
Run the MCP equivalent of CLI lily ads revenue summary: summarize Apple Ads spend, revenue, and ROAS from Lily Ads Revenue Analytics. If appId is unknown, call lily_ads_list_apps first. For broad '数据怎么样' questions, prefer lily_ads_reports_diagnose so the answer includes diagnosis and recommended next steps.

lily_ads_suggestions_cpa

ChatGPT
Read the Apple Ads Platform API v1 target CPA suggestion for an app. This is advisory and does not change the configured campaign Target CPA or ad-group CPA Goal. Use lily_ads_lookup_keyword_settings or lily_ads_list_adgroups for current configured values.

lily_auth_status

ChatGPT
MCP equivalent of CLI lily auth status: check whether ChatGPT is connected to Lily Ads Revenue Analytics and which analytics capabilities are active.

Capabilities

InteractiveWrites

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/plugin_asdk_app_6a5495cc8ca48191b45381939794838d"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/plugin_asdk_app_6a5495cc8ca48191b45381939794838d)