mcpField
A
Amazon Advertising   - PPC Prophet

Amazon Advertising - PPC Prophet

Local
github.com/ppcprophetCloud & Infra5Updated 38w ago

About Amazon Advertising - PPC Prophet

Amazon Advertising - PPC Prophet is a hosted MCP server for AI assistants working with Amazon Advertising data. It combines campaign analysis, spend diagnosis, management tools, and automation monitoring.

Key features

  1. 01Campaign and keyword performance analysis
  2. 02Find spend without conversions
  3. 03Diagnose metric changes
  4. 04Update campaigns and bids
  5. 05Review automation rule activity
  6. 06Interactive data visualizations

Use cases

  1. 01Compare campaign sales and ROAS
  2. 02Find keywords spending without conversions
  3. 03Investigate an ACOS increase
  4. 04Monitor automation rule execution

MCP support

The hosted MCP server exposes Amazon Advertising query, management, and automation-monitoring tools to compatible clients, along with interactive visualizations.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"amazon-ads": {
"command": "npx",
"args": [
"-y",
"@ppcprophet/mcp-server"
],
"env": {
"PPC_PROPHET_API_TOKEN": "<PPC_PROPHET_API_TOKEN>",
"PPC_PROPHET_API_URL": "<PPC_PROPHET_API_URL>"
}
}
}
}
Run commandnpx -y @ppcprophet/mcp-server
Environment variables to set
PPC_PROPHET_API_TOKENSecret
PPC_PROPHET_API_URL

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@ppcprophet/mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Official MCP Registry Transport

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

QueryWhat 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

Registry Listings

Pricing

PlanProfilesFeaturesAPI Calls
Free1Read-only tools100/day
Pro ($99/mo)5Full access + write toolsUnlimited

Support

License

Proprietary - Requires PPC Prophet account for access.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.