What credentials do I need to set up this MCP server?

You need four required credentials from Apple Search Ads: ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, and a path to your PKCS#8 private key file (ASA_PRIVATE_KEY_PATH). Optionally, provide ASA_ORG_ID to specify an organization, or use list_organizations to switch at runtime.

Can I manage multiple Apple Search Ads accounts with one server instance?

The server uses a single set of credentials per instance. To manage multiple accounts, you would need separate server instances with different credential sets, or use the optional ASA_ORG_ID to switch organizations at runtime if your credentials have access to multiple orgs.

What Apple Search Ads operations does this server support?

This server supports managing campaigns, keywords, budgets, and retrieving performance reports via Apple Search Ads API v5. Specific operations depend on the API endpoints exposed by the server implementation.

How do I generate the PKCS#8 private key required for authentication?

You must generate a PKCS#8 private key through Apple Search Ads' credential management interface and store it as a file. The ASA_PRIVATE_KEY_PATH environment variable should point to the absolute path of this key file.

Is there a way to test my credentials before running campaigns?

After setting up your environment variables, you can use the list_organizations function to verify your credentials are valid and see which organizations you have access to manage.

MCP ServerSTDIOOfficialv1.0.3

Happygallo Apple Ads MCP Server

Manage Apple Search Ads campaigns, keywords, budgets, and performance reports directly via the Apple Search Ads API v5. Built for developers automating ad operations and analytics workflows.

io.github.Happygallo/apple-ads

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

4 required env vars

What the Happygallo Apple Ads MCP server does

How models use it and what it is built for.

Manage Apple Search Ads campaigns, keywords, budgets, and performance reports directly via the Apple Search Ads API v5. Built for developers automating ad operations and analytics workflows.

Connect to Happygallo Apple Ads

Local install — runs as a subprocess.

npx apple-ads-mcp@1.0.3

Environment variables

Configuration this server reads at startup.

ASA_CLIENT_IDRequired
Apple Search Ads client ID (starts with SEARCHADS.)
ASA_TEAM_IDRequired
Apple Search Ads team ID (starts with SEARCHADS.)
ASA_KEY_IDRequired
Apple Search Ads key ID (UUID)
ASA_PRIVATE_KEY_PATHRequired
Absolute path to your PKCS#8 private key file
ASA_ORG_ID
Organization ID (optional, use list_organizations to switch at runtime)

Resources

Where to find authoritative docs and source for Happygallo Apple Ads.

Source repository

Example prompts for Happygallo Apple Ads

Paste any of these into Agent Studio after connecting Happygallo Apple Ads.

List all active campaigns and their current daily budgets
Create a new keyword with bid amount 2.50 for campaign ID 12345
Fetch performance report for campaign 12345 for the last 30 days
Update campaign budget to 500 USD and pause low-performing keywords

Happygallo Apple Ads MCP server — FAQ

Common questions about connecting and running Happygallo Apple Ads.

What credentials do I need to set up this MCP server?
You need four required credentials from Apple Search Ads: ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, and a path to your PKCS#8 private key file (ASA_PRIVATE_KEY_PATH). Optionally, provide ASA_ORG_ID to specify an organization, or use list_organizations to switch at runtime.
Can I manage multiple Apple Search Ads accounts with one server instance?
The server uses a single set of credentials per instance. To manage multiple accounts, you would need separate server instances with different credential sets, or use the optional ASA_ORG_ID to switch organizations at runtime if your credentials have access to multiple orgs.
What Apple Search Ads operations does this server support?
This server supports managing campaigns, keywords, budgets, and retrieving performance reports via Apple Search Ads API v5. Specific operations depend on the API endpoints exposed by the server implementation.
How do I generate the PKCS#8 private key required for authentication?
You must generate a PKCS#8 private key through Apple Search Ads' credential management interface and store it as a file. The ASA_PRIVATE_KEY_PATH environment variable should point to the absolute path of this key file.
Is there a way to test my credentials before running campaigns?
After setting up your environment variables, you can use the list_organizations function to verify your credentials are valid and see which organizations you have access to manage.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio

Related servers

Judges Panel

45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.

Addozhang Nexus

Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts

Cyanheads MCP Ts Template

TypeScript template for building MCP servers with declarative tooling, observability, and auth.

Chernistry Bernstein

Declarative agent orchestration for engineering teams