Apple Ads MCP API reference

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

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

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 requestedLink to this section

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

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`	Create an additional Apple ad account in the authorizing user's organization.	Write	On demand
`apple_ads_create_adgroup`	Create a PAUSED manual-CPT Apple ad group under a verified campaign.	Write	On demand
`apple_ads_create_campaign`	Create an App Store search-results campaign in PAUSED state.	Write	On demand
`apple_ads_create_keyword`	Create a PAUSED positive keyword in a verified Apple ad group.	Write	On demand
`apple_ads_update_adgroup`	Update an Apple adgroup.	Write	On demand
`apple_ads_update_campaign`	Update an Apple campaign.	Write	On demand
`apple_ads_update_keyword`	Update an Apple keyword.	Write	On demand

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`	Read the selected Apple ad account, including native currency, timezone and billing configuration.	Read	Announced
`apple_ads_get_adgroups`	Read a page of ad groups belonging to one Apple campaign.	Read	On demand
`apple_ads_get_app`	Read App Store app metadata available to the selected Apple ad account.	Read	On demand
`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`	Read one Apple campaign and verify its account membership.	Read	On demand
`apple_ads_get_campaigns`	Read a page of Apple app campaigns, including paused campaigns.	Read	On demand
`apple_ads_get_keywords`	Read a page of positive keywords belonging to one Apple ad group.	Read	On demand
`apple_ads_get_report`	Read native Apple campaign, ad group, ad, keyword or search-term performance for explicit campaigns.	Read	On demand