Access Amazon Ads Data & Reports
MCP connector for Amazon Advertising data via MarketplaceAdPros: query campaigns, keywords, and reports in plain English.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Integrate with Amazon Advertising to access campaign data, manage ad resources, and retrieve reports. Query advertising performance and insights in plain English.
Outcomes
What it gets done
Connect to Amazon Sponsored Products, Sponsored Brands, and Sponsored Display campaigns.
Manage ad groups, keywords, product advertising, and targeting.
Generate and query advertising performance reports.
Access MarketplaceAdPros recommendations and experiments.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-amazon-ads | bash Overview
Amazon Ads MCP Server
An MCP connector for Amazon Advertising data through MarketplaceAdPros, exposing campaign/keyword/targeting resources and plain-English report querying. Use it when you want to review or query Amazon Advertising campaign performance conversationally through MarketplaceAdPros.
What it does
This MCP server connects an AI assistant to Amazon Advertising account data through a MarketplaceAdPros integration, giving access to advertising resources across Sponsored Products, Sponsored Brands, and Sponsored Display - campaigns, ad groups, keywords, product ads, and targeting - plus the ability to query performance reports using plain English instead of the Amazon Ads reporting API's native query syntax. With a purchased MarketplaceAdPros subscription plan, it also surfaces that platform's recommendations and experiment data. It's available both as a local MCP server (via npx or a built binary) and as a hosted Streamable HTTP MCP server at https://app.marketplaceadpros.com/mcp.
When to use - and when NOT to
Use this connector when you want to review or query Amazon Advertising performance conversationally - listing campaigns, ad groups, keywords, or targeting across Sponsored Products/Brands/Display, asking a plain-English question against advertising reports instead of writing a report query, or (with a MarketplaceAdPros subscription) pulling optimization recommendations and experiment results.
It requires a MarketplaceAdPros account and Bearer token for authentication - it does not manage Amazon Ads accounts that aren't connected through MarketplaceAdPros, and recommendation/experiment features specifically require a paid subscription plan.
Capabilities
- Advertising resource access: query campaigns, ad groups, keywords, product ads, and targeting across Sponsored Products, Sponsored Brands, and Sponsored Display
- Plain-English reporting: query advertising performance reports using natural language rather than the Amazon Ads reporting API's query format
- MarketplaceAdPros recommendations and experiments: access optimization recommendations and experiment data (requires a purchased subscription plan)
How to install
Add the server to your Claude Desktop config with a MarketplaceAdPros Bearer token, or point a Streamable-HTTP-capable client at the hosted endpoint:
{
"mcpServers": {
"marketplaceadpros": {
"command": "npx",
"args": ["@marketplaceadpros/amazon-ads-mcp-server"],
"env": {
"BEARER_TOKEN": "abcdefghijklmnop"
}
}
}
}
Alternatively, connect directly to the hosted MCP endpoint without running anything locally:
{
"mcpServers": {
"marketplaceadpros": {
"type": "streamable-http",
"url": "https://app.marketplaceadpros.com/mcp"
}
}
}
Requires a MarketplaceAdPros account and its Bearer token, obtained by connecting your Amazon Advertising account on marketplaceadpros.com.
Who it's for
Amazon sellers and PPC managers using MarketplaceAdPros who want to query campaign performance and reports through an AI assistant instead of navigating the Amazon Ads console or MarketplaceAdPros dashboard directly.
Source README
amazon-ads-mcp-server
Connect to your Amazon Advertising Data by integrating your account with MarketplaceAdPros.
Provides access to:
- Advertising Resources in Sponsored Products, Sponsored Brands and Sponsored Display, like Campaigns, Ad Groups, Keywords, Product Ads, Targeting
- Reports and ability to query them with plain english.
- Marketplace Ad Pros Recommendations, Experiments and more with purchased subscription plan
Also available as a Streamable HTTP MCP Server by connecting to https://app.marketplaceadpros.com/mcp
Installation
To add the amazon-ads-mcp-server to your MCP client of choice, add the following to the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Env Vars
BEARER_TOKEN: The Bearer token you got from MarketplaceAdPros.com
Configuration
You can use it via npx in your Claude Desktop configuration like this:
{
"mcpServers": {
"marketplaceadpros": {
"command": "npx",
"args": [
"@marketplaceadpros/amazon-ads-mcp-server"
],
"env": {
"BEARER_TOKEN": "abcdefghijklmnop"
}
}
}
}
Or, if you clone the repo, you can build and use in your Claude Desktop configuration like this:
{
"mcpServers": {
"marketplaceadpros": {
"command": "node",
"args": [
"/path/to/amazon-ads-mcp-server/build/index.js"
],
"env": {
"BEARER_TOKEN": "abcdefghijklmnop"
}
}
}
}
Or, if your client supports the Streamable HTTP MCP Servers, you can just point to the MCP endpoint at https://app.marketplaceadpros.com/mcp.
{
"mcpServers": {
"marketplaceadpros": {
"type": "streamable-http",
"url": "https://app.marketplaceadpros.com/mcp"
}
}
}
Or, configure in LibreChat like:
MAP:
type: streamable-http
url: https://app.marketplaceadpros.com/mcp
headers:
Authorization: "Bearer abcdefghijklmnop"
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.