Overview

The Amazon Ads MCP Server from MarketplaceAdPros exposes Amazon Advertising data and campaign controls through a Model Context Protocol (MCP) server interface. It acts as a bridge between MCP-capable clients (local or streamable HTTP) and the Amazon Advertising APIs, surfacing resources such as campaigns, ad groups, targeting, ads, keywords and report data in a consistent, queryable format.

This server is useful for developers who want programmatic, conversational, or model-driven interaction with Amazon Ads without building a full API wrapper. You can run it locally as an MCP stdio server (for clients like Claude Desktop) or connect to the hosted streamable HTTP endpoint. The server supports direct control (create/update/pause campaigns), report retrieval, and plain-English queries against report data where supported.

Features

Access advertising resources: Campaigns, Ad Groups, Product Ads, Keywords, Targeting
Generate and retrieve reports (Sponsored Products, Sponsored Brands, Sponsored Display)
Plain-English querying of reports and analytics
Campaign controls: pause/resume, budget updates, bid adjustments
Recommendations, experiments and additional insights (requires a MarketplaceAdPros subscription)
Two deployment modes:
- Local MCP server over stdio (node/npm)
- Streamable HTTP MCP server (hosted endpoint)
Development tooling including build, watch, and MCP Inspector integration for debugging

GitHub: https://github.com/MarketplaceAdPros/amazon-ads-mcp-server

Installation / Configuration

Prerequisites

Node.js (for running locally via npm)
A MarketplaceAdPros BEARER_TOKEN (obtain from MarketplaceAdPros dashboard)

Environment variables

Variable	Required	Description
BEARER_TOKEN	Yes	Bearer token from MarketplaceAdPros used to authenticate requests

Install and build

# install dependencies
npm install

# build for production
npm run build

# build and watch in development
npm run watch

Run via npx (recommended for quick setup) Add the MCP server entry to your client configuration (example for Claude Desktop):

{
  "mcpServers": {
    "marketplaceadpros": {
      "command": "npx",
      "args": [
        "@marketplaceadpros/amazon-ads-mcp-server"
      ],
      "env": {
        "BEARER_TOKEN": "abcdefghijklmnop"
      }
    }
  }
}

Run a local build with node

{
  "mcpServers": {
    "marketplaceadpros": {
      "command": "node",
      "args": [
        "/path/to/amazon-ads-mcp-server/build/index.js"
      ],
      "env": {
        "BEARER_TOKEN": "abcdefghijklmnop"
      }
    }
  }
}

Streamable HTTP MCP (hosted) If your client supports a streamable HTTP MCP server, point to the hosted endpoint:

{
  "mcpServers": {
    "marketplaceadpros": {
      "type": "streamable-http",
      "url": "https://app.marketplaceadpros.com/mcp"
    }
  }
}

LibreChat example (YAML)

MAP:
  type: streamable-http
  url: https://app.marketplaceadpros.com/mcp
  headers:
    Authorization: "Bearer abcdefghijklmnop"

Development & Debugging

Build/watch: npm run build, npm run watch
Debugging MCP stdio servers can be difficult; use the MCP Inspector to visualize MCP traffic and messages:

# start inspector (provided as an npm script)
npm run inspector

The inspector will open a browser URL that shows incoming/outgoing MCP messages and makes it easier to trace protocol interactions.

Available Resources

The server exposes typical Amazon Advertising resources and controls via MCP “tools” or endpoints that clients can invoke:

Campaigns: list, create, update, pause/resume
Ad Groups: CRUD operations and status updates
Product Ads (Sponsored Products): manage ads and ASIN targeting
Keywords & Targeting: add/remove keywords, update bids, negative keywords
Reports: request, poll, and download report results; support for natural-language querying of report data
Recommendations & Experiments: insights and A/B testing controls (subscription features)

Clients interact using MCP tool calls or message requests defined by the Model Context Protocol. When using the streamable HTTP server, authentication is supplied via the Bearer token in headers.

Use Cases

Retrieve campaign performance: “Show me last 7 days spend, sales, and ACOS for Sponsored Products campaigns” — the server will generate and return the appropriate report data.
Pause a low-performing campaign: send a command to change campaign status to paused for a given campaign ID.
Keyword analysis via plain English: “Which keywords had ACOS above 30% and more than 50 clicks last week?” — returns a filtered list from report data.
Automate bidding adjustments: run a scheduled process that queries keyword performance and updates bids via MCP calls.
Run MarketplaceAdPros recommendations: fetch suggested optimizations or experiments (requires subscription) and optionally apply them programmatically.

Notes

Authentication is handled via a BEARER_TOKEN from MarketplaceAdPros; keep this token secure.
The server communicates over stdio in local mode (MCP stdio) and via an HTTP streaming interface for the hosted endpoint.
For production automation, verify rate limits and API capabilities with MarketplaceAdPros support documentation.

For full source and issues, see the project repository: https://github.com/MarketplaceAdPros/amazon-ads-mcp-server

Amazon Ads MCP Server for MarketplaceAdPros