Amazon Ads MCP server

by tspicer·io.github.tspicer/amazon_ads_mcp·v0.2.4·70 stars

No reviews yet

Amazon Ads API MCP server for Amazon Advertising API

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

Established

70 stars249 downloads/wk

Reviews

Write one

Nobody has reviewed Amazon Ads yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Amazon Ads tools (24)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

check_oauth_status
Check the current OAuth authentication status
clear_active_profile
Clear the active profile ID
clear_oauth_tokens
Clear all stored OAuth tokens and state
download_export
Download a completed export to local storage (supports background execution)
get_active_identity
Get the currently active identity
get_active_profile
Get the currently active profile ID
get_download_url
Generate the download URL for a file.
get_region
Get the current region setting
get_routing_state
Get the current routing state including region, host, and headers
list_downloads
List all downloaded exports and reports for the active profile
list_identities
List all available identities
list_regions
List all available regions
page_profiles
Page through profiles with offset and limit
refresh_oauth_token
Manually refresh the OAuth access token
refresh_profiles_cache
Force refresh of cached profiles for the current identity and region
request_async_report
Request and download an async report with progress tracking (V3 Reporting API)
search_profiles
Search profiles by name, country, or account type
select_profile
Interactively select a profile from available options
set_active_identity
Set the active identity for Amazon Ads API calls
set_active_profile
Set the active profile ID for API calls
set_region
Set the region for Amazon Ads API calls
start_oauth_flow
Start the OAuth authorization flow for Amazon Ads API
summarize_profiles
Summarize available profiles by country and account type
test_sampling
Test LLM sampling functionality via MCP client

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings

Code scan77 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 22 days ago15/15
Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

Install Amazon Ads in Claude Code, Cursor or VS Code

claude mcp add amazon_ads_mcp -- uvx amazon-ads-mcp

Add to Cursor

What the publisher says

From the Amazon Ads repository's README, as published. We do not edit it. Read it on GitHub

Amazon Ads API MCP SDK

Build AI-powered advertising applications with the Model Context Protocol (MCP) SDK for Amazon Advertising API

Made with ❤️ + ☕ by Openbridge

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

Where this fits in Kuudo
What are MCP tools?
What is Amazon Ads API MCP SDK?
Quick start
Installation
Configuration (auth, packages, profiles, regions)
Downloading reports and exports
Example MCP client (Claude Desktop)
Context limits
Code mode
Tool audit
Background tasks

Where this fits in Kuudo

This repository is the tool layer of a broader Amazon agent platform. Kuudo gives Amazon agents tools, knowledge, workflows, and a place to work. This repository is the tools.

Read this repository as one layer of that platform rather than as the whole of it. The operations below are what an agent can call; Skills are what it runs.

What Are MCP Tools?

Think of MCP (Model Context Protocol) as a translator between an AI model and outside systems (like Amazon Ads). Each MCP tool is like a remote control button that tells the AI how to interact with Amazon Ads. Without MCP tools, the AI would have no idea how to “talk” to Amazon Ads.

With MCP tools:

The AI knows the exact endpoints to call.
The AI can request campaign reports, budgets, or targeting data safely.
Everything is structured, so the AI doesn’t break things by making random guesses.

👉 In short: MCP tools = a safe, well-labeled toolkit that lets AI work with the Amazon Ads API.

🚀 What is Amazon Ads API MCP SDK?

The Amazon Ads API MCP SDK is an open-source implementation that provides a robust foundation for creating AI-powered advertising tools, chatbots, and automated services.

✨ Key Features

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Amazon Ads: common questions

Is Amazon Ads MCP server safe?: Mostly: it is graded B (80/100). Read the Amazon Ads safety report
How do I install Amazon Ads?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Amazon Ads need an API key?: Yes. The registry entry asks for AMAZON_AD_API_CLIENT_SECRET, AMAZON_AD_API_REFRESH_TOKEN, OPENBRIDGE_REFRESH_TOKEN, OPENBRIDGE_API_KEY and 1 more.
Is Amazon Ads maintained?: The last commit was 36 days ago (2026-09-06). The latest release is v0.2.4.
What can I use instead of Amazon Ads?: Servers from other publishers that do the same job: Ads MCP server, Sessy — Amazon SES observability MCP server and Apiguru Amazon Data MCP server. Compare all Amazon Ads alternatives.

Alternatives to Amazon Ads

Same job from other publishers: the closest match first, then the best rated.

All Amazon Ads alternatives →

Ads
Manage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.
not reviewed
Growing
B
Sessy — Amazon SES observability
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
not reviewed
Established
A
Apiguru Amazon Data
Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
not reviewed
Growing
A
HasData Amazon
Amazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.
not reviewed
Growing
A
Amazon DSP MCP Server
Amazon DSP management — CRUD, async reports, targeting, and audience management
not reviewed
Growing
C

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 80/100
Stars: 70
Downloads/wk: 249
Price: Free
Licence: MIT
Transport: Local · pypi
Version: 0.2.4
Category: E-commerce
Last release: 2026-09-06

Credentials it needs

AMAZON_ADS_AUTH_METHODAuthentication method: direct or openbridge.
AMAZON_AD_API_CLIENT_IDAmazon Ads API client ID for direct auth.
AMAZON_AD_API_CLIENT_SECRETsecretAmazon Ads API client secret for direct auth.
AMAZON_AD_API_REFRESH_TOKENsecretAmazon Ads API refresh token for direct auth.
AMAZON_AD_API_PROFILE_IDAmazon Ads profile ID for direct auth.
OPENBRIDGE_REFRESH_TOKENsecretOpenbridge refresh token (API key).
OPENBRIDGE_API_KEYsecretOpenbridge API key (alias for OPENBRIDGE_REFRESH_TOKEN).
OPENBRIDGE_REMOTE_IDENTITY_IDOpenbridge remote identity ID.
AMAZON_ADS_REGIONAmazon Ads API region (na/eu/fe).
AMAZON_AD_API_PACKAGESComma-separated API packages to load.
AMAZON_ADS_DOWNLOAD_AUTH_TOKENsecretOptional bearer token to protect download routes.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/tspicer-amazon-ads-mcp.svg)](https://mcp.market/server/tspicer-amazon-ads-mcp)

How the badge works