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 various Amazon advertising resources and features.

🚀 Quick Start

Connect to your Amazon Advertising Data by integrating your account with MarketplaceAdPros. It offers access to advertising resources in Sponsored Products, Sponsored Brands, and Sponsored Display, reports, and Marketplace Ad Pros Recommendations. It's also available as a Streamable HTTP MCP Server at https://app.marketplaceadpros.com/mcp.

✨ Features

• Advertising Resources Access: Gain access to advertising resources in Sponsored Products, Sponsored Brands, and Sponsored Display, including Campaigns, Ad Groups, Keywords, Product Ads, and Targeting.
• Report Querying: Retrieve reports and query them using plain English.
• Subscription Benefits: Enjoy Marketplace Ad Pros Recommendations, Experiments, and more with a purchased subscription plan.
• Streamable HTTP Server: Connect via the Streamable HTTP MCP Server at 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 have multiple ways to configure the server:

Using npx

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"
      }
    }
  }
}

Cloning the Repo

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"
      }
    }
  }
}

Using Streamable HTTP MCP Servers

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"
    }
  }
}

Configuring in LibreChat

Configure in LibreChat like:

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

💻 Usage Examples

Basic Usage

Here are the basic steps to get started with the server as described in the installation section. You can choose the configuration method that suits your needs.

🔧 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 express our gratitude to the modelcontextprotocol and Anthropic teams for the MCP Specification. https://modelcontextprotocol.io/introduction
• Thanks to MarketplaceAdPros for enabling and sponsoring this project.