Free Apple Ads MCP: No-Code Setup

  • Free forever plan: unlimited connected accounts, up to 30 days of history (15 days in AI chats) and 100 automation credits a month.
  • Nothing to host: Porter keeps the key pair and the hourly tokens, so you paste three IDs once.
  • Run Apple Ads end to end: keywords, search terms, budgets, Search Match and live dashboards.
  • Safe by default: new campaigns start paused, and every change waits for your approval.
Try free

What is a Apple Ads MCP server?

A Apple Ads MCP server lets an AI assistant like Claude or ChatGPT reach your Apple Ads data through the Model Context Protocol (MCP). You ask in plain language, and the assistant calls the Apple Ads Platform API for campaigns, keywords, search terms and budgets.

  • Quick setup: paste https://mcp.portermetrics.com/mcp into Claude, ChatGPT or Cursor and sign in with your Porter account. Full steps
  • Works in: Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex
  • Data: 122 Apple Ads fields: keywords, search terms, budgets, Search Match and installs
  • Changes: campaigns, ad groups, keywords, negatives, budgets and bids, each after your approval; new campaigns start paused
  • Price: free plan, paid plans from $15 per account a month
  • Official Apple Ads server: none from Apple as of November 2026
Use cases

Apple Ads MCP use cases

Porter connects Apple Ads, the platform formerly called Apple Search Ads, to Claude, ChatGPT and other AI clients through one MCP server. Ask which keywords install cheapest, which search terms deserve their own keyword or which campaign runs out of budget by noon.

Reports

Campaign management

  • Campaigns from a brief: a campaign for your app in the countries you name, with a daily budget, created paused.
  • Ad groups: default bid, CPA goal, end date and Search Match, set at launch or changed later.
  • Multi-org and cross-channel: every organization your Apple Ads API user reaches, next to the Meta Ads MCP on the same server.

Reporting and install analytics

  • 122 fields: 32 metrics and 90 dimensions, all in the Apple Ads fields list.
  • New users or returning ones: Installs (Tap-Through), Installs (View-Through), New Downloads (Total) and Redownloads (Total).
  • Product pages: Ad Name, Product Page ID and Creative Type with CR (Tap-Through).
  • Where and on what: Country or Region, Device Class and Ad Placement.
  • Live dashboards: one link that stays current, built by Porter’s AI dashboards from the same chat.

Apple Ads next to your other app channels

  • Cost per install side by side: Apple Ads Spend and Installs (Total) next to Meta Ads Amount spent and App installs.
  • Taps to sessions: Apple Ads Taps beside GA4 Sessions, through the GA4 connector for Claude.
  • One budget conversation: where the next dollar of app budget installs cheapest, in one table.

Research

  • Keywords and negatives: add keywords with match type and bid, plus campaign negative keywords.
  • Keywords: Keyword, Match Type and Keyword Bid Amount next to Spend, Taps, Installs (Total) and Avg CPA (Total).
  • Search terms: every Search Term and Search Term Source that showed your ads, with the keyword and ad group behind it.

Management

  • Status and budgets: pause, resume or delete campaigns and ad groups, and move daily budgets.
  • Scheduled reports: a dashboard emailed to you or a client on the day and hour you pick.

Example answer

Demo data, from a fictional organization. Prompt: “Show my keywords from the last 14 days with Spend, Taps and Installs (Total), with Avg CPT, conversion rate and cost per install.”

CampaignKeywordSpendTapsInstallsAvg CPTConversion rateCost per install
Brand · Exactbudgeting app$612.401,840702$0.3338.2%$0.87
Category · Broadexpense tracker$1,488.902,210388$0.6717.6%$3.84
Competitor · Exactmint alternative$920.1564096$1.4415.0%$9.58
Discovery · Search Matchmoney manager$402.70880121$0.4613.8%$3.33

The competitor keyword costs almost $10 an install, against under $1 for brand, so Claude drafts a lower bid on it.

Reference

Apple Ads MCP server reference

