Amazon Ads MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport http -H "Authorization: Bearer YOUR_TOKEN_HERE" amazon-ads-mcp https://ppcgpt.getppcprophet.com/mcp
Required:Authorization
README.md

Connect AI assistants to your Amazon Advertising data.

Amazon Advertising MCP Server

Connect AI assistants to your Amazon Advertising data. Query campaign performance, find wasted spend, diagnose metric changes, and monitor automation rules—all through natural language.

What is this?

PPC Prophet MCP is a hosted Model Context Protocol server that gives AI assistants (Claude, ChatGPT, Cursor, etc.) direct access to your Amazon Advertising data. No local installation required—just connect and query.

This is infrastructure for AI agents, not a dashboard. It enables:

  • Natural language queries against your Amazon Ads data
  • Automated reporting and alerting workflows
  • AI-powered PPC optimization agents
  • Integration with any MCP-compatible client

Features

27+ Tools for Amazon Advertising

Performance Analytics

  • get_campaign_performance - Campaign metrics with flexible sorting (sales, ROAS, ACOS, spend, clicks)
  • get_search_term_performance - Search term analysis sorted by any KPI
  • get_asin_performance - Product-level performance metrics
  • get_match_type_performance - Compare exact, phrase, broad, and auto targeting
  • get_dayofweek_performance - Identify best/worst performing days
  • get_platform_performance - SP vs SB vs SD breakdown
  • compare_periods - Week-over-week, month-over-month analysis

Wasted Spend Analysis

  • get_wasted_spend - Find campaigns, keywords, or search terms spending without converting
  • Customizable thresholds and result limits
  • Campaign, keyword, and search term level analysis

Root Cause Diagnosis

  • diagnose_change - Answer "Why did my ACOS/Sales/Spend change?"
  • Drill down from account → campaign → keyword level
  • Factor decomposition (CPC, CVR, AOV impact)
  • Bid/budget change correlation

Campaign Management

  • list_campaigns, get_campaign, search_campaigns
  • update_campaign_status, update_campaign_budget
  • list_keywords, update_keyword_bid, update_keyword_status

Rules & Automation (PPC Prophet subscribers)

  • list_rules - View automation rules
  • get_rule_details - Rule configuration and filters
  • get_rule_outcomes - Execution history
  • get_recent_rule_activity - Monitor automation across profiles

Profile Management

  • list_profiles, get_profile, set_current_profile
  • list_mcp_profiles, activate_mcp_profile, check_mcp_status

MCP Apps (Interactive Widgets)

Rich visualizations rendered directly in Claude:

  • Wasted Spend Analyzer - Visual charts with sortable tables
  • Campaign Performance Dashboard - Metrics overview with comparisons
  • Diagnose Change - Waterfall charts showing contribution breakdown

Quick Start

1. Get Your API Token

  1. Sign up at ppcgpt.getppcprophet.com/register
  2. Connect your Amazon Advertising account
  3. Generate an API token at ppcgpt.getppcprophet.com/mcp

2. Configure Your MCP Client

Claude Desktop / Claude Code (Recommended)

Run this command in your terminal:

claude mcp add ppc-prophet \
  --transport http \
  --header "Authorization: Bearer YOUR_TOKEN_HERE" \
  https://ppcgpt.getppcprophet.com/mcp

Manual Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ppc-prophet": {
      "url": "https://ppcgpt.getppcprophet.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

3. Start Querying

"Show me wasted spend on keywords"
"Which campaigns have the best ROAS?"
"Why did my ACOS increase this week?"
"Compare last week to the week before"

Example Queries

Query What It Does
"Show me top 10 campaigns by sales" Campaign performance ranked by revenue
"Which keywords are losing money?" Keywords with spend but no conversions
"Why did my ACOS spike?" Root cause analysis with driver attribution
"Compare this month to last month" Period-over-period metrics comparison
"What search terms should I add as negatives?" Non-converting search terms
"Show me day of week breakdown" Performance by Monday-Sunday
"Which match type performs best?" Exact vs phrase vs broad comparison

Technical Details

  • Transport: Streamable HTTP (also supports SSE)
  • Authentication: Bearer token via Authorization header
  • Data Range: Last 90 days of performance data
  • Response Time: Sub-100ms for most queries

Documentation

Tools (5)

get_campaign_performanceRetrieves campaign metrics with flexible sorting options.
get_wasted_spendIdentifies campaigns, keywords, or search terms spending without converting.
diagnose_changePerforms root cause analysis on metric changes like ACOS or sales.
update_campaign_budgetUpdates the budget for a specific Amazon advertising campaign.
list_rulesViews active automation rules for PPC management.

Environment Variables

AuthorizationrequiredBearer token generated from the PPC Prophet dashboard.

Configuration

claude_desktop_config.json
{"mcpServers": {"ppc-prophet": {"url": "https://ppcgpt.getppcprophet.com/mcp", "transport": "streamable-http", "headers": {"Authorization": "Bearer YOUR_TOKEN_HERE"}}}}

Try it

Show me the top 10 campaigns by sales from the last week.
Which keywords are currently losing money without any conversions?
Why did my ACOS spike significantly this week?
Compare my campaign performance from this month to last month.
What search terms should I add as negatives based on recent performance?

Frequently Asked Questions

What are the key features of Amazon Ads MCP?

Natural language querying of Amazon Advertising performance data. Automated wasted spend detection and analysis. Root cause diagnosis for metric fluctuations like ACOS and ROAS. Campaign and keyword management including budget and bid updates. Interactive visualizations for performance dashboards and diagnostics.

What can I use Amazon Ads MCP for?

PPC managers identifying non-converting keywords to reduce wasted ad spend. Marketing analysts performing root cause analysis on sudden ACOS increases. E-commerce business owners monitoring campaign performance via natural language. Automation specialists reviewing execution history of PPC rules.

How do I install Amazon Ads MCP?

Install Amazon Ads MCP by running: claude mcp add ppc-prophet --transport http --header "Authorization: Bearer YOUR_TOKEN_HERE" https://ppcgpt.getppcprophet.com/mcp

What MCP clients work with Amazon Ads MCP?

Amazon Ads MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Amazon Ads MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare