Apple Ads MCP
OCI · GHCR.IO/ZELENTSOV-DEV/APPLE-ADS-MCP
Local Apple Ads research, optimization, and receipt-gated App Store campaign management.
Available components
Last scanned (23 hours ago)
Scores higher than 68% of OCI servers
Category Marketing and SEO
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security0
- No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.Unverified
- Known CVEs could not be checked: this image's dependency list comes from an SBOM its publisher attached, which nothing verifies, so we will not report it as a clean result.Unverified
- Install-script risk not yet assessed.Unverified
- Dependency health could not be checked: this image's dependency list comes from an SBOM its publisher attached. It names packages and versions but not whether each is deprecated, still maintained or linked to its source, so there is nothing we can fairly grade.Unverified
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 9 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability66
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 9607 tokens (~87/item across 110 items; 110 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management67
- Stability observed for 20 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage96
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 87% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "ad_delete_preview" implies "delete" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Fail
- An AI judge read all 111 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
- 30 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.
- 26 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 25 Oct 26 0
- Tool safety: pass → unverified ▼ security
- Stability: 0.30 → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: v0.3.7 → v0.3.8 functional
- 24 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.
- 22 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Nov 2026 · Analysed oci/ghcr.io/zelentsov-dev/apple-ads-mcp@v0.3.8
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | oci |
| Reason | No attestation published |
Background: How many MCP packages publish verified provenance →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
account_health ~62
Collect a read-only identity, access, and account baseline.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adamId | string | – | optional App Store Adam ID to verify ownership |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
ad_account_get ~51
Read sanitized account currency, timezone, payment model, features, and delegations.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
ad_accounts_list ~32
Discover Apple Ads account ACLs available to a profile.
| Name | Type | Req | Description |
|---|---|---|---|
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
ad_create_preview ~54
Preview creation of one ad.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| payload | object | yes | typed create payload for the resource |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_delete_preview ~68
Preview irreversible deletion of one ad under a paused campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| expectedText | string | yes | exact current resource name or keyword text |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_get ~67
Read one ad by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adId | string | – | ad ID as a string |
| id | string | – | legacy ad ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
ad_group_bid_preview ~86
Preview an ad-group default bid update with decimal amount and currency.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | ad group ID as a string |
| amount | string | yes | decimal bid amount |
| currency | string | yes | ISO 4217 currency |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_cpa_cap_preview ~96
Deprecated by Apple: preview a legacy ad-group CPA cap update; retained for compatibility without automatic strategy conversion.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | ad group ID as a string |
| amount | string | yes | decimal bid amount |
| currency | string | yes | ISO 4217 currency |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_create_preview ~56
Preview creation of one ad group.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| payload | object | yes | typed create payload for the resource |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_delete_preview ~70
Preview irreversible deletion of one ad group under a paused campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| expectedText | string | yes | exact current resource name or keyword text |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_get ~72
Read one ad group by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | ad group ID as a string |
| id | string | – | legacy ad group ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
ad_group_pause_preview ~50
Preview pausing one ad group.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_report ~132
Read bounded ad-group performance rows.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
ad_group_resume_preview ~50
Preview resuming one ad group.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_schedule_preview ~71
Preview an ad-group start and end schedule update.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| endTime | null|string | – | – |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| startTime | null|string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_search_match_preview ~67
Preview enabling or disabling Apple Search Match for a Search Results ad group.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | – |
| enabled | boolean | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_targeting_preview ~61
Preview App Store-only ad-group targeting.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| targeting | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_group_update_preview ~66
Preview an ad-group update.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | target resource ID as a string |
| payload | object | yes | typed fields to update |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_groups_query ~172
Query bounded ad groups with endpoint-specific filters.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | exact ad group ID shortcut |
| campaignId | string | – | campaign scope shortcut |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| id | string | – | legacy exact ad group ID shortcut |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
ad_pause_preview ~48
Preview pausing one ad.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_report ~130
Read bounded ad performance rows.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
ad_resume_preview ~48
Preview resuming one ad.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ad_update_preview ~64
Preview an ad update.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | target resource ID as a string |
| payload | object | yes | typed fields to update |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
ads_query ~180
Query bounded ads with endpoint-specific filters.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | ad group scope shortcut |
| adId | string | – | exact ad ID shortcut |
| campaignId | string | – | campaign scope shortcut |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| id | string | – | legacy exact ad ID shortcut |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
advertiser_resources_list ~47
List App Store content-provider delegations available to a profile.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
app_locale_details ~185
Query compact locale metadata, or full assets for one required languageCode.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adamId | string | yes | App Store Adam ID as a string |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| includeAssets | boolean | – | include full assets for one required languageCode |
| languageCode | string | – | optional exact locale such as en-US |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
app_opportunities ~89
Collect independently classified eligibility and suggestion sections for an app.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adamId | string | yes | App Store Adam ID as a string |
| countriesOrRegions | null|array | yes | ISO country or region codes |
| profile | string | yes | local Apple Ads profile name |
| terms | null|array | – | optional seed terms |
Structured output declared, but exposes no named fields.
No examples provided.
app_rejection_reason_get ~61
Read one App Store app rejection reason.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| profile | string | yes | local Apple Ads profile name |
| rejectionReasonId | string | yes | app rejection reason ID as a string |
Structured output declared, but exposes no named fields.
No examples provided.
app_rejection_reasons_query ~136
Query bounded App Store app rejection reasons.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
app_store_geo_search ~139
Search eligible App Store countries, administrative areas, and localities.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| countryCode | string | – | ISO 3166-1 alpha-2 country code |
| eligible | boolean | – | exclude soft-blocked geos |
| entity | string | – | Country, AdminArea, or Locality |
| offset | integer | – | zero-based result offset |
| pageSize | integer | – | page size from 1 to 200 |
| profile | string | yes | local Apple Ads profile name |
| query | string | – | geo search text with at least two characters or * |
Structured output declared, but exposes no named fields.
No examples provided.
apps_eligibility ~132
Check App Store advertising eligibility.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
apps_get ~58
Read an App Store app by Adam ID.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adamId | string | yes | App Store Adam ID as a string |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
apps_search ~142
Search apps; an empty result for a non-ASCII owned-app query gets one bounded exact-name fallback.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| cpids | null|array | – | optional iTunes content provider IDs |
| limit | integer | – | result limit from 1 to 200 |
| offset | integer | – | zero-based result offset |
| profile | string | yes | local Apple Ads profile name |
| query | string | – | app name or Adam ID search text |
| returnOwnedApps | boolean | yes | limit results to apps owned by the organization |
| storefronts | null|array | – | ISO storefront country codes |
Structured output declared, but exposes no named fields.
No examples provided.
auth_check ~29
Validate OAuth credentials and return the caller identity.
| Name | Type | Req | Description |
|---|---|---|---|
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_audit ~140
Collect campaign, ad-group, keyword, and search-term report baselines.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_bid_strategy_preview ~68
Preview MANUAL_CPT or eligible App Store Search Results MAX_CONVERSIONS strategy.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| strategy | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_countries_preview ~59
Preview replacing campaign country targeting.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | – |
| countries | null|array | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_create_preview ~60
Preview creation of one campaign and return a ten-minute receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| payload | object | yes | typed create payload for the resource |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_daily_budget_preview ~61
Preview a campaign daily-budget update with typed money.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| amount | object | yes | – |
| campaignId | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_delete_preview ~69
Preview irreversible deletion of one paused campaign and its cascade inventory.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| expectedText | string | yes | exact current resource name or keyword text |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_get ~67
Read one campaign by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | – | campaign ID as a string |
| id | string | – | legacy campaign ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_inventory ~76
Read a campaign and bounded child inventory for safe auditing.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | campaign ID as a string |
| pageSize | integer | – | maximum children per resource from 1 to 200 |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_pause_preview ~54
Preview pausing one campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | campaign ID as a string |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_report ~130
Read bounded campaign performance rows.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| options | null|object | – | report or insight options |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| sorting | null|array | – | ordered sort fields |
| timeRange | null|object | – | report or insight time range |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_resume_preview ~54
Preview resuming one campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | campaign ID as a string |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_schedule_preview ~69
Preview a campaign start and end schedule update.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| endTime | null|string | – | – |
| id | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| startTime | null|string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_shared_budget_assign_preview ~64
Preview assigning one LOC shared budget to one campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| sharedBudgetId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_shared_budget_unassign_preview ~65
Preview removing one shared-budget assignment from one campaign.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
| sharedBudgetId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
campaign_status_reason_details ~58
Read App Store campaign limited-status reason details.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | yes | campaign ID as a string |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
campaign_update_preview ~68
Preview a campaign update after reading current state.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | yes | target resource ID as a string |
| payload | object | yes | typed fields to update |
| profile | string | yes | local Apple Ads profile name |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
How do I install the Apple Ads MCP server?
Apple Ads MCP runs locally as a container image, launched with docker run --rm -i -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.
oci · ghcr.io/zelentsov-dev/apple-ads-mcp
claude mcp add zelentsov-dev-apple-ads-mcp -- docker run --rm -i -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8
This image reads APPLE_ADS_MCP_CONFIG. Set it in your client's env block for this server; docker run -e passes it through to the container.
What is the Apple Ads MCP server?
Apple Ads MCP is listed in the public MCP registry as io.github.zelentsov-dev/apple-ads-mcp. Local Apple Ads research, optimization, and receipt-gated App Store campaign management. This page covers its container image (ghcr.io/zelentsov-dev/apple-ads-mcp).
Is the Apple Ads MCP server safe to use?
Apple Ads MCP scores 47 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Apple Ads MCP server expose?
Apple Ads MCP exposes 110 tools: account_health, ad_account_get, ad_accounts_list, ad_create_preview, ad_delete_preview, and 105 more. Their descriptions and schemas cost roughly 9,569 tokens of context every time the server is loaded.
Is the Apple Ads MCP server still maintained?
Apple Ads MCP is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Apple Ads MCP server under?
Apple Ads MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.