PPC Prophet MCP Server

An MCP (Model Context Protocol) server for managing Amazon Advertising campaigns through natural language via AI assistants like Claude.

Prerequisites

• Node.js 18+
• A PPC Prophet account
• Your PPC Prophet API token

Installation

Option 1: npm (Recommended)

No installation required - use npx to run directly:

npx ppc-prophet-mcp

Or install globally:

npm install -g ppc-prophet-mcp

Option 2: From Source

# Clone or download the mcp-server directory
cd mcp-server
npm install
npm run build

Configuration

1. Get Your API Token

Log in to your PPC Prophet account and generate an API token from Settings > API Access.

2. Configure Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (Recommended)

{
  "mcpServers": {
    "ppc-prophet": {
      "command": "npx",
      "args": ["-y", "ppc-prophet-mcp"],
      "env": {
        "PPC_PROPHET_API_KEY": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Using Global Install

{
  "mcpServers": {
    "ppc-prophet": {
      "command": "ppc-prophet-mcp",
      "env": {
        "PPC_PROPHET_API_KEY": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Using Local Build

{
  "mcpServers": {
    "ppc-prophet": {
      "command": "node",
      "args": ["/path/to/mcp-server/build/index.js"],
      "env": {
        "PPC_PROPHET_API_KEY": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

3. Restart Claude Desktop

After editing the configuration, restart Claude Desktop to load the MCP server.

Testing with MCP Inspector

Before configuring Claude Desktop, you can test the server with the MCP Inspector:

npm run inspect

This opens a web UI where you can test all the tools interactively.

Available Tools

Profile Management

• list_profiles - List all Amazon advertising profiles
• get_profile - Get details about a specific profile

Campaign Management

• list_campaigns - List campaigns for a profile
• get_campaign - Get campaign details
• update_campaign_status - Pause, enable, or archive a campaign
• update_campaign_budget - Change daily budget
• search_campaigns - Search campaigns by name

Keyword Management

• list_keywords - List keywords for a profile/campaign
• update_keyword_bid - Change keyword bid
• update_keyword_status - Pause, enable, or archive a keyword

Reporting

• get_performance - Get performance metrics for a date range

Example Conversations

List Your Accounts

User: "Show me my Amazon accounts"
Claude: [Uses list_profiles tool]

Check Campaign Performance

User: "How did my campaigns perform last week?"
Claude: [Uses get_performance tool with date range]

Update a Bid

User: "Increase the bid for keyword 'blue widget' to $1.50"
Claude: [Uses update_keyword_bid tool]

Pause a Campaign

User: "Pause my Brand Defense campaign"
Claude: [Uses search_campaigns to find it, then update_campaign_status]

Development

# Watch mode for development
npm run dev

# Build for production
npm run build

Architecture

Claude Desktop → MCP Server (this) → Laravel API → MySQL Database

The MCP server acts as a bridge between Claude and your PPC Prophet Laravel API, translating natural language requests into API calls.

Troubleshooting

"Connection refused" errors

• Ensure your Laravel API is running (php73 artisan serve)
• Check the API URL in your configuration

"Unauthorized" errors

• Verify your Sanctum token is valid
• Ensure the token hasn't expired
• Check the user has access to the requested profiles

Tools not appearing in Claude

• Restart Claude Desktop after configuration changes
• Check the configuration file path is correct
• Verify the build directory exists (npm run build)