mcpField
A
amazon-ads-mcp-server

amazon-ads-mcp-server

Local
github.com/MarketplaceAdProsCloud & Infra29Updated 6d ago
Repository

About amazon-ads-mcp-server

amazon-ads-mcp-server is an MCP server that connects Amazon Advertising data through MarketplaceAdPros. It is intended for users who need to query advertising resources and reports. It covers Sponsored Products, Sponsored Brands and Sponsored Display.

Key features

  1. 01Access Sponsored Products, Brands and Display resources
  2. 02Query reports using plain English
  3. 03MarketplaceAdPros recommendations and experiments with subscription
  4. 04Run via npx, local build or Streamable HTTP

Use cases

  1. 01Review campaigns, ad groups, keywords and targeting settings
  2. 02Analyze advertising reports with natural language queries
  3. 03Manage Amazon ad resources from MCP-compatible clients

MCP support

This project is an MCP server that exposes Amazon advertising resources and report queries to MCP clients. It can also be reached remotely through a Streamable HTTP endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "amazon-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@marketplaceadpros/amazon-ads-mcp-server"
      ],
      "env": {
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @marketplaceadpros/amazon-ads-mcp-server
Environment variables to set
BEARER_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@marketplaceadpros/amazon-ads-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

amazon-ads-mcp-server live in inspector

The Inspector will provide a URL to access debugging tools in your browser.

Acknowledgements

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.