Amazon Ads MCP Server (read + write)

An MCP server for the Amazon Ads API. Use it from Claude, ChatGPT, Cursor, Codex or any MCP client to report on and manage Sponsored Products, Sponsored Brands and Sponsored Display campaigns, keywords, targets, bids and budgets, run performance reports, and manage portfolios and budget rules.

It's maintained by AI Shopping Feeds and offers:

• coverage: Sponsored Products v3, Sponsored Brands, Sponsored Display, reporting v3, portfolios, budget rules, recommendations and the unified Ads API v1

• bulk changes: adjust bids by a percentage or pause and enable many entities in one call

• safety: dry-run, confirm words for archives, big batches and bid or budget rises, read-only mode and an audit log of every write

• an escape hatch: any other endpoint on your regional Amazon Ads API host through amazon_ads_read_request and amazon_ads_request

Amazon also runs an official Amazon Ads MCP Server, hosted by Amazon for Ads partners (open beta since 2 February 2026). This one runs on your own machine and adds dry-run, an audit log, read-only mode and spend guards; see the comparison.

Not affiliated with or endorsed by Amazon.

Part of the AI Shopping Feeds MCP family: Google Ads · Google Merchant Centre · Google Analytics · YouTube Studio · Amazon Ads · Apple Ads · Microsoft Ads · TikTok Ads · Pinterest Ads · Snapchat Ads · OpenAI Ads · AppLovin.

Let your agent set it up

Paste this into Claude Code, Codex, Cursor or any agent that can read web pages and edit files:

Set up the Amazon Ads MCP server for me by following https://raw.githubusercontent.com/AI-Shopping-Feeds/amazon-ads-mcp/main/skills/amazon-ads-mcp/SKILL.md

The agent checks whether it's already connected, installs the runner if you agree, walks you through the Login with Amazon security profile, API access and sign-in, adds the server to your client's config without touching your other servers, and checks it works by calling amazon_ads_health_check.

The same file is an Agent Skill, so your agent can keep it as a guide to using the tools well. For Claude Code, copy the folder into your skills:

git clone --depth 1 https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git /tmp/amazon-ads-mcp
cp -r /tmp/amazon-ads-mcp/skills/amazon-ads-mcp ~/.claude/skills/

Other agents that support skills load the same skills/amazon-ads-mcp folder from their own skills directory.

Related MCP server: google-ads-mcp

What it can do

100 tools, all prefixed amazon_ads_. The full list is in docs/tools.md.

Read

Write

Safety

• Dry-run (AMAZON_ADS_DRY_RUN=true or amazon_ads_set_dry_run) records writes in the audit log and returns what would be sent, without sending it. Reads and reports still work.

• Archives need confirm="ARCHIVE" and Ads API v1 deletes need confirm="DELETE". Without the word, the tool sends nothing and returns the reasons.

• Spend guards: batches over AMAZON_ADS_BULK_THRESHOLD (10), bid or budget rises over AMAZON_ADS_MAX_INCREASE_PCT (25%), values over AMAZON_ADS_MAX_BID / AMAZON_ADS_MAX_BUDGET, budget rules and raw writes need confirm="APPLY", with the before/after values shown first.

• Every write is recorded in an audit log (~/.amazon-ads-mcp/logs/audit.jsonl) with a before-snapshot. Entries older than 30 days are pruned, and amazon-ads-mcp purge deletes the log and the stored token.

• AMAZON_ADS_READ_ONLY=true hides every tool that can change the account; AMAZON_ADS_TOOL_GROUPS exposes only the groups you need.

• The HTTP transports have no sign-in, so the server refuses to listen on anything but this machine unless you set AMAZON_ADS_ALLOW_REMOTE=true.

• How the server handles Amazon data, and who can use the API: docs/terms-and-data.md.

Supported clients

Setup

1. Install uv

The server runs with uvx from uv (brew install uv on macOS) and needs Python 3.11 or later. It installs straight from this repository:

