Amazon Ads MCP Server

🚀 amazon-ads-mcp-server

Connect to your Amazon Advertising Data by integrating your account with MarketplaceAdPros. This project provides seamless access to a wide range of Amazon advertising resources, reports, and additional features through a simple and efficient interface.

• Gain access to advertising resources in Sponsored Products, Sponsored Brands, and Sponsored Display, including Campaigns, Ad Groups, Keywords, Product Ads, and Targeting.
• Retrieve reports and query them using plain English, enabling you to extract valuable insights effortlessly.
• Unlock Marketplace Ad Pros Recommendations, Experiments, and more with a purchased subscription plan.

It's also available as a Streamable HTTP MCP Server by connecting to https://app.marketplaceadpros.com/mcp.

🚀 Quick Start

Connect to your Amazon Advertising Data by integrating your account with MarketplaceAdPros. The project offers access to various advertising resources, reports, and additional features.

✨ Features

• Comprehensive Advertising Resources: Access advertising resources in Sponsored Products, Sponsored Brands, and Sponsored Display, such as Campaigns, Ad Groups, Keywords, Product Ads, and Targeting.
• Reporting and Querying: Retrieve reports and query them with plain English.
• Premium Features: Enjoy Marketplace Ad Pros Recommendations, Experiments, and more with a purchased subscription plan.
• Streamable HTTP MCP Server: Connect to https://app.marketplaceadpros.com/mcp for streamable access.

📦 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 have multiple ways to configure the server:

Using npx in Claude Desktop

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

Building from the Repo in Claude Desktop

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

Using Streamable HTTP MCP Servers

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

Configuring in LibreChat

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

💻 Usage Examples

Basic Usage

The basic usage involves adding the server to your MCP client's configuration as shown in the Installation section.

Advanced Usage

If you need to use the Streamable HTTP MCP Server, you can directly connect to https://app.marketplaceadpros.com/mcp and configure your client accordingly.

🔧 Technical Details

Development

• Install Dependencies:

npm install

• Build the Server:

npm run build

• 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.

Acknowledgements

• We are grateful to the modelcontextprotocol and Anthropic teams for the MCP Specification. https://modelcontextprotocol.io/introduction
• Thanks to MarketplaceAdPros for enabling and sponsoring this project.