AdPilot MCP
Sign in
Browse documentation
Last reviewed

Connect Apple Ads to Grok

You can connect Apple Ads (formerly Apple Search Ads) to Grok by adding AdPilot MCP as a custom connector. Grok can then diagnose campaigns that are not spending, review keyword and search-term performance, compare Apple spend with RevenueCat proceeds, and make the changes you request within your AdPilot limits.

What you need before you start

  • An AdPilot workspace with at least one app and Apple Ads connected on Connections. See Connect Apple Ads to AdPilot MCP if you have not done this yet.
  • A Grok account. xAI makes connectors available to Grok users; on Grok Business and Enterprise, a team admin must add the connector first.
  • Optional: RevenueCat connected, so Grok can include proceeds and ROAS in its answers.

Grok never receives your Apple Ads private key or password. It receives an OAuth token scoped to your AdPilot workspace, which you can revoke on AdPilot's MCP Clients page.

Add AdPilot as a custom connector

  1. Go to grok.com/connectors.
  2. Click New Connector, then select Custom.
  3. Enter the MCP URL from AdPilot's Home or MCP Clients page: https://adpilotmcp.com/mcp.
  4. Complete the AdPilot sign-in and approve access when the authorization page opens.

Grok discovers AdPilot's tools and makes them available in your conversations.

Add AdPilot for a Grok Business or Enterprise team

A team admin with Team Read-Write permission provisions the connector once:

  1. Sign in to console.x.ai, select your team, and open Grok Business → Connectors.
  2. Click + Add Connector, select Other, and enter the AdPilot MCP URL.
  3. Complete any required authentication.

Team members then open grok.com/connectors and connect their own AdPilot accounts. Each person signs in to AdPilot individually, so AdPilot's workspace roles and limits apply to each member.

Ask Grok about your Apple Ads account

Grok uses a connector when your question relates to it, so mention AdPilot or Apple Ads in the request and name the app:

  • Use AdPilot to list my apps and which Apple Ads campaigns are mapped to each.
  • Using my Apple Ads data in AdPilot, review [App Name] for the last 30 complete days.

AdPilot reports complete days only. Asking for "the last 7 complete days" avoids comparing a partial today with full days.

Worked example: fix a campaign that barely spends

This example shows the shape of a typical session. The numbers are illustrative.

You: Use AdPilot: my Category campaign for Pantry Planner has a $50 daily budget but spent only $6 a day over the last 14 complete days. Why?

Grok calls get_campaign, analyze_under_delivery, and get_keyword_performance, then explains what it found:

Check Finding
Campaign and ad group Both running, no serving errors
Budget $50 daily, $6 average spend, not the limit
Keywords 9 exact keywords, 7 with under 100 impressions
Bids versus recent CPT Most bids sit below the average CPT paid
Countries and Search Match United States only, Search Match off

Grok concludes that the campaign is bid-constrained on its higher-volume keywords and volume-constrained on the rest. It suggests raising bids on the three keywords with proven installs by 15% and leaving the low-impression keywords alone for now, since a higher bid cannot create searches that do not exist. Apple's impression share report can confirm which case applies.

You: Raise those three bids by 15%.

Grok calls increase_keyword_bid for each keyword. AdPilot checks each change against your bid and spend limits, applies it in Apple Ads, and returns action IDs. A week later, ask Evaluate the bid changes from last week and AdPilot compares the windows before and after with get_action_evaluation.

Prompts that work well in Grok

  • Use AdPilot to summarize my Apple Ads portfolio for the last 7 complete days.
  • Use AdPilot to find search terms that spent money without installs for [App Name] this month.
  • Using AdPilot, compare Apple Ads spend with RevenueCat proceeds for [App Name] over 28 complete days.
  • Use AdPilot to show every change made this week and which ones can be rolled back.
  • Use AdPilot to add exact negatives for the wasted terms you found, within my limits.

More prompts are in What to ask AdPilot about Apple Ads.

Troubleshooting checklist

  • Custom is not offered on grok.com/connectors: on Grok Business or Enterprise, ask a team admin to add AdPilot in the console first.
  • Grok answers without your data: mention AdPilot by name in the request so Grok uses the connector.
  • Sign-in fails: remove the connector, revoke the stale client on AdPilot's MCP Clients page, and add it again.
  • Results look stale: check the sync status on AdPilot's Connections page and the latest complete metrics date.
  • An operation is blocked: read the limit named in the answer. See Direct operations, limits, and audit.

How AdPilot works with Grok

Grok handles the conversation and decides when to call a connector. AdPilot holds the synced Apple Ads structure and metrics, app strategy notes, RevenueCat context, skills, limits, and audit history. Every call is authorized through the OAuth connection you approved, validated server-side, and recorded with that client, so changes made from Grok appear in Changes next to those made from any other assistant.

Next steps

Official sources

Need help with AdPilot MCP?

Contact support at support@kovacssoftware.com

AdPilot is an independent service and is not affiliated with, endorsed by, sponsored by, or operated by Apple Inc. Apple and Apple Ads are trademarks of Apple Inc.