uvx --from git+https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git amazon-ads-mcp version

Pin a release by adding @vX.Y.Z to the URL.

2. Get credentials

1. Login with Amazon: create a security profile in the Amazon Developer Console, note its client ID and client secret, and add http://localhost:8765/callback to its Allowed Return URLs.

2. API access: apply for Amazon Ads API access with the same email (approval can take up to one business day), then assign it to the security profile.

3. Save the credentials in ~/.amazon-ads-mcp/.env (owner-only), with your region (NA, EU for the UK and Europe, or FE):

   AMAZON_ADS_CLIENT_ID=amzn1.application-oa2-client.YOUR_CLIENT_ID
   AMAZON_ADS_CLIENT_SECRET=YOUR_CLIENT_SECRET
   AMAZON_ADS_REGION=EU

4. Sign in with the Amazon user that manages the ads. It saves a refresh token to ~/.amazon-ads-mcp/secrets/ (add --manual if the browser redirect doesn't work):

   uvx --from git+https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git amazon-ads-mcp auth

Step by step, with regions and token expiry: docs/setup-amazon-ads-api.md.

3. Add it to your client

Keep your other servers in each file. Credentials and the token are read from ~/.amazon-ads-mcp, so the config holds no secrets. The examples start in dry-run.

Claude Code

claude mcp add --scope user amazon-ads \
  --env AMAZON_ADS_DRY_RUN=true \
  -- uvx --from git+https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git amazon-ads-mcp

Claude Desktop, Cursor, Gemini CLI, Windsurf (and VS Code under servers)

{
  "mcpServers": {
    "amazon-ads": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git", "amazon-ads-mcp"],
      "env": {
        "AMAZON_ADS_DRY_RUN": "true"
      }
    }
  }
}

Desktop apps often can't find uvx on the PATH; if the server doesn't start, use the full path from which uvx as the command.

Codex (~/.codex/config.toml)

[mcp_servers.amazon-ads]
command = "uvx"
args = ["--from", "git+https://github.com/AI-Shopping-Feeds/amazon-ads-mcp.git", "amazon-ads-mcp"]
env = { AMAZON_ADS_DRY_RUN = "true" }

To keep the files elsewhere, add "--env", "/abs/path/amazon-ads.env" after amazon-ads-mcp in the arguments, or set AMAZON_ADS_TOKEN_FILE=/abs/path/amazon-ads-token.json and AMAZON_ADS_AUDIT_LOG=/abs/path/audit.jsonl.

4. Check it works

Restart or reload the client, then ask it "which Amazon Ads profiles can you see?". It should call amazon_ads_health_check and list your profiles. Add the one you use most to ~/.amazon-ads-mcp/.env as AMAZON_ADS_PROFILE_ID; tools also take a profile_id argument. When you're happy with the dry-run previews, remove AMAZON_ADS_DRY_RUN.

Configuration

Settings come from the environment (including your client config), then the --env file or ./.env, then ~/.amazon-ads-mcp/.env.

CLI: amazon-ads-mcp run (default), auth, purge, describe, version.

Example prompts

Which Sponsored Products campaigns spent the most last week, and what was their ACOS?

Lower bids by 10% on keywords in the "Brand - Exact" ad group with ACOS over 40%. Dry-run first and show me the table.

Add "free" and "cheap" as campaign negative phrase keywords to all my Sponsored Products campaigns.

Show me suggested budgets for campaigns that ran out of budget this week.

More docs

• All tools and confirm words

• Amazon Ads API setup, regions and token expiry

• MCP client configuration and every environment variable

• Terms and data handling

• Agent skill: setup and usage guide for agents

• Changelog and security policy

Contributing and licence

Issues and pull requests are welcome on this repository. See CONTRIBUTING.md.

Licensed under the MIT License.

Try out AI Shopping Feeds, our shopping feed management tool (including Google Shopping feeds).