What is Ads Manager Mcp Server

Ads-manager-mcp-server is a Model Context Protocol (MCP) server designed for managing and analyzing Amazon Advertising data. It provides a standardized interface for large language models (LLMs) to interact with advertising data through the Claude Desktop App.

Use cases

Use cases include analyzing campaign performance metrics, optimizing advertising budgets, querying specific advertising data, and retrieving detailed performance analysis for ad groups.

How to use

To use Ads-manager-mcp-server, install the Claude Desktop App, create a configuration file named ‘claude-desktop-config.json’, and replace ‘YOUR_API_KEY_HERE’ with your actual API key. After that, you can start using the app to analyze your advertising data.

Key features

Key features include database integration with a secure PostgreSQL connection, API key authentication for secure access, real-time analytics for campaign metrics, and a natural language interface for querying advertising data.

Where to use

Ads-manager-mcp-server is primarily used in digital marketing and advertising sectors, particularly for businesses utilizing Amazon Advertising to manage and analyze their advertising campaigns.

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

1. Install the Claude Desktop App
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": "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 API key
4. 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

1. Fork the repository
2. Create your 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 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.