Amazon Ads Manager MCP Server

A Model Context Protocol (MCP) server for managing and analyzing Amazon Advertising data. This server provides a standardized interface for LLMs to interact with your advertising data through the Claude Desktop App.

Features

Database Integration: Pre-configured connection to a secure PostgreSQL database
API Key Authentication: Secure access through API key validation
Real-time Analytics: Access to campaign metrics and performance data
Natural Language Interface: Query your advertising data using natural language

Installation

npm install ads-manager-mcp

Quick Start

Install the Claude Desktop App
Create a configuration file claude-desktop-config.json:

{
  "name": "Amazon Ads Manager",
  "version": "1.0.4",
  "description": "Connect to your Amazon Advertising data and analyze campaign performance",
  "mcpServers": {
    "ads-manager": {
      "name": "Ads Manager MCP Server",
      "version": "1.0.4",
      "description": "MCP Server for Amazon Advertising data analysis",
      "transport": "sse",
      "endpoint": "https://mcp-server-sync-abhilashreddi.replit.app/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your API key
Start using the Claude Desktop App to analyze your advertising data

Available Resources

Schema: View database structure and table definitions
Metrics: Access advertising performance metrics
Campaigns: View campaign configurations and settings
Ad Groups: Access ad group details and settings

Available Tools

analyzeCampaignPerformance: Analyze campaign metrics and performance
analyzeAdGroupPerformance: Get detailed ad group performance analysis
optimizeBudget: Get budget optimization recommendations
query: Run custom SQL queries against the database

Example Queries

"Show me the structure of all tables in the database"
"Analyze the performance of campaign ABC123 for the last 30 days"
"What are the key metrics for ad group XYZ789?"
"Give me budget recommendations for all campaigns in profile P123"

API Authentication

The server uses API key authentication. Each request must include an Authorization header:

Authorization: Bearer YOUR_API_KEY

Database Connection

The server maintains a connection to a PostgreSQL database. No additional configuration is required as the connection details are pre-configured in the package.

Development

To run the server locally:

# Install dependencies
npm install

# Start the development server
npm run dev

# Build the package
npm run build

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue in the GitHub repository or contact the maintainers.

Amazon Ads Manager MCP Server