// MCP TOOL REFERENCE

APPLE ADS TOOLS

54 tools from the Apple Ads MCP Server, categorised by risk level.

// ALL 54 APPLE ADS TOOLS

READ 34 tools

Read find_ad_rejection_reasons Find ad rejection reasons across your account, or get a specific rejection reason by ID. Use this when ads ... Read find_app_assets Find app assets (screenshots, app previews, etc.) using filters. Useful for checking which visual assets ar... Read get_ad Get full details of a specific ad including its creative association, serving status, and any rejection rea... Read get_ad_group Get full configuration of a specific ad group: bid settings, CPA goal, status, and scheduling. Use get_adgr... Read get_ad_report Get performance metrics per ad variation within a campaign. Compare creative performance to identify which ... Read get_adgroup_report Get performance metrics for ad groups within a campaign. Compare ad group performance to identify which tar... Read get_app_details Get detailed information about an app by Adam ID including app name, category, and store metadata. Set incl... Read get_app_eligibility Check if an app is eligible for Apple Search Ads in specific countries and supply sources. Shows eligibilit... Read get_budget_analysis Analyze budget utilization and efficiency across ALL campaigns. Shows spend vs budget, daily run rate, days... Read get_budget_order Get full details of a specific budget order including budget amount, remaining balance, supply sources, and... Read get_campaign_details Get full configuration of a specific campaign: targeting settings, budgets (total + daily), countries, supp... Read get_campaign_report Get performance metrics for one or all campaigns over a date range. Returns impressions, taps, installs, sp... Read get_campaign_snapshot Get a comprehensive snapshot of a campaign in ONE call: campaign config, all ad groups, top keywords by spe... Read get_creative Get full details of a specific creative including its associated app, type, state, and timestamps. Read get_geo_performance Get performance metrics broken down by country or region for a campaign. Shows impressions, taps, installs,... Read get_impression_share_report_by_id Get an impression share report by ID. Poll until state=COMPLETED (typically 1-5 minutes). The report contai... Read get_keyword_report Get keyword-level performance metrics: impressions, taps, installs, spend, CPA, CPT, and conversion rate pe... Read get_me_details Get details about the currently authenticated API user including user ID and parent org ID. Useful for debu... Read get_negative_keyword Get details of a specific negative keyword by ID at the campaign or ad group level. Read get_product_page_by_id Get details of a specific product page by ID. Product pages are App Store page variations used to create cu... Read get_search_term_report Get actual user search queries that triggered your ads, with full performance metrics. THIS IS THE MOST VAL... Read get_targeting_keyword Get details of a specific targeting keyword: text, match type, bid amount, and status. Use get_keyword_repo... Read list_ad_groups List or search ad groups. Provide campaignId to scope to one campaign, or omit to search across all campaig... Read list_ads List or search ads. Provide campaignId + adGroupId for a direct listing, campaignId alone to search within ... Read list_budget_orders List all budget orders in the account. Budget orders define the overall spending authorization and billing ... Read list_campaigns List or search campaigns in the account. Returns campaign ID, name, status, budgets, countries, and supply ... Read list_creatives List or search creatives in the account. Creatives link product pages to ads — you need a creative before y... Read list_impression_share_reports List all custom impression share reports with their status (QUEUED, RUNNING, COMPLETED, FAILED). Use to fin... Read list_negative_keywords List negative keywords at campaign or ad group level. Negative keywords prevent your ads from showing for s... Read list_organizations List all organizations (campaign groups) you have access to. Shows org ID, name, currency, payment model, a... Read list_product_pages List all product pages for an app. Product pages are App Store page variations that can be used as creative... Read list_targeting_keywords List or search targeting keywords in a campaign. Provide adGroupId for keywords in a specific ad group, or ... Read search_apps Search for apps eligible for Apple Search Ads campaigns by name or keyword. Returns app name, Adam ID (need... Read search_geolocations Search or look up geo locations for campaign geo targeting. Search by name (query) to find locations, or pr...

WRITE 15 tools

Write add_negative_keywords Add negative keywords to block wasteful search terms from triggering your ads. Campaign-level negatives blo... Write add_targeting_keywords Add new targeting keywords to an ad group. Keywords determine which App Store search queries trigger your a... Write create_ad Create a new ad within an ad group. Requires a creativeId — use list_creatives to find available creatives,... Write create_ad_group Create a new ad group within a campaign. After creation, add targeting keywords (add_targeting_keywords) to... Write create_budget_order Create a new budget order to authorize spending. Budget orders are the top-level billing entity — campaigns... Write create_campaign Create a new Apple Search Ads campaign. After creation, you MUST create at least one ad group (create_ad_gr... Write create_creative Create a new creative for use in ads. Creatives are based on App Store product pages. Use list_product_page... Write create_impression_share_report Create an async custom impression share report. Returns a report ID — poll with get_impression_share_report... Write switch_organization Switch the active organization context. All subsequent API calls (campaigns, reports, etc.) will operate un... Write update_ad Update an ad Write update_ad_group Update an ad group Write update_budget_order Update an existing budget order. Can change name, budget amount, and end date. Increasing budget extends sp... Write update_campaign Update a campaign Write update_negative_keywords Update negative keywords in bulk at the campaign or ad group level. Change status (ACTIVE/PAUSED), match ty... Write update_targeting_keywords Update targeting keywords in bulk — change status (ACTIVE/PAUSED) and/or bid amounts. Use to pause underper...

DESTRUCTIVE 5 tools

Destructive delete_ad Permanently delete an ad. This action CANNOT be undone. The ad group must have at least one remaining ad, o... Destructive delete_ad_group Permanently delete an ad group and all its keywords and ads. This action CANNOT be undone. Consider pausing... Destructive delete_campaign Permanently delete a campaign and all its child ad groups, keywords, and ads. This action CANNOT be undone.... Destructive delete_negative_keywords Permanently delete negative keywords in bulk. After deletion, ads may start showing for previously blocked ... Destructive delete_targeting_keywords Permanently delete targeting keywords from an ad group in bulk. This CANNOT be undone — the keyword and its...

// RUNNING THIS SERVER

The managed route: connect Apple Ads through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y apple-ads-mcp

// FAQ

How many tools does the Apple Ads MCP server have? +

The Apple Ads MCP server exposes 54 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Apple Ads tools? +

Route the Apple Ads server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Apple Ads tools fall into? +

Apple Ads tools are categorised as Read (34), Write (15), Destructive (5). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.