Amazon Advertising MCP Server

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

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

• Full Query Reference: ppcgpt.getppcprophet.com/docs/queries
• Landing Page: ppcgpt.getppcprophet.com
• MCP Setup Guide: ppcgpt.getppcprophet.com/mcp

Registry Listings

• Official MCP Registry - io.github.philmccarty/amazon-advertising-ppc-prophet

Pricing

Support

• Documentation: ppcgpt.getppcprophet.com/docs/queries
• Email: [email protected]
• Main Platform: app.getppcprophet.com

License

Proprietary - Requires PPC Prophet account for access.