How to Use the Amazon Ads MCP in Claude Code

Q: How do I add the Amazon Ads MCP Server to Claude Code?

Run claude mcp add --transport http amazon-ads -- in your terminal. This command registers the MCP Server in your /.claude.json configuration file for immediate headless use.

Q: Can I pipe Amazon Ads output from Claude Code to other CLI tools?

Yes, Claude Code calls the MCP Server tools like listspkeywords and outputs structured JSON. You can pipe this terminal output directly into tools like jq, sed, or custom bash scripts.

Q: How does Claude Code check if an Amazon Ads report is ready?

Claude Code first calls requestspreport to start the generation process. It then runs getreportstatus to monitor the file generation progress until the download link is active.

Q: What tools are available for Sponsored Products?

The server provides listspcampaigns, listspadgroups, and listspkeywords. These tools let you query your entire Sponsored Products structure directly from your shell.

Run headless Amazon Ads reporting and campaign audits straight from the Claude Code terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amazon Ads MCP to Claude Code

Create your Vinkius account to connect Amazon Ads to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Amazon Ads with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Amazon Ads audits in Claude Code

This MCP Server uses `list_sp_campaigns` and `list_sb_campaigns` to let Claude Code query your live advertising setup directly from the command line. You can pipe this output into standard Unix utilities like grep or jq for instant filtering. It replaces bloated web consoles with raw terminal speed. Claude Code calls the tools, processes the active campaign arrays, and prints clean tables of your active Sponsored Products and Sponsored Brands campaigns.

Automate report generation via CLI scripts

The server triggers asynchronous performance pulls using `request_sp_report` and checks readiness via `get_report_status`. Claude Code runs these commands headlessly, making it easy to script automated daily report downloads. You can write a quick bash script that tells Claude Code to request a report, wait for it to compile, and save the output directly to a local directory for your CI/CD pipeline. This integration removes the need to use a browser for ad reporting.

Map advertiser profiles from the shell

This MCP Server uses `list_profiles` to let Claude Code list every advertiser account linked to your credentials. This profile mapping lets you switch between different brand accounts using simple command-line arguments. Before running any keyword queries, Claude Code runs this tool to verify your target profile. This ensures your terminal commands are executed against the correct seller or vendor account every time.

Setup guide

Set up Amazon Ads MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see amazon-ads-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Amazon Ads transactions." It will automatically discover and invoke the available Amazon Ads tools.

Terminal

claude mcp add --transport http amazon-ads-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Amazon Ads MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "amazon-ads-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Amazon Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Amazon Ads now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Amazon Ads MCP in Claude Code

Run `claude mcp add --transport http amazon-ads -- ` in your terminal. This command registers the MCP Server in your `~/.claude.json` configuration file for immediate headless use.

Yes, Claude Code calls the MCP Server tools like `list_sp_keywords` and outputs structured JSON. You can pipe this terminal output directly into tools like jq, sed, or custom bash scripts.

Claude Code first calls `request_sp_report` to start the generation process. It then runs `get_report_status` to monitor the file generation progress until the download link is active.

The server provides `list_sp_campaigns`, `list_sp_ad_groups`, and `list_sp_keywords`. These tools let you query your entire Sponsored Products structure directly from your shell.

Yes, your developer tokens and campaign profile lists are managed securely by Vinkius. The server runs in a secure, isolated V8 sandbox, ensuring your private ad metrics never leak into shell histories.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript