# Apple Ads

> Every Apple Ads tool the MCP server exposes, with its parameters. 15 tools, 9 metrics and 8 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

App Store campaigns, ad groups, keywords and performance reports with native attribution metrics.

> **Note** OAuth provider registered. Live advertiser acceptance is in progress; Apple account roles apply.

Connection

|  |  |
| --- | --- |
| Platform id | `apple_ads` |
| Tool prefix | `apple_ads_` |
| Account parameter | `adAccountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/apple-ads/mcp |
| Access | OAuth provider registered. Live advertiser acceptance is in progress; Apple account roles apply. |
| Tools | 15, 7 of which write |
| Metrics | 9 |
| Dimensions | 8 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `searchads` | Read Apple Ads accounts and reports, and manage campaigns with the role and accounts approved in Apple. Paid-plan writes require explicit confirmation; the gateway controls which selected accounts are reachable. | Yes |

> **Note** What the gateway can change here: Create paused campaigns, ad groups and keywords; update names, status and campaign budgets. Create additional ad accounts in your Apple organization.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/apple-ads/metrics): 9 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/apple-ads/dimensions): 8 dimensions, with their constraints.

## Write tools (7)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`apple_ads_create_account`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_create_account) | Create an additional Apple ad account in the authorizing user's organization. | Write | On demand |
| [`apple_ads_create_adgroup`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_create_adgroup) | Create a PAUSED manual-CPT Apple ad group under a verified campaign. | Write | On demand |
| [`apple_ads_create_campaign`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_create_campaign) | Create an App Store search-results campaign in PAUSED state. | Write | On demand |
| [`apple_ads_create_keyword`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_create_keyword) | Create a PAUSED positive keyword in a verified Apple ad group. | Write | On demand |
| [`apple_ads_update_adgroup`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_update_adgroup) | Update an Apple adgroup. | Write | On demand |
| [`apple_ads_update_campaign`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_update_campaign) | Update an Apple campaign. | Write | On demand |
| [`apple_ads_update_keyword`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_update_keyword) | Update an Apple keyword. | Write | On demand |

## Read tools (8)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`apple_ads_get_account`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_account) | Read the selected Apple ad account, including native currency, timezone and billing configuration. | Read | Announced |
| [`apple_ads_get_adgroups`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_adgroups) | Read a page of ad groups belonging to one Apple campaign. | Read | On demand |
| [`apple_ads_get_app`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_app) | Read App Store app metadata available to the selected Apple ad account. | Read | On demand |
| [`apple_ads_get_app_eligibility`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_app_eligibility) | Check an app's advertising eligibility and available storefronts before creating a campaign. | Read | On demand |
| [`apple_ads_get_campaign`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_campaign) | Read one Apple campaign and verify its account membership. | Read | On demand |
| [`apple_ads_get_campaigns`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_campaigns) | Read a page of Apple app campaigns, including paused campaigns. | Read | On demand |
| [`apple_ads_get_keywords`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_keywords) | Read a page of positive keywords belonging to one Apple ad group. | Read | On demand |
| [`apple_ads_get_report`](https://www.getmcpads.com/docs/sources/apple-ads/tools/apple_ads_get_report) | Read native Apple campaign, ad group, ad, keyword or search-term performance for explicit campaigns. | Read | On demand |

---

This page as HTML: https://www.getmcpads.com/docs/sources/apple-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.