amazon_ads_mcp

Name: amazon_ads_mcp
Author: KuudoAI

KuudoAI

Get started Repository Website & docs

Amazon Ads MCP - Model Context Protocol server for Amazon Advertising API

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add amazon-ads --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>' --env HOSTNAME='<HOSTNAME>' --env MCP_CONNECTION_TIMEOUT='<MCP_CONNECTION_TIMEOUT>' --env MCP_REQUEST_TIMEOUT='<MCP_REQUEST_TIMEOUT>' --env MCP_REQUEST_WARNING_THRESHOLD='<MCP_REQUEST_WARNING_THRESHOLD>' --env MCP_SERVER_REQUEST_TIMEOUT='<MCP_SERVER_REQUEST_TIMEOUT>' -- uvx amazon-ads-mcp

~/.codex/config.toml

[mcp_servers.amazon-ads]
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>", HOSTNAME = "<HOSTNAME>", MCP_CONNECTION_TIMEOUT = "<MCP_CONNECTION_TIMEOUT>", MCP_REQUEST_TIMEOUT = "<MCP_REQUEST_TIMEOUT>", MCP_REQUEST_WARNING_THRESHOLD = "<MCP_REQUEST_WARNING_THRESHOLD>", MCP_SERVER_REQUEST_TIMEOUT = "<MCP_SERVER_REQUEST_TIMEOUT>" }

# codex mcp add amazon-ads --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>' --env HOSTNAME='<HOSTNAME>' --env MCP_CONNECTION_TIMEOUT='<MCP_CONNECTION_TIMEOUT>' --env MCP_REQUEST_TIMEOUT='<MCP_REQUEST_TIMEOUT>' --env MCP_REQUEST_WARNING_THRESHOLD='<MCP_REQUEST_WARNING_THRESHOLD>' --env MCP_SERVER_REQUEST_TIMEOUT='<MCP_SERVER_REQUEST_TIMEOUT>' -- uvx amazon-ads-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "amazon-ads": {
      "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>",
        "HOSTNAME": "<HOSTNAME>",
        "MCP_CONNECTION_TIMEOUT": "<MCP_CONNECTION_TIMEOUT>",
        "MCP_REQUEST_TIMEOUT": "<MCP_REQUEST_TIMEOUT>",
        "MCP_REQUEST_WARNING_THRESHOLD": "<MCP_REQUEST_WARNING_THRESHOLD>",
        "MCP_SERVER_REQUEST_TIMEOUT": "<MCP_SERVER_REQUEST_TIMEOUT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "amazon-ads": {
      "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>",
        "HOSTNAME": "<HOSTNAME>",
        "MCP_CONNECTION_TIMEOUT": "<MCP_CONNECTION_TIMEOUT>",
        "MCP_REQUEST_TIMEOUT": "<MCP_REQUEST_TIMEOUT>",
        "MCP_REQUEST_WARNING_THRESHOLD": "<MCP_REQUEST_WARNING_THRESHOLD>",
        "MCP_SERVER_REQUEST_TIMEOUT": "<MCP_SERVER_REQUEST_TIMEOUT>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "amazon-ads": {
      "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>",
        "HOSTNAME": "<HOSTNAME>",
        "MCP_CONNECTION_TIMEOUT": "<MCP_CONNECTION_TIMEOUT>",
        "MCP_REQUEST_TIMEOUT": "<MCP_REQUEST_TIMEOUT>",
        "MCP_REQUEST_WARNING_THRESHOLD": "<MCP_REQUEST_WARNING_THRESHOLD>",
        "MCP_SERVER_REQUEST_TIMEOUT": "<MCP_SERVER_REQUEST_TIMEOUT>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "amazon-ads": {
      "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>",
        "HOSTNAME": "<HOSTNAME>",
        "MCP_CONNECTION_TIMEOUT": "<MCP_CONNECTION_TIMEOUT>",
        "MCP_REQUEST_TIMEOUT": "<MCP_REQUEST_TIMEOUT>",
        "MCP_REQUEST_WARNING_THRESHOLD": "<MCP_REQUEST_WARNING_THRESHOLD>",
        "MCP_SERVER_REQUEST_TIMEOUT": "<MCP_SERVER_REQUEST_TIMEOUT>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "amazon-ads": {
      "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>",
        "HOSTNAME": "<HOSTNAME>",
        "MCP_CONNECTION_TIMEOUT": "<MCP_CONNECTION_TIMEOUT>",
        "MCP_REQUEST_TIMEOUT": "<MCP_REQUEST_TIMEOUT>",
        "MCP_REQUEST_WARNING_THRESHOLD": "<MCP_REQUEST_WARNING_THRESHOLD>",
        "MCP_SERVER_REQUEST_TIMEOUT": "<MCP_SERVER_REQUEST_TIMEOUT>"
      }
    }
  }
}

Environment variables

AMAZON_AD_API_CLIENT_SECRET
AMAZON_AD_API_REFRESH_TOKEN
OPENBRIDGE_REFRESH_TOKEN
OPENBRIDGE_API_KEY
AMAZON_ADS_DOWNLOAD_AUTH_TOKEN
HOSTNAME
MCP_CONNECTION_TIMEOUT
MCP_REQUEST_TIMEOUT
MCP_REQUEST_WARNING_THRESHOLD
MCP_SERVER_REQUEST_TIMEOUT

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related