Lily Apple Ads

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_campaigns

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_list_keywords

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_apps

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_changes

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_lookup_keyword_settings

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_preview

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_recommend

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

lily_ads_plan_render

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

lily_ads_revenue_render

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_campaigns

Reserved equivalent of CLI `lily ads suggestions cpa`. Returns current readiness and will call Apple Platform API target CPA suggestions when Apple exposes the endpoint. Do not use this to answer the current configured CPA Goal / target CPA / CPA cap; use lily_ads_lookup_keyword_settings or lily_ads_list_adgroups instead.

lily_ads_suggestions_cpa

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_prepare

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_create

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_revenue_summary