Amazon Ads MCP Server

by kuudoaiio.github.KuudoAI/amazon_ads_mcpv0.3.30

Amazon Ads API MCP server for Amazon Advertising API

72Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained32d ago

Install Amazon Ads MCP server

claude mcp add amazon-ads-kuudoai -e AMAZON_AD_API_CLIENT_SECRET='<amazon-ad-api-client-secret>' -e AMAZON_AD_API_REFRESH_TOKEN='<amazon-ad-api-refresh-token>' -e OPENBRIDGE_REFRESH_TOKEN='<openbridge-refresh-token>' -e OPENBRIDGE_API_KEY='<openbridge-api-key>' -e AMAZON_ADS_DOWNLOAD_AUTH_TOKEN='<amazon-ads-download-auth-token>' -- uvx amazon-ads-mcp

{
  "mcpServers": {
    "amazon-ads-kuudoai": {
      "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "amazon-ads-kuudoai": {
      "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "amazon-ads-kuudoai": {
      "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "amazon-ads-kuudoai": {
      "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.

Configuration

Variable	Required	Secret	Description
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	—	yes	Amazon Ads API client secret for direct auth.
AMAZON_AD_API_REFRESH_TOKEN	—	yes	Amazon Ads API refresh token for direct auth.
AMAZON_AD_API_PROFILE_ID	—	—	Amazon Ads profile ID for direct auth.
OPENBRIDGE_REFRESH_TOKEN	—	yes	Openbridge refresh token (API key).
OPENBRIDGE_API_KEY	—	yes	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	—	yes	Optional bearer token to protect download routes.

Remote endpoints

streamable-httphttps://{HOSTNAME}/mcp

Freshness

Maintained — last maintenance signal 32d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-06 · 32d ago · GitHub
Latest release
2026-09-06 · 32d ago · GitHub · v0.3.30
Package published
no data · npm/PyPI
Registry entry updated
2026-09-06 · 32d ago · official registry · v0.3.30

FAQ

›How do I install the Amazon Ads MCP server in Claude Code?

Run: claude mcp add amazon-ads-kuudoai -e AMAZON_AD_API_CLIENT_SECRET='<amazon-ad-api-client-secret>' -e AMAZON_AD_API_REFRESH_TOKEN='<amazon-ad-api-refresh-token>' -e OPENBRIDGE_REFRESH_TOKEN='<openbridge-refresh-token>' -e OPENBRIDGE_API_KEY='<openbridge-api-key>' -e AMAZON_ADS_DOWNLOAD_AUTH_TOKEN='<amazon-ads-download-auth-token>' -- uvx amazon-ads-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Amazon Ads require an API key?

Yes. It expects AMAZON_AD_API_CLIENT_SECRET, AMAZON_AD_API_REFRESH_TOKEN, OPENBRIDGE_REFRESH_TOKEN, OPENBRIDGE_API_KEY, AMAZON_ADS_DOWNLOAD_AUTH_TOKEN, of which 5 are secrets.

›Can I use Amazon Ads as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Amazon Ads in the official MCP registry?

Yes, as io.github.KuudoAI/amazon_ads_mcp.