Apple Ads MCP
OCI · GHCR.IO/ZELENTSOV-DEV/APPLE-ADS-MCP:V0.3.6 · SCANNED SEP 20
Local Apple Ads research, optimization, and receipt-gated App Store campaign management.
Available components
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
- Malware scan not yet available for this package.Unverified
- Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.Unverified
- Install-script risk not yet assessed.Unverified
- Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.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 19 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 9599 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.
How do I install the Apple Ads MCP server?
Apple Ads MCP runs locally as a container image, launched with docker run --rm -i ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6. 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:v0.3.6
claude mcp add zelentsov-dev-apple-ads-mcp -- docker run --rm -i ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6
{
"mcpServers": {
"zelentsov-dev-apple-ads-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"
]
}
}
} {
"servers": {
"zelentsov-dev-apple-ads-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"
]
}
}
} codex mcp add zelentsov-dev-apple-ads-mcp -- docker run --rm -i ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zelentsov-dev-apple-ads-mcp": {
"type": "local",
"command": [
"docker",
"run",
"--rm",
"-i",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"
],
"enabled": true
}
}
} mcp_servers:
zelentsov-dev-apple-ads-mcp:
command: "docker"
args: ["run", "--rm", "-i", "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"] {
"McpServers": {
"zelentsov-dev-apple-ads-mcp": {
"Transport": "stdio",
"Command": "docker",
"Arguments": [
"run",
"--rm",
"-i",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"
]
}
}
} {
"mcpServers": {
"zelentsov-dev-apple-ads-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6"
]
}
}
} 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.
- 20 Sept 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.
- 17 Sept 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.
- 15 Sept 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.
- 13 Sept 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.
- 11 Sept 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.
- 9 Sept 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.
- 8 Sept 26 +3
- Stability: unverified → 0.27 ▲ functional
- 1 Sept 26 +8
- Judged manipulation: unverified → pass ▲ security
- Schema quality: unverified → good ▲ functional
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 20 Sept 2026 · Analysed oci/ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.6
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 →
campaigns_query ~156
Query bounded campaigns with endpoint-specific filters.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| campaignId | string | – | exact campaign ID shortcut |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| id | string | – | legacy exact campaign 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.
category_suggestions ~134
Get category opportunities for an App Store app.
| 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.
change_history ~360
Read bounded Apple Ads change history for a required typed event window.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adAccountIds | null|array | – | optional audited ad account IDs |
| adGroupIds | null|array | – | optional parent ad group IDs |
| campaignIds | null|array | – | optional parent campaign IDs |
| end | string | yes | required event window end date in YYYY-MM-DD |
| entityIds | null|array | – | optional changed entity IDs |
| entityTypes | null|array | – | optional Apple audit entity types |
| eventTypes | null|array | – | CREATE, UPDATE, or DELETE |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| metadata | string | – | none, latest, or snapshot; defaults to latest |
| needTotals | null|boolean | – | request accurate totalCount; Apple defaults to true |
| 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 |
| start | string | yes | required event window start date in YYYY-MM-DD |
| timeRange | null|object | – | report or insight time range |
| timeZone | string | – | UTC or ORTZ; defaults to UTC |
| transactionIds | null|array | – | optional audit transaction IDs |
| userIds | null|array | – | optional Apple Ads user IDs |
| userTypes | null|array | – | CUSTOMER, CUSTOMER_API, or APPLE_SUPPORT |
Structured output declared, but exposes no named fields.
No examples provided.
change_history_detail ~83
Read bounded field-level details for one change-history entry.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| detailId | string | yes | change detail ID |
| limit | integer | – | result limit from 1 to 200 |
| offset | integer | – | zero-based result offset |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
creative_create_preview ~54
Preview creation of one creative.
| 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.
creative_delete_preview ~67
Preview irreversible deletion of one unreferenced creative.
| 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.
creative_get ~67
Read one creative by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| creativeId | string | – | creative ID as a string |
| id | string | – | legacy creative ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
creative_update_preview ~64
Preview a creative 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.
creatives_query ~158
Query bounded App Store creatives with endpoint-specific filters.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| creativeId | string | – | exact creative ID shortcut |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| id | string | – | legacy exact creative 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.
daily_budget_recommendation_apply_preview ~87
Preview applying one daily-budget recommendation under an explicit maximum.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| appliedAmount | null|object | – | – |
| maximumAmount | null|object | – | – |
| profile | string | yes | local Apple Ads profile name |
| promotedObjectId | string | yes | – |
| recommendationId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
daily_budget_recommendation_dismiss_preview ~85
Preview dismissing one daily-budget recommendation.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| appliedAmount | null|object | – | – |
| maximumAmount | null|object | – | – |
| profile | string | yes | local Apple Ads profile name |
| promotedObjectId | string | yes | – |
| recommendationId | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| summary | string | yes | – |
No examples provided.
daily_budget_recommendations ~135
Read daily-budget recommendations without applying them.
| 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.
impression_share ~141
Read app impression-share insights through a typed UTC request.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adamId | string | yes | promoted app Adam ID as a string |
| country | string | – | optional ISO country or region code |
| end | string | yes | range end in YYYY-MM-DD |
| granularity | string | yes | DAILY or WEEKLY_SUN_SAT |
| pagination | null|object | – | bounded result window |
| profile | string | yes | local Apple Ads profile name |
| reportType | string | yes | FIRST_SLOT or ALL_SLOTS |
| start | string | yes | range start in YYYY-MM-DD |
Structured output declared, but exposes no named fields.
No examples provided.
keyword_bid_preview ~83
Preview a targeting keyword bid update.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | optional parent ad group assertion |
| bid | object | yes | – |
| campaignId | string | – | optional parent campaign assertion |
| keywordId | 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.
keyword_create_preview ~55
Preview creation of one targeting keyword.
| 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.
keyword_delete_preview ~68
Preview irreversible deletion of one keyword 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.
keyword_get ~68
Read one targeting keyword by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | – | legacy keyword ID |
| keywordId | string | – | keyword ID as a string |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
keyword_pause_preview ~49
Preview pausing one targeting keyword.
| 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.
keyword_report ~158
Read bounded keyword performance rows, optionally including EMPTY_METRICS.
| 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 |
| includeZeroMetrics | boolean | – | include keywords with no metric rows by requesting EMPTY_METRICS |
| 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.
keyword_resume_preview ~49
Preview resuming one targeting keyword.
| 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.
keyword_suggestions ~134
Get keyword opportunities for an App Store app.
| 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.
keyword_update_preview ~65
Preview a targeting keyword 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.
keywords_bulk_create_preview ~75
Preview up to 100 same- or cross-group keyword creates as one Apple bulk request and aggregate receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | – |
| items | 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.
keywords_bulk_update_preview ~68
Preview up to 100 targeting keyword updates as one drift-bound operation.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | yes | – |
| items | 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.
keywords_query ~184
Query bounded targeting-keyword inventory with a required typed scope.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | ad group scope 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 keyword ID shortcut |
| keywordId | string | – | exact keyword 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.
negative_keyword_create_preview ~56
Preview creation of one negative keyword.
| 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.
negative_keyword_delete_preview ~70
Preview irreversible deletion of one negative keyword 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.
negative_keyword_get ~72
Read one negative keyword by ID for current-state verification.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| id | string | – | legacy negative keyword ID |
| negativeKeywordId | string | – | negative keyword ID as a string |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
negative_keyword_update_preview ~66
Preview a negative keyword 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.
negative_keywords_bulk_create_preview ~75
Preview up to 100 negative keyword creates in one scope.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | – |
| campaignId | string | – | – |
| items | 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.
negative_keywords_bulk_update_preview ~75
Preview up to 100 negative keyword updates in one scope.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | – |
| campaignId | string | – | – |
| items | 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.
negative_keywords_query ~200
Query bounded negative-keyword inventory with a valid campaign or ad-group scope.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| adGroupId | string | – | ad group scope shortcut |
| campaignId | string | – | campaign scope shortcut; without adGroupId selects campaign-level negatives |
| fields | null|array | – | report fields to return |
| filters | null|array | – | endpoint-specific filter conditions |
| groupBy | null|array | – | report dimensions |
| id | string | – | legacy exact negative keyword ID shortcut |
| negativeKeywordId | string | – | exact negative keyword 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.
operations_apply ~36
Apply exactly one non-expired, drift-free preview receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt | string | yes | one-time operation receipt returned by a preview tool |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| receipt | null|object | – | – |
| summary | string | yes | – |
| used | boolean | – | – |
| verification | null|object | – | – |
No examples provided.
operations_inspect ~38
Inspect receipt binding, expiry, and use state without applying it.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt | string | yes | one-time operation receipt returned by a preview tool |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| receipt | null|object | – | – |
| summary | string | yes | – |
| used | boolean | – | – |
| verification | null|object | – | – |
No examples provided.
operations_verify ~44
Re-read receipt targets after an ambiguous write, including restart-safe optimization recovery, and return current state.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt | string | yes | one-time operation receipt returned by a preview tool |
| Name | Type | Req | Description |
|---|---|---|---|
| error | null|object | – | – |
| preview | null|object | – | – |
| receipt | null|object | – | – |
| summary | string | yes | – |
| used | boolean | – | – |
| verification | null|object | – | – |
No examples provided.
optimization_baseline ~57
Build a bounded 28-day Apple Ads performance baseline for a named policy.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| policy | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
optimization_history ~53
Read bounded local decisions and verification history for a named policy.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| policy | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
optimization_plan ~53
Build an on-demand bounded optimization plan without creating a receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| policy | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
optimization_plan_preview ~56
Build and bind one bounded active-policy optimization plan to a composite receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| policy | 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.
optimization_policies_list ~21
List named local optimization policies without credentials or account data.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
optimization_policy_get ~52
Read one named optimization policy with resolved balanced thresholds.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| policy | string | yes | – |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
org_get ~38
Read one Apple Ads organization.
| Name | Type | Req | Description |
|---|---|---|---|
| orgId | string | yes | Apple Ads organization ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
phrase_suggestions ~134
Get phrase opportunities for an App Store app.
| 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.
product_page_get ~60
Read a Default or Custom Product Page by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| adAccountId | string | yes | Apple Ads ad account ID |
| productPageId | string | yes | Default or Custom Product Page ID |
| profile | string | yes | local Apple Ads profile name |
Structured output declared, but exposes no named fields.
No examples provided.
product_page_locales ~133
Query bounded Product Page locale details.
| 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.
product_pages_query ~133
Query bounded Default and Custom Product Pages.
| 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.
profiles_list ~16
List configured profile names without exposing credentials.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
search_term_popularity ~132
Read search-term popularity insights.
| 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.
search_term_report ~132
Read bounded search-term 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.
server_info ~22
Show server version, safety mode, API family, and response limits.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
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:v0.3.6).
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,561 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 20 September 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.