Amazon Ads
Enables AI applications to interact with Amazon Advertising API through the Model Context Protocol. Supports campaign management, performance reporting, audience targeting, and comprehensive advertising operations across Amazon's advertising ecosyste
What is Amazon Ads?
Amazon Ads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai applications to interact with amazon advertising api through the model context protocol. supports campaign management, performance reporting, audience targeting, and comprehensive advertisi...
Enables AI applications to interact with Amazon Advertising API through the Model Context Protocol. Supports campaign management, performance reporting, audience targeting, and comprehensive advertising operations across Amazon's advertising ecosyste
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI applications to interact with Amazon Advertising
Use Cases
Maintainer
Works with
Installation
PIP
pip install amazon-ads-mcpManual Installation
pip install amazon-ads-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Amazon Ads
Amazon Ads API MCP is a comprehensive server that connects AI assistants to Amazon's full Advertising API ecosystem, exposing over 200 tools across Sponsored Products, Sponsored Brands, Sponsored Display, DSP, and Amazon Marketing Cloud. It enables campaign creation, performance reporting, audience targeting, and bulk exports through natural language, dramatically reducing the manual overhead of Amazon advertising management. The server runs as a local Docker container and connects to your MCP client over HTTP, supporting both direct OAuth and Openbridge partner authentication.
Prerequisites
- Docker installed and running (recommended) or Python 3.10+
- Amazon Ads API developer app with a registered client ID and client secret
- OAuth callback URL registered in Amazon's developer console (http://localhost:PORT/auth/callback)
- Active Amazon Advertising account with at least one advertiser profile
- An MCP client such as Claude Desktop
Clone the repository
Clone the amazon_ads_mcp repository and navigate into the project directory.
git clone https://github.com/KuudoAI/amazon_ads_mcp.git
cd amazon_ads_mcpCreate and configure your .env file
Copy the example env file and fill in your Amazon Ads API credentials. Set AUTH_METHOD to 'direct' for standard OAuth and list the API package modules you need.
cp .env.example .envSet required environment variables
Edit .env to add your credentials and the API packages you want enabled. Activate only the packages you need to minimize token usage.
AUTH_METHOD=direct
AMAZON_AD_API_CLIENT_ID=your_client_id
AMAZON_AD_API_CLIENT_SECRET=your_client_secret
AMAZON_AD_API_PACKAGES=profiles,accounts-ads-accounts,reporting-version-3,ads-api-v1-all
PORT=9080
CODE_MODE=true
ENABLE_TASKS=trueLaunch the server with Docker
Start the MCP server in the background using Docker Compose. The server will be accessible at http://localhost:9080/mcp/.
docker compose up -dConfigure your MCP client
Point your MCP client to the running HTTP server endpoint. For Claude Desktop, add the server URL in the MCP configuration.
{
"mcpServers": {
"amazon-ads": {
"url": "http://localhost:9080/mcp/"
}
}
}Authenticate via OAuth
On first use, the server will prompt you to complete the Amazon OAuth flow. Visit the provided URL in your browser to authorize access to your advertising accounts.
Amazon Ads Examples
Client configuration
Claude Desktop configuration connecting to the locally running Amazon Ads MCP server over HTTP.
{
"mcpServers": {
"amazon-ads": {
"url": "http://localhost:9080/mcp/"
}
}
}Prompts to try
Example prompts for managing Amazon advertising campaigns and generating performance reports.
- "List all my Amazon advertiser profiles"
- "Show me all enabled Sponsored Products campaigns"
- "Create a Sponsored Products report for last month's performance"
- "What is the total spend and ROAS for my campaigns this week?"
- "Create a new Sponsored Display campaign with a $500 daily budget"Troubleshooting Amazon Ads
OAuth callback fails or redirects to a non-working URL
Ensure http://localhost:PORT/auth/callback is registered as an allowed redirect URI in your Amazon Ads API developer console. The PORT must match the value in your .env file.
Tools are not appearing or context limit errors occur
Reduce the packages loaded via AMAZON_AD_API_PACKAGES to only what you need. Keep CODE_MODE=true to reduce tool metadata from ~32,000 tokens to ~470 tokens.
API returns region mismatch errors
Your advertiser profile determines the correct region (na/eu/fe). Use the set_active_region tool or check that your profile's marketplace matches the region configured.
Frequently Asked Questions about Amazon Ads
What is Amazon Ads?
Amazon Ads is a Model Context Protocol (MCP) server that enables ai applications to interact with amazon advertising api through the model context protocol. supports campaign management, performance reporting, audience targeting, and comprehensive advertising operations across amazon's advertising ecosyste It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Amazon Ads?
Install via pip with: pip install amazon-ads-mcp. Then configure your AI client to connect to this MCP server.
Which AI clients work with Amazon Ads?
Amazon Ads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Amazon Ads free to use?
Yes, Amazon Ads is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Amazon Ads Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Amazon Ads? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
TopRank
★ 2.6kGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Amazon Ads in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Amazon Ads?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.