Amazon Ads MCP Server

1# amazon-ads-mcp-server
2 
3Connect to your Amazon Advertising Data by integrating your account with [MarketplaceAdPros](https://marketplaceadpros.com).
4 
5Provides access to:
6 
7- Advertising Resources in Sponsored Products, Sponsored Brands and Sponsored Display, like Campaigns, Ad Groups, Keywords, Product Ads, Targeting
8- Reports and ability to query them with plain english.
9- Marketplace Ad Pros Recommendations, Experiments and more with purchased subscription plan
10 
11Also available as a Streamable HTTP MCP Server by connecting to `https://app.marketplaceadpros.com/mcp`
12 
13## Installation
14 
15To add the amazon-ads-mcp-server to your MCP client of choice, add the following to the server config:
16 
17On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
18 
19On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
20 
21### Env Vars
22 
23- `BEARER_TOKEN`: The Bearer token you got from MarketplaceAdPros.com
24 
25 
26### Configuration
27 
28You can use it via `npx` in your Claude Desktop configuration like this:
29 
30```json
31{
32  "mcpServers": {
33    "marketplaceadpros": {
34      "command": "npx",
35      "args": [
36        "@marketplaceadpros/amazon-ads-mcp-server"
37      ],
38      "env": {
39        "BEARER_TOKEN": "abcdefghijklmnop"
40      }
41    }
42  }
43}
44```
45 
46 
47Or, if you clone the repo, you can build and use in your Claude Desktop configuration like this:
48 
49 
50```json
51 
52{
53  "mcpServers": {
54    "marketplaceadpros": {
55      "command": "node",
56      "args": [
57        "/path/to/amazon-ads-mcp-server/build/index.js"
58      ],
59      "env": {
60        "BEARER_TOKEN": "abcdefghijklmnop"
61      }
62    }
63  }
64}
65```
66 
67 
68Or, if your client supports the Streamable HTTP MCP Servers, you can just point to the MCP endpoint at `https://app.marketplaceadpros.com/mcp`. 
69 
70 
71```json
72 
73{
74  "mcpServers": {
75    "marketplaceadpros": {
76      "type": "streamable-http",
77      "url": "https://app.marketplaceadpros.com/mcp"
78    }
79  }
80}
81```
82 
83 
84Or, configure in [LibreChat](https://www.librechat.ai/) like:
85```yaml
86  MAP:
87    type: streamable-http
88    url: https://app.marketplaceadpros.com/mcp
89    headers:
90      Authorization: "Bearer abcdefghijklmnop"
91````
92 
93 
94## Development
95 
96Install dependencies:
97```bash
98npm install
99```
100 
101Build the server:
102```bash
103npm run build
104```
105 
106For development with auto-rebuild:
107```bash
108npm run watch
109```
110 
111### Debugging
112 
113Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
114 
115```bash
116npm run inspector
117```
118 
119![amazon-ads-mcp-server live in inspector](img/inspector.png)
120 
121The Inspector will provide a URL to access debugging tools in your browser.
122 
123### Acknowledgements
124 
125- Obviously the modelcontextprotocol and Anthropic teams for the MCP Specification. [https://modelcontextprotocol.io/introduction](https://modelcontextprotocol.io/introduction)
126- [MarketplaceAdPros](https://marketplaceadpros.com?ref=github-amazon-ads-mcp-server) for enabling and sponsoring this project.
127