One server, every organization: Porter connects Apple Ads to the AI clients, fields and workflows app marketers already use. The same Porter server URL works in Claude, ChatGPT and any MCP client that supports remote servers. Porter’s actions call Apple’s Campaign Management API directly, so Claude reads campaigns, ad groups and keywords as they stand right now.

Apple Ads fields

Account objects: organizations · apps · campaigns · ad groups · keywords · negative keywords · search terms · ads

Campaign setup: Org ID · App Name · Campaign Name · Campaign Status · Ad Channel Type · Ad Group Name · Search Match · Ad Group Status

Keywords and search terms: Keyword · Match Type · Keyword Status · Search Term · Search Term Source · Keyword (Search Term) · Match Type (Search Term)

Creative: Ad Name · Product Page ID · Creative Type · Ad Status

Apple Ads metrics

Delivery: Spend · Impressions · Taps · TTR · Avg CPT · Avg CPM · Avg Daily Spend

Installs: Installs (Total) · Installs (Tap-Through) · Installs (View-Through) · New Downloads (Total) · Redownloads (Total) · Pre-orders (Total)

Efficiency: Avg CPA (Total) · Avg CPA (Tap-Through) · CR (Total) · CR (Tap-Through)

Budgets and bids: Daily Budget · Default Bid Amount · Keyword Bid Amount · Suggested Bid Amount · Bid Amount (Search Term)

Porter has 122 ready-made Apple Ads fields, 32 metrics and 90 dimensions. Each one is in the full Apple Ads field reference.

Dimensions and segments

Campaign: Org ID · App Name · Campaign Name · Ad Group Name · Keyword · Search Term · Ad Name

Geo and device: Country or Region · Device Class · Ad Placement

Time: Date · Week · Month · Quarter · Year · Hour of day

Other destinations

The same Apple Ads connection also sends data to Data Studio (formerly Looker Studio), BigQuery and Google Sheets, at no extra cost.

Apple Ads reports one level at a time, so Claude asks about campaigns, ad groups, keywords, search terms or ads in separate questions. Search terms with 10 impressions or fewer come back as one unnamed row, as Apple’s search term report rules set them.

Security and trust

Safety and security

Porter’s Apple Ads MCP connects through an Apple Ads API user, creates new campaigns paused and asks before anything changes in your organization. Reporting, drafting and budget changes are separate actions. An AI client working through Porter touches only as much of your Apple Ads account as the task needs and you approve.

Reporting first

Ask about keywords, search terms and installs without writing anything back to Apple Ads. Reporting runs apart from changes, so a CPA question never edits an ad group.

Reporting priced per organization

Reporting is billed per connected Apple Ads organization. One more question about the same organization adds nothing to the bill.

Your API role decides what changes

Claude makes only the changes your API user’s role allows. In Apple’s guide to the Apple Ads Platform API, an Account Admin assigns roles such as API Account Manager or API Account Read Only. A read-only role keeps Claude to questions.

Paused by default

Porter creates campaigns paused, and Claude shows you the plan before it calls the create. Nothing serves until you approve it or turn it on in Apple Ads.

Budgets checked before they apply

Claude shows the new daily budget or default bid next to the current one and waits for your yes. Budgets and bids are in your organization’s currency, named in the Currency field.

Deletes are permanent

Deleting a campaign or ad group can’t be undone. Claude asks first, so pause rather than delete when you might want it back.

A key pair, not a password

Porter gives you a public key to add in Apple Ads and never asks for your Apple sign-in. Apple’s OAuth guide for the Apple Ads API sets client secrets to last up to 180 days and access tokens one hour, and Porter handles both.

Revoke access anytime

Disconnect Apple Ads in Porter, or have an Account Admin change the API user’s role in Apple Ads. Apple revokes API access when the user stops being an API user.

Setup

How to set up the Apple Ads MCP server

Porter’s Apple Ads MCP uses one server URL in every AI client, plus an Apple Ads API user you connect in Porter once. Claude takes Porter as a plugin or a custom connector. ChatGPT takes it through the Porter Metrics app or a custom MCP server. Both reach the same Apple Ads organizations.

