Apple Ads MCP API reference

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

View as Markdown

Performance alertsAvailable on Team and Enterprise. Check supported metrics, levels and dimensions before creating a rule.

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

To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.

Connection

Platform id: apple_ads
Tool prefix: apple_ads_
Account parameter: adAccountId
Dedicated endpoint: https://mcp.getmcpads.com/apple-ads/mcp
Access: Connect Apple Ads and select the organizations your assistant may access. Apple account roles apply.
Tools: 19, 11 of which write
Metrics: 9
Dimensions: 8

Scope requested

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

Catalogues

Write tools (11)

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

Write tools (11)
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_rename_ad`	Rename an Apple ad.	Write	On demand
`apple_ads_rename_ad_account`	Rename an Apple ad account.	Write	On demand
`apple_ads_rename_adgroup`	Rename an Apple ad group.	Write	On demand
`apple_ads_rename_campaign`	Rename an Apple campaign.	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

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.

Read tools (8)
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

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.