Documentation
Apple Ads MCP connection
Lily exposes scoped Apple Ads workflows to compatible AI clients through a managed remote MCP connection. Connect Apple Ads in Lily first, then authorize the client and verify its account scope with a read-only request. Free MCP access includes 1,000 calls per month. No card or Lily subscription required.
Prerequisites
You need a Lily account, an authorized Apple Ads connection, and at least one selected app. RevenueCat or AppsFlyer is optional and only required for downstream revenue questions.
Free access and monthly calls
MCP access does not require a paid Lily subscription or credit card. Free includes 1,000 calls per UTC calendar month, shared across your MCP clients. Successful billable queries and action preparation count; discovery, authorization, confirmations, cancellations, and failed calls do not. When the allowance is used up, wait for the next month or upgrade; there are no automatic overage charges. Your external agent uses its own model, and an exhausted Lily AI trial does not disable remaining tool calls.
Connection sequence
Complete Apple Ads onboarding, choose the compatible AI client, finish Lily OAuth, and ask for the available account and app names. Confirm they match the intended scope before requesting a report.
Grok Bot connection
Grok Bot and Claude Code use Lily's standard MCP URL: https://www.chatlily.ai/api/mcp/apple-ads/bot. Sign in to Lily and approve the requested permissions, then verify the account and app scope with a read-only request. Campaign changes are prepared for review and executed only after explicit confirmation through MCP. Existing /grok connections remain compatible.
Troubleshooting scope
If a campaign is missing, verify the Apple Ads organization, app mapping, client authorization, date range, and currency. Reauthorize after material permission changes rather than sharing credentials manually.