kuudoai avatar

Amazon Ads Mcp

kuudoai/amazon_ads_mcp

Connects Claude to the Amazon Advertising API for campaign management, reporting, DSP, and AMC workflows across NA, EU, and FE regions. The implementation focuses on error handling that teaches rather than just fails. When you hit a wrong field name or malformed request, the server returns corrective hints instead of cryptic API errors, collapsing five-round-trip debugging loops into directed retries. Built by Openbridge with full Pydantic types, multi-region routing, and coverage of both legacy v1 and current v3 reporting endpoints. Runs via Docker or stdio transport. Useful when you need an agent to manipulate Amazon ad accounts without burning context on API vocabulary mismatches and migration-era inconsistencies.

GitHub stars
49
tools
15
auth
Secret needed
transport
STDIO
env vars
11
last updated
Feb 3, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

cm_QueryCampaignQuery campaigns

Query campaigns

No parameter schema in public metadata yet.

cm_CreateCampaignCreate campaign

Create campaign

No parameter schema in public metadata yet.

cm_UpdateCampaignUpdate campaign

Update campaign

No parameter schema in public metadata yet.

cm_DeleteCampaignDelete campaign

Delete campaign

No parameter schema in public metadata yet.

cm_QueryAdGroupQuery ad groups

Query ad groups

No parameter schema in public metadata yet.

sp_listProductAdsList product ads

List product ads

No parameter schema in public metadata yet.

sp_createKeywordsCreate keywords

Create keywords

No parameter schema in public metadata yet.

sp_updateBidsUpdate keyword bids

Update keyword bids

No parameter schema in public metadata yet.

sp_getNegativeKeywordsGet negative keywords

Get negative keywords

No parameter schema in public metadata yet.

amc_listWorkflowsList AMC workflows

List AMC workflows

No parameter schema in public metadata yet.

amc_executeWorkflowRun workflow

Run workflow

No parameter schema in public metadata yet.

amc_getWorkflowStatusCheck workflow status

Check workflow status

No parameter schema in public metadata yet.

download_exportDownloads a completed export or report file from Amazon S3 to local storage

Downloads a completed export or report file from Amazon S3 to local storage

No parameter schema in public metadata yet.

list_downloadsLists all downloaded files for the active profile

Lists all downloaded files for the active profile

No parameter schema in public metadata yet.

get_download_urlReturns an HTTP URL to fetch a downloaded file

Returns an HTTP URL to fetch a downloaded file

No parameter schema in public metadata yet.

Sponsors

Configuration

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_SECRETsecret

Amazon Ads API client secret for direct auth.

AMAZON_AD_API_REFRESH_TOKENsecret

Amazon Ads API refresh token for direct auth.

AMAZON_AD_API_PROFILE_ID

Amazon Ads profile ID for direct auth.

OPENBRIDGE_REFRESH_TOKENsecret

Openbridge refresh token (API key).

OPENBRIDGE_API_KEYsecret

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_TOKENsecret

Optional bearer token to protect download routes.

Readme

Kuudo Amazon Ads MCP Server

The open-source Amazon Ads MCP server from Kuudo, also published as the Amazon Ads API MCP SDK

Made with ❤️ + ☕ by Kuudo, an Openbridge company

Python 3.10+ License: MIT CI

MCP registry id (for clients and catalogs that display a stable package name): io.github.KuudoAI/amazon_ads_mcp

Kuudo's Amazon Ads MCP server gives Claude, ChatGPT, Cursor and any MCP client 711 Amazon Ads API operations across 53 services: Sponsored Products, Sponsored Brands, Sponsored Display, Sponsored TV, Amazon DSP and Amazon Marketing Cloud, with read and write tools. It is MIT-licensed. Run it yourself, or have Kuudo run it in your own AWS, Google Cloud, Azure or Cloudflare account.


View the full README on GitHub

Details

Repository
github.com/kuudoai/amazon_ads_mcp
Category
Finance & Commerce
Package
amazon-ads-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from kuudoai

Related Finance & Commerce MCP servers

View all
1nirholas avatarEthereum Wallet Generatornirholas/ethereum-wallet-toolkitGenerate Ethereum wallets with BIP39 mnemonics, HD paths, vanity addresses, private key backup0stars
2synter-media-ai avatarSynter Adssynter-media-ai/mcp-serverRun ads across 16 ad platforms from any MCP client. Hosted OAuth at mcp.synterai.com.0stars
3adkit avatarAds Manager by AdKit: Google Ads, Meta Ads, TikTok Ads, LinkedIn Adsadkit/ads-mcpPPC advertising on Google Ads, Meta Ads (Facebook Ads), TikTok Ads, LinkedIn Ads, Reddit Ads & more.20stars
4laf-rge avatarQuickbooks Mcplaf-rge/quickbooks-mcpMCP server for QuickBooks Online API integration14stars
5kylastech avatarKylas CRMkylastech/kylas-crm-mcp-serverMCP server for Kylas CRM: create, search, and manage leads. Requires KYLAS_API_KEY.11stars
6hasdata avatarHasData Shopifyhasdata/shopify-mcpThe public product catalogue and collections of any Shopify storefront, as structured JSON.5stars