Amazon Ads — Claude Code MCP server: what it does, how to install
Connects your MCP assistant directly to the Amazon Ads API. Pulls performance reports, checks campaign setups, and safely stages changes.
claude mcp add amazon-ads -e AMAZON_ADS_CLIENT_ID=<AMAZON_ADS_CLIENT_ID> -e AMAZON_ADS_CLIENT_SECRET=<AMAZON_ADS_CLIENT_SECRET> -e AMAZON_ADS_REFRESH_TOKEN=<AMAZON_ADS_REFRESH_TOKEN> -e AMAZON_ADS_REGION=<AMAZON_ADS_REGION> -e AMAZON_ADS_PROFILE_IDS=<AMAZON_ADS_PROFILE_IDS> -- npx -y @getmcpads/amazon-ads-mcp-serverWhat Amazon Ads does
The server links your client to Sponsored Products and Sponsored Brands data. It provides 31 read tools covering Reporting v3, creative asset libraries, and product metadata. Calls travel directly to regional Amazon endpoints via standard I/O.
Modifying ad resources requires setting AMAZON_ADS_ENABLE_WRITES=true. By default, all 77 mutation tools remain locked. When active, new campaigns and ads are initialized in a paused state, verifying each payload against Amazon contracts before confirmation.
Credentials stay protected in memory. Access tokens refresh automatically and never touch persistent storage. Running the server requires Node.js 22.23.4, 24.22.1, 26.12.1, or higher.
What it helps with
- inspect Sponsored Products campaign configurations
- retrieve advertising metrics using Reporting v3
- filter accounts strictly by
AMAZON_ADS_PROFILE_IDS - draft paused campaign and bid updates before applying
Example prompts for the agent
- List my configured Amazon Ads profiles
- Pull the last week of performance metrics for Sponsored Display campaigns
- Check current ad groups and product metadata for my active brand
How to install Amazon Ads
Platform CLI
claude mcp add amazon-ads -e AMAZON_ADS_CLIENT_ID=<AMAZON_ADS_CLIENT_ID> -e AMAZON_ADS_CLIENT_SECRET=<AMAZON_ADS_CLIENT_SECRET> -e AMAZON_ADS_REFRESH_TOKEN=<AMAZON_ADS_REFRESH_TOKEN> -e AMAZON_ADS_REGION=<AMAZON_ADS_REGION> -e AMAZON_ADS_PROFILE_IDS=<AMAZON_ADS_PROFILE_IDS> -- npx -y @getmcpads/amazon-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add get-mcp-ads-amazon-ads --env AMAZON_ADS_CLIENT_ID=<AMAZON_ADS_CLIENT_ID> --env AMAZON_ADS_CLIENT_SECRET=<AMAZON_ADS_CLIENT_SECRET> --env AMAZON_ADS_REFRESH_TOKEN=<AMAZON_ADS_REFRESH_TOKEN> --env AMAZON_ADS_REGION=<AMAZON_ADS_REGION> --env AMAZON_ADS_PROFILE_IDS=<AMAZON_ADS_PROFILE_IDS> -- npx -y @getmcpads/amazon-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"get-mcp-ads-amazon-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/amazon-ads-mcp-server"
],
"env": {
"AMAZON_ADS_CLIENT_ID": "<AMAZON_ADS_CLIENT_ID>",
"AMAZON_ADS_CLIENT_SECRET": "<AMAZON_ADS_CLIENT_SECRET>",
"AMAZON_ADS_REFRESH_TOKEN": "<AMAZON_ADS_REFRESH_TOKEN>",
"AMAZON_ADS_REGION": "<AMAZON_ADS_REGION>",
"AMAZON_ADS_PROFILE_IDS": "<AMAZON_ADS_PROFILE_IDS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"get-mcp-ads-amazon-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/amazon-ads-mcp-server"
],
"env": {
"AMAZON_ADS_CLIENT_ID": "<AMAZON_ADS_CLIENT_ID>",
"AMAZON_ADS_CLIENT_SECRET": "<AMAZON_ADS_CLIENT_SECRET>",
"AMAZON_ADS_REFRESH_TOKEN": "<AMAZON_ADS_REFRESH_TOKEN>",
"AMAZON_ADS_REGION": "<AMAZON_ADS_REGION>",
"AMAZON_ADS_PROFILE_IDS": "<AMAZON_ADS_PROFILE_IDS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e AMAZON_ADS_CLIENT_ID=<AMAZON_ADS_CLIENT_ID> -e AMAZON_ADS_CLIENT_SECRET=<AMAZON_ADS_CLIENT_SECRET> -e AMAZON_ADS_REFRESH_TOKEN=<AMAZON_ADS_REFRESH_TOKEN> -e AMAZON_ADS_REGION=<AMAZON_ADS_REGION> -e AMAZON_ADS_PROFILE_IDS=<AMAZON_ADS_PROFILE_IDS> get-mcp-ads-amazon-ads npx -y @getmcpads/amazon-ads-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Amazon Ads
How to install Amazon Ads in Claude Code?
Run `claude mcp add amazon-ads -e AMAZON_ADS_CLIENT_ID=<AMAZON_ADS_CLIENT_ID> -e AMAZON_ADS_CLIENT_SECRET=<AMAZON_ADS_CLIENT_SECRET> -e AMAZON_ADS_REFRESH_TOKEN=<AMAZON_ADS_REFRESH_TOKEN> -e AMAZON_ADS_REGION=<AMAZON_ADS_REGION> -e AMAZON_ADS_PROFILE_IDS=<AMAZON_ADS_PROFILE_IDS> -- npx -y @getmcpads/amazon-ads-mcp-server`.
What does the Amazon Ads MCP server do?
It connects AI clients to the Amazon advertising platform for reviewing metrics, auditing assets, and staging campaign updates.
How do I enable write operations for ad accounts?
Set the AMAZON_ADS_ENABLE_WRITES environment variable to true. Without this exact value, write tools remain completely disabled.