https://mcp.portermetrics.com/mcp

Connect your Apple Ads organization in Porter

You need an Apple Ads Advanced account and an API user that an Account Admin invited.

  1. Invite an API user in Apple Ads: Account Settings → User Management.
  2. Open Porter, find Apple Ads and select Connect.
  3. Copy Porter’s public key.
  4. Paste it in Apple Ads as the API user: Account Settings → API.
  5. Copy the three IDs Apple Ads shows you.
  6. Paste them in Porter and pick the organizations Claude should reach.

How to install Apple Ads MCP in Claude

  1. Open claude.ai and go to Settings → Connectors.
  2. Click Add custom connector.
  3. Name it Porter and paste https://mcp.portermetrics.com/mcp.
  4. Click Add, then sign in with your Porter account and approve access.
  5. Ask an Apple Ads question, like “Show Spend, Taps and Installs (Total) by Campaign Name for the last 7 days.”

On Team and Enterprise plans, an owner adds the connector first. Anthropic’s custom connector guide covers the same steps. The Claude-specific setup and use cases live on the Apple Ads connector for Claude page.

Watch the Claude setup demo

How to install Apple Ads MCP in ChatGPT

ChatGPT has two routes to the same data. The Porter Metrics app in ChatGPT’s app directory works on any plan with apps. The Porter MCP gets every new tool the day Porter ships it, on Business, Enterprise and Edu workspaces.

Porter Metrics app: in ChatGPT, open Apps, search “Porter Metrics”, click Connect and sign in with your Porter account.

Porter MCP:

  1. Open ChatGPT on the web and go to Plugins.
  2. Click +, then Add custom MCP server.
  3. Name it Porter and paste https://mcp.portermetrics.com/mcp under Connection.
  4. Choose OAuth, tick “I understand and want to continue” and click Create as a plugin.
  5. Sign in with your Porter account.

Pro accounts can add it with read access only, per OpenAI’s custom MCP server guide.

The Apple Ads connector for ChatGPT page covers the ChatGPT side in full.

Watch the ChatGPT setup demo

How to install Apple Ads MCP in Claude Code, Cursor, VS Code and Codex

Pick your coding agent. Each one uses the same server URL and a Google sign-in, so no API key or credentials file sits in a config.

  1. Add Porter’s plugin in Claude Code. It installs the Porter connector and Porter’s skill in one step.
    /plugin marketplace add portermetrics/porter /plugin install porter-metrics@portermetrics
  2. Ask for your data. The first time, your browser opens: sign in with the Google account you use in Porter.
  3. No plugins? Add the server directly instead:
    claude mcp add --transport http porter https://mcp.portermetrics.com/mcp
  4. Check: /mcp shows porter as connected. Ask: “Which Apple Ads accounts can you see?”
  1. Open Cursor Settings → Tools & Integrations and click New MCP Server. Cursor opens mcp.json.
  2. Paste this and save.
    { "mcpServers": { "porter": { "url": "https://mcp.portermetrics.com/mcp" } } }
  3. Click Connect next to porter and sign in with the Google account you use in Porter.
  4. Check: porter shows a green dot in Tools & Integrations. Open an Agent chat. Ask: “Which Apple Ads accounts can you see?”
  1. Open the Command Palette (Ctrl/Cmd+Shift+P) and run MCP: Add Server → HTTP.
  2. Paste https://mcp.portermetrics.com/mcp, name it porter and choose Global. Or add it to .vscode/mcp.json:
    { "servers": { "porter": { "type": "http", "url": "https://mcp.portermetrics.com/mcp" } } }
  3. Allow the sign-in prompt and sign in with the Google account you use in Porter.
  4. Check: open Copilot Chat in Agent mode; Porter’s tools appear under the tools icon. Ask: “Which Apple Ads accounts can you see?”
  1. Add Porter from your terminal.
    codex mcp add porter --url https://mcp.portermetrics.com/mcp
  2. Sign in. Your browser opens: sign in with the Google account you use in Porter.
    codex mcp login porter
  3. Check: codex mcp list shows porter as logged in. Start codex. Ask: “Which Apple Ads accounts can you see?”

