home / mcp / amazon ads mcp server

Amazon Ads MCP Server

Provides a scalable MCP server to interact with the Amazon Ads API using a structured, safe toolset.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kuudoai-amazon_ads_mcp": {
      "url": "http://localhost:9080/mcp/",
      "headers": {
        "AUTH_METHOD": "direct",
        "OPENBRIDGE_API_KEY": "YOUR_OPENBRIDGE_TOKEN",
        "AMAZON_AD_API_PACKAGES": "profiles,amc-workflow",
        "AMAZON_AD_API_CLIENT_ID": "your-client-id",
        "AMAZON_AD_API_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

You can build AI-powered advertising tools that securely interact with the Amazon Ads API using the Amazon Ads MCP SDK. This server enables you to expose API endpoints and tooling as MCP-enabled services, allowing your AI clients to call, manage, and analyze campaigns, reports, and other advertising data through a safe, well-labeled toolkit.

How to use

Set up the MCP server and connect your AI client to interact with Amazon Ads data. You can run the server in a container and configure your MCP client to load the server as a remote tool provider. Start with a simple connection, then enable additional tool packages as needed. Use the provided tools to list campaigns, create or update campaigns, manage budgets, run AMC workflows, retrieve reports, and more. When you enable tools, the MCP context will include structured metadata that guides your AI client in making valid API calls.

How to install

Prerequisites: you need Docker and Docker Compose installed on your machine. You also need a suitable MCP client (for example, a compatible AI assistant) to load and use the MCP server.

1) Pull the MCP server image.

docker pull openbridge/amazon-ads-mcp

2) Copy the environment template and configure your settings.

cp .env.example .env

3) Start the server with Docker Compose.

docker-compose up -d

4) Verify the server is running and accessible.

docker-compose ps

5) Check logs if you encounter issues.

docker-compose logs -f

Available tools

cp_listCampaigns

List all campaigns for the active advertiser profile and region.

cp_getCampaign

Retrieve details for a specific campaign by its ID.

cp_createCampaign

Create a new advertising campaign with the specified parameters.

cp_updateCampaign

Update attributes of an existing campaign.

cp_archiveCampaign

Archive a campaign to stop its active delivery.

sp_listProductAds

List Sponsored Products ads for the active profile.

sp_createKeywords

Create keywords for Sponsored Products campaigns.

sp_updateBids

Update keyword bids for Sponsored Products campaigns.

sp_getNegativeKeywords

Retrieve negative keywords for campaigns.

amc_listWorkflows

List AMC workflows available for the active account.

amc_executeWorkflow

Execute a specified AMC workflow.

amc_getWorkflowStatus

Check the status of an AMC workflow execution.

export_createAdExport

Create and export campaign data for download.

ac_listProfiles

List advertiser profiles accessible by the current identity.

rp_generateReport

Generate a V3 style reporting export for campaigns or accounts.