Ads Manager MCP Server

🚀 Amazon Ads Manager MCP Server

An MCP (Model Context Protocol) server for managing and analyzing Amazon advertising data. This server provides a standardized interface for large language models (LLMs) to interact with your advertising data through the desktop version of the Claude application.

🚀 Quick Start

1. Install the Claude desktop application.
2. 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": "An 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"
      }
    }
  }
}

3. Replace YOUR_API_KEY_HERE with your own API key.
4. Start using the Claude desktop application to analyze advertising data.

✨ Features

• Database Integration: Pre-configured connection to a secure PostgreSQL database.
• API Key Authentication: Secure access through API key verification.
• Real-time Analysis: Obtain advertising campaign metrics and performance data.
• Natural Language Interface: Query advertising data using natural language.

📦 Installation

npm install ads-manager-mcp

📚 Documentation

Available Resources

• Schemas: View the database structure and table definitions.
• Metrics: Obtain advertising campaign 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: Obtain detailed performance analysis of ad groups.
• optimizeBudget: Get budget optimization suggestions for all campaigns.
• query: Execute custom SQL queries on the database.

Example Queries

"Show the structure of all tables."
"Analyze the performance of campaign ABC123 in the past 30 days."
"What are the key metrics of ad group XYZ789?"
"Provide suggested budgets 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

Contribution Guidelines

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

📄 License

This project is under the MIT license. For detailed information, please check the LICENSE file.

💪 Support

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