The same URL works in Windsurf, Cline, Zed and any client that supports remote MCP servers over HTTP.

Add Porter’s skill

Porter’s skill teaches Claude which Porter tools to call for each Apple Ads task, so answers need fewer retries. In claude.ai, download https://mcp.portermetrics.com/skill.zip and upload it in Settings → Capabilities → Skills. In Claude Code, Porter’s plugin adds it for you, and other agents can run npx skills add portermetrics/porter.

Test the connection

Paste this into a new chat. It only reads data.

Use Porter only. List every Apple Ads organization I can access, then show Spend, Taps, Installs (Total) and Avg CPA (Total) by Campaign Name for the last 7 days. Say so if an account returns no data.

Is there an official Apple Ads MCP server URL?

Apple hosts no MCP server of its own (as of November 2026). Apple offers the Apple Ads Platform API, and MCP servers for Apple Ads are built on it by third parties or the community. Porter’s URL above is the hosted route: no Node.js, no Docker and no keys on your own machine.

Guides and videos

Prompts

Apple Ads MCP prompts

Copy a prompt into Claude or ChatGPT, then change the dates or thresholds to fit your account. Every change waits for your approval.

Reporting prompts

Keywords by cost per install

For the last 30 days, by Keyword, Match Type and Ad Group Name, show Keyword Bid Amount, Spend, Taps, TTR, Avg CPT, Installs (Total) and Avg CPA (Total). Rank the 20 keywords with the most Spend by Avg CPA (Total) and list keywords with more than $50 Spend and 0 installs.

Search-term harvest

For the last 30 days, by Search Term, Search Term Source, Keyword (Search Term) and Match Type (Search Term), show Spend, Taps and Installs (Total). Leave out the row with an empty Search Term. List terms under $3 per install with 5+ installs, and terms with 20+ Taps and 0 installs.

New users vs redownloads

For the last 30 days, by Campaign Name, show Spend, Installs (Tap-Through), Installs (View-Through), New Downloads (Total) and Redownloads (Total). Calculate the share of redownloads and the cost per new download.

Ads or product page?

For the last 6 weeks, by Week and Campaign Name, show Impressions, Taps, TTR, Installs (Total) and CR (Total). For campaigns where installs fell more than 20% week over week, tell me whether TTR or CR (Total) fell most.

Country and device

For the last 30 days, show Spend, Taps, Installs (Total) and Avg CPA (Total) by Country or Region. Then run the same table by Device Class.

Research and audit prompts

Is Search Match worth it?

For the last 30 days, by Ad Group Name and Search Match, show Default Bid Amount, Spend, Taps, Installs (Total), Avg CPA (Total) and CR (Total). Compare Search Match on vs off.

Apple Ads next to Meta Ads

For the last 30 days, show Apple Ads Spend and Installs (Total) by Campaign Name, then Meta Ads Amount spent and App installs by Campaign name. Put cost per install for both in one table.

Taps to sessions

Put Apple Ads Taps by Campaign Name next to GA4 Sessions by Session campaign for the last 30 days.

Bid check

For my brand ad group, show Keyword, Keyword Bid Amount and Avg CPT for the last 14 days, and flag keywords whose Avg CPT sits within 10% of the bid.

The research skills that compare channels blend Apple Ads with Meta Ads and GA4, so connect those sources in Porter first.

Management prompts

Harvest into keywords and negatives

Add the first list from the search-term harvest as exact-match keywords in the same ad group at $1.20, and the second list as exact negatives on the campaign. Show me each one before you add it.

Search Match off

Turn Search Match off on ad groups whose Avg CPA (Total) runs 30% above the account average. List them first and wait for my OK.

Budget pacing

This month, by Date and Campaign Name, show Spend and Installs (Total), then list my campaigns with their daily budgets. Propose new daily budgets for the ones that hit their cap, and don’t apply them until I approve.

Campaign from a brief

