io.github.tspicer/amazon_ads_mcp MCP Server

Name: io.github.tspicer/amazon_ads_mcp MCP Server
Author: io.github.tspicer

io.github.tspicer/amazon_ads_mcp

Repository Registry

What is the io.github.tspicer/amazon_ads_mcp MCP server?

Amazon Ads API MCP server for Amazon Advertising API

How to install io.github.tspicer/amazon_ads_mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AMAZON_ADS_AUTH_METHOD
Authentication method: direct or openbridge.
AMAZON_AD_API_CLIENT_ID
Amazon Ads API client ID for direct auth.
AMAZON_AD_API_CLIENT_SECRET
secret
Amazon Ads API client secret for direct auth.
AMAZON_AD_API_REFRESH_TOKEN
secret
Amazon Ads API refresh token for direct auth.
AMAZON_AD_API_PROFILE_ID
Amazon Ads profile ID for direct auth.
OPENBRIDGE_REFRESH_TOKEN
secret
Openbridge refresh token (API key).
OPENBRIDGE_API_KEY
secret
Openbridge API key (alias for OPENBRIDGE_REFRESH_TOKEN).
OPENBRIDGE_REMOTE_IDENTITY_ID
Openbridge remote identity ID.
AMAZON_ADS_REGION
Amazon Ads API region (na/eu/fe).
AMAZON_AD_API_PACKAGES
Comma-separated API packages to load.
AMAZON_ADS_DOWNLOAD_AUTH_TOKEN
secret
Optional bearer token to protect download routes.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "uvx",
      "args": [
        "amazon-ads-mcp"
      ],
      "env": {
        "AMAZON_ADS_AUTH_METHOD": "<YOUR_AMAZON_ADS_AUTH_METHOD>",
        "AMAZON_AD_API_CLIENT_ID": "<YOUR_AMAZON_AD_API_CLIENT_ID>",
        "AMAZON_AD_API_CLIENT_SECRET": "<YOUR_AMAZON_AD_API_CLIENT_SECRET>",
        "AMAZON_AD_API_REFRESH_TOKEN": "<YOUR_AMAZON_AD_API_REFRESH_TOKEN>",
        "AMAZON_AD_API_PROFILE_ID": "<YOUR_AMAZON_AD_API_PROFILE_ID>",
        "OPENBRIDGE_REFRESH_TOKEN": "<YOUR_OPENBRIDGE_REFRESH_TOKEN>",
        "OPENBRIDGE_API_KEY": "<YOUR_OPENBRIDGE_API_KEY>",
        "OPENBRIDGE_REMOTE_IDENTITY_ID": "<YOUR_OPENBRIDGE_REMOTE_IDENTITY_ID>",
        "AMAZON_ADS_REGION": "<YOUR_AMAZON_ADS_REGION>",
        "AMAZON_AD_API_PACKAGES": "<YOUR_AMAZON_AD_API_PACKAGES>",
        "AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<YOUR_AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "uvx",
      "args": [
        "amazon-ads-mcp"
      ],
      "env": {
        "AMAZON_ADS_AUTH_METHOD": "<YOUR_AMAZON_ADS_AUTH_METHOD>",
        "AMAZON_AD_API_CLIENT_ID": "<YOUR_AMAZON_AD_API_CLIENT_ID>",
        "AMAZON_AD_API_CLIENT_SECRET": "<YOUR_AMAZON_AD_API_CLIENT_SECRET>",
        "AMAZON_AD_API_REFRESH_TOKEN": "<YOUR_AMAZON_AD_API_REFRESH_TOKEN>",
        "AMAZON_AD_API_PROFILE_ID": "<YOUR_AMAZON_AD_API_PROFILE_ID>",
        "OPENBRIDGE_REFRESH_TOKEN": "<YOUR_OPENBRIDGE_REFRESH_TOKEN>",
        "OPENBRIDGE_API_KEY": "<YOUR_OPENBRIDGE_API_KEY>",
        "OPENBRIDGE_REMOTE_IDENTITY_ID": "<YOUR_OPENBRIDGE_REMOTE_IDENTITY_ID>",
        "AMAZON_ADS_REGION": "<YOUR_AMAZON_ADS_REGION>",
        "AMAZON_AD_API_PACKAGES": "<YOUR_AMAZON_AD_API_PACKAGES>",
        "AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<YOUR_AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "amazon_ads_mcp": {
      "command": "uvx",
      "args": [
        "amazon-ads-mcp"
      ],
      "env": {
        "AMAZON_ADS_AUTH_METHOD": "<YOUR_AMAZON_ADS_AUTH_METHOD>",
        "AMAZON_AD_API_CLIENT_ID": "<YOUR_AMAZON_AD_API_CLIENT_ID>",
        "AMAZON_AD_API_CLIENT_SECRET": "<YOUR_AMAZON_AD_API_CLIENT_SECRET>",
        "AMAZON_AD_API_REFRESH_TOKEN": "<YOUR_AMAZON_AD_API_REFRESH_TOKEN>",
        "AMAZON_AD_API_PROFILE_ID": "<YOUR_AMAZON_AD_API_PROFILE_ID>",
        "OPENBRIDGE_REFRESH_TOKEN": "<YOUR_OPENBRIDGE_REFRESH_TOKEN>",
        "OPENBRIDGE_API_KEY": "<YOUR_OPENBRIDGE_API_KEY>",
        "OPENBRIDGE_REMOTE_IDENTITY_ID": "<YOUR_OPENBRIDGE_REMOTE_IDENTITY_ID>",
        "AMAZON_ADS_REGION": "<YOUR_AMAZON_ADS_REGION>",
        "AMAZON_AD_API_PACKAGES": "<YOUR_AMAZON_AD_API_PACKAGES>",
        "AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<YOUR_AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "amazon_ads_mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "amazon-ads-mcp"
      ],
      "env": {
        "AMAZON_ADS_AUTH_METHOD": "<YOUR_AMAZON_ADS_AUTH_METHOD>",
        "AMAZON_AD_API_CLIENT_ID": "<YOUR_AMAZON_AD_API_CLIENT_ID>",
        "AMAZON_AD_API_CLIENT_SECRET": "<YOUR_AMAZON_AD_API_CLIENT_SECRET>",
        "AMAZON_AD_API_REFRESH_TOKEN": "<YOUR_AMAZON_AD_API_REFRESH_TOKEN>",
        "AMAZON_AD_API_PROFILE_ID": "<YOUR_AMAZON_AD_API_PROFILE_ID>",
        "OPENBRIDGE_REFRESH_TOKEN": "<YOUR_OPENBRIDGE_REFRESH_TOKEN>",
        "OPENBRIDGE_API_KEY": "<YOUR_OPENBRIDGE_API_KEY>",
        "OPENBRIDGE_REMOTE_IDENTITY_ID": "<YOUR_OPENBRIDGE_REMOTE_IDENTITY_ID>",
        "AMAZON_ADS_REGION": "<YOUR_AMAZON_ADS_REGION>",
        "AMAZON_AD_API_PACKAGES": "<YOUR_AMAZON_AD_API_PACKAGES>",
        "AMAZON_ADS_DOWNLOAD_AUTH_TOKEN": "<YOUR_AMAZON_ADS_DOWNLOAD_AUTH_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add amazon_ads_mcp --env AMAZON_ADS_AUTH_METHOD=<YOUR_AMAZON_ADS_AUTH_METHOD> --env AMAZON_AD_API_CLIENT_ID=<YOUR_AMAZON_AD_API_CLIENT_ID> --env AMAZON_AD_API_CLIENT_SECRET=<YOUR_AMAZON_AD_API_CLIENT_SECRET> --env AMAZON_AD_API_REFRESH_TOKEN=<YOUR_AMAZON_AD_API_REFRESH_TOKEN> --env AMAZON_AD_API_PROFILE_ID=<YOUR_AMAZON_AD_API_PROFILE_ID> --env OPENBRIDGE_REFRESH_TOKEN=<YOUR_OPENBRIDGE_REFRESH_TOKEN> --env OPENBRIDGE_API_KEY=<YOUR_OPENBRIDGE_API_KEY> --env OPENBRIDGE_REMOTE_IDENTITY_ID=<YOUR_OPENBRIDGE_REMOTE_IDENTITY_ID> --env AMAZON_ADS_REGION=<YOUR_AMAZON_ADS_REGION> --env AMAZON_AD_API_PACKAGES=<YOUR_AMAZON_AD_API_PACKAGES> --env AMAZON_ADS_DOWNLOAD_AUTH_TOKEN=<YOUR_AMAZON_ADS_DOWNLOAD_AUTH_TOKEN> -- uvx amazon-ads-mcp