Amazon Ads MCP
Amazon Ads API MCP server for Amazon Advertising API
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.2.4
- Listing updated
- 4 days ago
About Amazon Ads MCP
Amazon Ads MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add amazon_ads_mcp --env AMAZON_AD_API_CLIENT_SECRET='<AMAZON_AD_API_CLIENT_SECRET>' --env AMAZON_AD_API_REFRESH_TOKEN='<AMAZON_AD_API_REFRESH_TOKEN>' --env OPENBRIDGE_REFRESH_TOKEN='<OPENBRIDGE_REFRESH_TOKEN>' --env OPENBRIDGE_API_KEY='<OPENBRIDGE_API_KEY>' --env AMAZON_ADS_DOWNLOAD_AUTH_TOKEN='<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>' -- uvx amazon-ads-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"amazon_ads_mcp": {
"command": "uvx",
"args": [
"amazon-ads-mcp"
],
"env": {
"AMAZON_AD_API_CLIENT_SECRET": "<AMAZON_AD_API_CLIENT_SECRET>",
"AMAZON_AD_API_REFRESH_TOKEN": "<AMAZON_AD_API_REFRESH_TOKEN>",
"OPENBRIDGE_REFRESH_TOKEN": "<OPENBRIDGE_REFRESH_TOKEN>",
"OPENBRIDGE_API_KEY": "<OPENBRIDGE_API_KEY>",
"AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"amazon_ads_mcp": {
"command": "uvx",
"args": [
"amazon-ads-mcp"
],
"env": {
"AMAZON_AD_API_CLIENT_SECRET": "<AMAZON_AD_API_CLIENT_SECRET>",
"AMAZON_AD_API_REFRESH_TOKEN": "<AMAZON_AD_API_REFRESH_TOKEN>",
"OPENBRIDGE_REFRESH_TOKEN": "<OPENBRIDGE_REFRESH_TOKEN>",
"OPENBRIDGE_API_KEY": "<OPENBRIDGE_API_KEY>",
"AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"amazon_ads_mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"amazon-ads-mcp"
],
"env": {
"AMAZON_AD_API_CLIENT_SECRET": "<AMAZON_AD_API_CLIENT_SECRET>",
"AMAZON_AD_API_REFRESH_TOKEN": "<AMAZON_AD_API_REFRESH_TOKEN>",
"OPENBRIDGE_REFRESH_TOKEN": "<OPENBRIDGE_REFRESH_TOKEN>",
"OPENBRIDGE_API_KEY": "<OPENBRIDGE_API_KEY>",
"AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"amazon_ads_mcp": {
"command": "uvx",
"args": [
"amazon-ads-mcp"
],
"env": {
"AMAZON_AD_API_CLIENT_SECRET": "<AMAZON_AD_API_CLIENT_SECRET>",
"AMAZON_AD_API_REFRESH_TOKEN": "<AMAZON_AD_API_REFRESH_TOKEN>",
"OPENBRIDGE_REFRESH_TOKEN": "<OPENBRIDGE_REFRESH_TOKEN>",
"OPENBRIDGE_API_KEY": "<OPENBRIDGE_API_KEY>",
"AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"amazon_ads_mcp": {
"command": "uvx",
"args": [
"amazon-ads-mcp"
],
"env": {
"AMAZON_AD_API_CLIENT_SECRET": "<AMAZON_AD_API_CLIENT_SECRET>",
"AMAZON_AD_API_REFRESH_TOKEN": "<AMAZON_AD_API_REFRESH_TOKEN>",
"OPENBRIDGE_REFRESH_TOKEN": "<OPENBRIDGE_REFRESH_TOKEN>",
"OPENBRIDGE_API_KEY": "<OPENBRIDGE_API_KEY>",
"AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
}
}
}
}Configuration
AMAZON_ADS_AUTH_METHODAuthentication method: direct or openbridge.AMAZON_AD_API_CLIENT_IDAmazon Ads API client ID for direct auth.AMAZON_AD_API_CLIENT_SECRETAmazon Ads API client secret for direct auth.AMAZON_AD_API_REFRESH_TOKENAmazon Ads API refresh token for direct auth.AMAZON_AD_API_PROFILE_IDAmazon Ads profile ID for direct auth.OPENBRIDGE_REFRESH_TOKENOpenbridge refresh token (API key).OPENBRIDGE_API_KEYOpenbridge API key (alias for OPENBRIDGE_REFRESH_TOKEN).OPENBRIDGE_REMOTE_IDENTITY_IDOpenbridge remote identity ID.AMAZON_ADS_REGIONAmazon Ads API region (na/eu/fe).AMAZON_AD_API_PACKAGESComma-separated API packages to load.AMAZON_ADS_DOWNLOAD_AUTH_TOKENOptional bearer token to protect download routes.
Pricing
Open source
Amazon Ads MCP FAQ
Is Amazon Ads MCP free?
Yes. Amazon Ads MCP is open source, so you can use and self-host it for free.
How do I add Amazon Ads MCP to Claude Code?
Run this command in your terminal: claude mcp add amazon_ads_mcp --env AMAZON_AD_API_CLIENT_SECRET='<AMAZON_AD_API_CLIENT_SECRET>' --env AMAZON_AD_API_REFRESH_TOKEN='<AMAZON_AD_API_REFRESH_TOKEN>' --env OPENBRIDGE_REFRESH_TOKEN='<OPENBRIDGE_REFRESH_TOKEN>' --env OPENBRIDGE_API_KEY='<OPENBRIDGE_API_KEY>' --env AMAZON_ADS_DOWNLOAD_AUTH_TOKEN='<AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>' -- uvx amazon-ads-mcp