Create a paused campaign ‘US – Brand’ for my app in the United States with a $50 daily budget, one ad group ‘Brand exact’ with a $1.50 default bid and Search Match off, three exact-match keywords and one campaign negative. Show me everything first.

Weekly report by email

Build an Apple Ads dashboard with Spend, Installs (Total), Avg CPA (Total) and CR (Total) by campaign, and email it to me every Monday at 8 a.m.
Who this is for

Who this is for

App marketers who buy App Store search and report on it every week get the most from Porter’s MCP. Agencies, paid media managers, growth teams and marketing analysts use it to turn an Apple Ads question into a ranked report, a paused draft or a dashboard in one chat.

Agencies and freelancers

  • Every client organization: one question across the organizations your API user reaches, with Org ID as a column.
  • Client reports: a live dashboard the client opens on Monday that nobody rebuilt.

Your client isn’t asking about TTR. They’re asking what a new user costs on the App Store.

App marketers and paid media managers

  • Keyword reviews: the costliest keywords ranked by cost per install before the weekly check-in.
  • Search-term harvest: winners added as exact keywords, losers as negatives, each approved.

Growth leads

  • New users only: cost per new download, without redownloads in the count.
  • Apple next to Meta: cost per install on both channels in one table.
Comparison

Apple Ads MCP servers vs. Porter

Apple doesn’t host an Apple Ads MCP server (as of November 2026), so every Apple Ads MCP is built on Apple’s own API by someone else. Most are open-source servers you run yourself. Porter is a hosted server that adds approved changes, dashboards and your other channels.

An open-source server hands your AI the raw API. The Porter MCP hands it the app marketing job: every channel, the reporting, the changes and skills that already know the work.

Both call the same Apple Ads API and need an Apple Ads API user. Here is where they part.

PorterOpen-source Apple Ads MCP server
Same job, different reach
ServerHosted by Porter at mcp.portermetrics.com/mcpRuns on your machine or server (Node.js, Python or Docker)
CredentialsPorter’s public key in Apple Ads, three IDs pasted onceYour own key pair, client secret and token refresh
ChangesCampaigns, ad groups, keywords, negatives, budgets, default bids and Search Match, created paused, approval before every writeDepends on the project; often bids and keywords too
Fields122 ready-made fields with the labels you see in Apple AdsRaw API responses
PriceIncluded in every Porter plan, the free plan tooFree to download; you host and maintain it
Only one side
Other channels30+ data sources: Meta Ads, Google Ads, GA4 and more—
Live dashboardsYes—
Scheduled reports by emailYes—
Data Studio, Google Sheets, BigQueryYes—
Skills for whole tasksYes—

Apple’s API facts follow the Apple Ads Platform API help page and Apple’s OAuth guide (as of November 2026).

Pick an open-source server when you want keyword bid edits from the chat and can host it. Pick Porter when the job includes approved changes, other channels or reports someone else opens. Both can sit in the same Claude account.

Is Apple Search Ads MCP the same thing?

Yes. Apple renamed Apple Search Ads to Apple Ads on April 14, 2025, as its ads grew beyond App Store search. An “Apple Search Ads MCP” and an “Apple Ads MCP” reach the same campaigns through the same API, so Porter’s one server URL covers both searches.

And the other Apple Ads MCPs?

Most other Apple Ads MCP servers fall into three types, and the job tells you which one you’re looking at.

  • Reporting connectors: they read your data into the chat and write nothing back.
  • Campaign controllers: they create and edit, usually on one or two platforms.
  • Open-source servers: free to download and yours to host. You keep the private key and patch it when Apple changes the API.

Porter does all three jobs from one hosted server, starting on the free plan.

Porter vs other hosted Apple Ads MCPs

Other hosted Apple Ads MCPs also skip the setup. Porter is built for teams that report on several accounts and channels:

1

Every account at once

One prompt answers for all your Apple Ads accounts and clients, not one account per setup.

2

Apple Ads next to 30+ sources

GA4, Google Tag Manager, Google Ads, Meta Ads and Shopify, blended in one answer.

3

Competitor research

