> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Search Ads MCP Tools

> Use MCP tools to inspect and manage Apple Search Ads campaigns from an assistant

Apple Search Ads REST capabilities are also available as MCP tools. After connecting Search Ads credentials, the assistant only needs your Appeeky API key.

All tools are available on the [Appeeky MCP Server](/docs/mcp).

***

## Connection and Account

| Tool                     | Description                                     |
| ------------------------ | ----------------------------------------------- |
| `asa_credentials_status` | Whether Search Ads is connected on your account |
| `asa_list_campaigns`     | List campaigns in your org                      |
| `asa_list_adgroups`      | List ad groups for a campaign                   |

***

## Campaign and Ad Group Updates

| Tool                  | Description                                           |
| --------------------- | ----------------------------------------------------- |
| `asa_update_campaign` | Enable/pause campaign, rename, or update daily budget |
| `asa_update_adgroup`  | Enable/pause ad group, rename, or update default bid  |

***

## Targeting Keywords

| Tool                                    | Description                               |
| --------------------------------------- | ----------------------------------------- |
| `asa_list_targeting_keywords`           | List targeting keywords in an ad group    |
| `asa_get_targeting_keyword`             | Get one targeting keyword by ID           |
| `asa_find_targeting_keywords`           | Find targeting keywords across a campaign |
| `asa_create_targeting_keywords`         | Bulk-create targeting keywords            |
| `asa_update_targeting_keywords`         | Bulk-update keyword bid or status         |
| `asa_delete_targeting_keywords`         | Delete targeting keywords                 |
| `asa_targeting_keyword_recommendations` | Apple keyword suggestions                 |
| `asa_bid_recommendations`               | Suggested bids for keyword texts          |

***

## Negative Keywords

| Tool                                    | Description                           |
| --------------------------------------- | ------------------------------------- |
| `asa_list_campaign_negative_keywords`   | List campaign-level negative keywords |
| `asa_find_campaign_negative_keywords`   | Find campaign negative keywords       |
| `asa_create_campaign_negative_keywords` | Create campaign negative keywords     |
| `asa_update_campaign_negative_keywords` | Update campaign negative keywords     |
| `asa_delete_campaign_negative_keywords` | Delete campaign negative keywords     |
| `asa_list_adgroup_negative_keywords`    | List ad group negative keywords       |
| `asa_find_adgroup_negative_keywords`    | Find ad group negative keywords       |
| `asa_create_adgroup_negative_keywords`  | Create ad group negative keywords     |
| `asa_update_adgroup_negative_keywords`  | Update ad group negative keywords     |
| `asa_delete_adgroup_negative_keywords`  | Delete ad group negative keywords     |

***

## Reports

| Tool                      | Description                                 |
| ------------------------- | ------------------------------------------- |
| `asa_report_keywords`     | Keyword-level performance for a date range  |
| `asa_report_search_terms` | Real search queries that triggered your ads |

***

## ROAS and Attribution

| Tool                            | Description                                                                                      |
| ------------------------------- | ------------------------------------------------------------------------------------------------ |
| `asa_profitability`             | Join spend with RevenueCat revenue, profit, and ROAS. Optional `country` filter.                 |
| `asa_playbook_status`           | Check whether RevenueCat, Apple Search Ads, and attribution are ready                            |
| `asa_admaxxing_recommendations` | Optimization bundle: setup gaps, scale/pause candidates, attribution sample, review country gate |
| `asa_review_country_gate`       | Flag countries with active campaigns but low App Store ratings                                   |

RevenueCat attribution tools (`rc_attribution_summary`, `rc_customer_attributes`) are documented in [RevenueCat Attribution](/docs/revenuecat-attribution).

See [ROAS Workflow](/docs/apple-search-ads-roas-workflow) for REST equivalents and response shapes.

***

## Example Prompts

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Check if my Apple Search Ads account is connected.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
List my Search Ads campaigns and show the top 10 search terms
by impressions for campaign 2143596801 in the last 30 days.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
For campaign 2143596801, which keywords have the highest install
rate but rising CPC? Suggest 5 organic ASO keywords to test based
on the search terms report.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
List targeting keywords for ad group 2147258884 in campaign 2143596801,
then update the bid on keyword 2251741048 to 0.60 USD.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Add negative keyword "free" as BROAD match at campaign level for campaign 2143596801.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Compare my Search Ads keyword spend last month with my App Store
Connect downloads. Are paid and organic moving together?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Is my Apple Search Ads and RevenueCat setup ready for ROAS analysis?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Which keywords should I scale or pause? Use my app ID 123456789
and check countries below 4.5 stars where I'm still spending.
```

***

## Per-Call Credentials

Stored credentials are recommended. For one-off tool calls, the assistant can pass:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
client_id
team_id
key_id
org_id
private_key
```

For setup details, see [Credentials & Setup](/docs/apple-search-ads-credentials).