amazon-ads

The amazon-ads mcp-server connects to your Amazon Advertising data through MarketplaceAdPros, giving you access to Advertising Resources across Sponsored Products, Sponsored Brands, and Sponsored Display, including Campaigns, Ad Groups, Keywords, and Product Ads. It also exposes reporting endpoints and a plain-English query interface for retrieving data and generating insights. If you have the Streamable HTTP option enabled, you can point your client to https://app.marketplaceadpros.com/mcp for a hosted MCP experience. To get started, configure the MCP server in your client using npx as shown in the example, supplying your BEARER_TOKEN from MarketplaceAdPros. You can also clone the repository and run the server locally with a Node-based setup, then reference the built index.js in your client configuration. The server supports both interactive query capabilities and programmatic access to reports and recommendations.

• Tools and capabilities include: access to campaigns, ad groups, keywords, and product ads; reporting endpoints for standard metrics; natural-language query support to fetch and filter data; and access to Marketplace Ad Pros recommendations and experiments when you have a subscription.
• If you prefer a hosted solution, use the streamable HTTP MCP endpoint provided by MarketplaceAdPros to avoid running your own instance; simply point your client to the given URL and pass authorization headers as needed.

Prerequisites:

• Node.js and npm installed on your machine (recommended v14+).
• Access to a terminal or command prompt.

Installation steps:

1. Install dependencies and build (if starting from source):

npm install
npm run build

2. Run in development (with auto-rebuild):

npm run watch

3. Run via npx (from npm registry):

# Using the published MCP server package
npx @marketplaceadpros/amazon-ads-mcp-server

4. If cloning and running locally, ensure you have the built index.js path ready and configure your MCP client accordingly, for example:

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

5. For streamable HTTP usage, no local server is needed—simply use the provided endpoint and configure your client accordingly.

Environment variables: BEARER_TOKEN is required for authenticating with MarketplaceAdPros. If you’re running locally, ensure your token remains secret and do not commit it in public repos. When using the Node build, remember to run npm run build before pointing your client to /build/index.js. If you encounter issues with MCP communication, enable the inspector workflow (npm run inspector) to help debug via the MCP Inspector tool. For hosted usage, the streamable HTTP endpoint at https://app.marketplaceadpros.com/mcp is available, but ensure your client supports streamable-http MCP servers. If you see rate limits or missing data, verify that your MarketplaceAdPros subscription and access scope cover the resources you’re querying (Campaigns, Ad Groups, Keywords, Product Ads, and Reports).