Competitor ads, keywords and search results, next to your own Apple Ads numbers.

4

Reports outside the chat

Live dashboards, scheduled email reports, and the same data in Data Studio, BigQuery and Google Sheets.

5

Changes with approval

Every Apple Ads change is shown first and waits for your yes.

6

Claude and ChatGPT both covered

A remote MCP URL, plus an approved app in ChatGPT’s app directory.

Apple Ads MCP pricing

The Apple Ads MCP is included in every Porter plan, the free-forever plan too. Reporting is billed per connected account.

  • 14-day trial: everything unlimited, no credit card.
  • Free forever: unlimited connected accounts, 30 days of history (15 days in AI chats), 100 automation credits a month.
  • Paid Reporting: from $15 per account a month, or $12.50 billed annually.
  • Unlimited questions: AI chats, queries and dashboards are included. Reads are free; each completed change uses 1 automation credit.
5 accounts
Monthly billing
$40
Annual billing, per month
$33.33
Per account
$8.00

Reporting price for connected accounts, in USD. AI chats, queries and dashboards are unlimited. Annual billing is 10 months for 12.

The more accounts you connect, the lower the price per account. See the full calculator on Porter pricing.

Frequently asked questions

Is there an official Apple Ads MCP?

No. Apple offers the Apple Ads Platform API but hosts no MCP server of its own (as of November 2026). Porter's Apple Ads MCP runs at https://mcp.portermetrics.com/mcp on Apple's API, hosted for you, with approved changes, live dashboards and your other channels. Open-source servers are the self-hosted route.

What is the Apple Ads MCP server URL?

Porter's Apple Ads MCP server URL is https://mcp.portermetrics.com/mcp. Paste it into Claude, ChatGPT or another AI client as a custom connector, then connect your Apple Ads organization in Porter with an API user. The same URL also reaches your other ad and analytics sources.

Is the Apple Ads MCP free?

Porter's Apple Ads MCP is included in every Porter plan, the free-forever plan too. The free plan covers unlimited connected accounts, up to 30 days of history, 15 days in AI chats and 100 automation credits a month. Paid Reporting starts at $12.50 a month per data source account, billed annually, and the 14-day trial needs no card.

Can I connect several Apple Ads organizations or apps?

Yes. One Apple Ads API user reaches every organization it's invited to, and each organization connects to Porter as one account. Claude compares them in one answer with Org ID as a column, and App Name splits apps inside an organization. The free plan connects unlimited accounts.

Can Claude change keyword bids in Apple Ads?

Claude adds new keywords with their bid and changes an ad group's default bid once you approve. For keywords that already exist, you change bids, pause or delete them in Apple Ads as usual, and Claude ranks which ones to touch first by cost per install.

Troubleshooting

Why don't the numbers match the Apple Ads dashboard?

Compare full days in your organization's time zone first, because today is still an incomplete day. Installs (Total) adds tap-through and view-through installs. Search terms with 10 impressions or fewer sit in one unnamed row, and Porter returns rates like TTR as fractions, so ask Claude to show percentages.

Why does Claude return no Apple Ads data?

Check that your account signs in through Apple Ads Advanced, and that an Account Admin invited the API user to the right organization. Then reconnect Apple Ads in Porter. Apple Ads Basic accounts and organizations the API user can't reach come back empty.

Why did an Apple Ads question fail?

Ask one level at a time: campaign fields don't combine with keyword or search-term fields. Budgets and CPA goals come from the campaign and ad group lists, so Claude reads them there instead of the report. Split the question and Claude answers each part.

Start free

Connect Apple Ads to Claude or ChatGPT and run your first keyword review, search-term harvest or paused campaign draft.

Start free: unlimited Apple Ads organizations on the free-forever plan, or a 14-day trial with everything unlimited and no card.

  • Agencies: every client's organization answers to one prompt.
  • App marketers: the search-term harvest takes one prompt, not an afternoon.
  • Growth leads: Apple and Meta cost per install in one table.
  • Marketing analysts: the same fields in chat, Sheets and BigQuery.