PropellerAds MCP-Server

Demokratisierung von programmatischer Werbung mit KI

Lassen Sie KI-Assistenten wie Claude Ihre Werbekampagnen auf PropellerAds automatisch verwalten.

Schnellstart • Verfügbare Tools • Anwendungsbeispiele • MCP-Konfiguration

Was ist das?

PropellerAds MCP ist ein Model Context Protocol-Server, der KI-Assistenten (Claude und jeden MCP-kompatiblen Client) direkt mit der API der Werbeplattform PropellerAds verbindet. Anstatt sich manuell in Dashboards einzuloggen, Berichte zu erstellen und durch Einstellungen zu klicken, sprechen Sie einfach in natürlicher Sprache mit Ihrem KI-Assistenten und er erledigt alles für Sie.

Erstellen Sie Kampagnen, analysieren Sie die Leistung, setzen Sie leistungsschwache Zonen auf die Blacklist, finden Sie Skalierungsmöglichkeiten, vergleichen Sie Zeiträume – alles durch natürliche Konversation.

Entwickelt für:

• Media Buyer und Performance-Marketer

• iGaming- und App-Install-Affiliates

• Growth Hacker und Digitalagenturen

• Jeden, der PropellerAds-Kampagnen schaltet und schneller arbeiten möchte

Funktionen

• Vollständiger Kampagnen-Lebenszyklus – Erstellen, aktualisieren, starten, stoppen und klonen Sie Kampagnen, ohne Ihren Chat zu verlassen

• Echtzeit-Leistungsanalysen – Impressionen, Klicks, Conversions, CTR, CVR, CPC, CPA und ROI werden automatisch berechnet

• Vergleich über Zeiträume hinweg – Vergleichen Sie zwei beliebige Datumsbereiche nebeneinander mit Trendindikatoren

• Optimierung auf Zonenebene – Finden Sie leistungsschwache Zonen, die Budget verschwenden, und Top-Zonen, die sich für eine Whitelist lohnen

• Automatisiertes Blacklisting – Ein Befehl zum Identifizieren und Blacklisten schlechter Zonen (mit Sicherheitsmodus für Testläufe)

• Skalierungsintelligenz – Finden Sie automatisch Kampagnen mit starkem ROI und Conversion-Volumen, die bereit für eine Skalierung sind

• Aufschlüsselung der Creative-Leistung – Sehen Sie, welche Creatives Ergebnisse liefern und welche ersetzt werden müssen

• Sicher durch Design – API-Token werden in Umgebungsvariablen gespeichert und niemals im Gespräch offengelegt

• Sicherheit durch Testläufe – Destruktive Vorgänge werden standardmäßig im Vorschau-Modus ausgeführt, bevor sie angewendet werden

Verfügbare Tools

Kampagnenmanagement

Filter für list_campaigns: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (teilweise Übereinstimmung)

Statistik & Analytik

Allgemeine optionale Parameter: date_from, date_to (JJJJ-MM-TT, Standard sind die letzten 7 Tage), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)

Optimierung

Targeting

Konto

Tech-Stack

Schnellstart

Voraussetzungen

1. PropellerAds-Konto mit API-Zugriff

   • Mindestanforderung: 1.000 $ Gesamtausgaben oder Einzahlung

   • API-Token abrufen: https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop oder Claude Code (oder ein beliebiger MCP-kompatibler Client)

Installation

Option 1: Installation über PyPI (Empfohlen)

pip install propellerads-mcp

Option 2: Installation aus dem Quellcode

git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .

API-Token festlegen

Erstellen Sie eine .env-Datei im Projektstammverzeichnis oder exportieren Sie die Umgebungsvariable:

export PROPELLERADS_API_TOKEN="your_api_token_here"

Anwendungsbeispiele

Kampagnenmanagement

"Show me all my active campaigns sorted by ROI"

"Create a push campaign for gaming offers in Brazil with $100 daily budget"

"Pause all campaigns with negative ROI in the last 7 days"

"Clone my best performing campaign to Mexico, Colombia, and Peru"

Leistungsanalyse

"What's my campaign performance for the last week?"

"Compare this week's performance vs last week"

"Show me the top 10 zones by conversions for campaign 12345"

"Which creatives have CTR below 0.5%?"

Optimierungs-Workflows

"Find all zones spending over $50 without conversions and blacklist them"

"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"

"Find top performing zones for my dating campaigns and add them to a whitelist"

Tägliche Optimierungsroutine

1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"

MCP-Konfiguration

Claude Desktop

Fügen Sie dies Ihrer Claude Desktop-Konfigurationsdatei hinzu:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propellerads": {
      "command": "python",
      "args": ["-m", "propellerads_mcp"],
      "env": {
        "PROPELLERADS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern der Konfiguration neu.

Claude Code

Fügen Sie den MCP-Server über die CLI zu Claude Code hinzu:

claude mcp add propellerads -- python -m propellerads_mcp

Stellen Sie sicher, dass PROPELLERADS_API_TOKEN in Ihrer Shell-Umgebung festgelegt ist, bevor Sie Claude Code starten.

Andere MCP-Clients

Dieser Server verwendet stdio-Transport, die Standard-Kommunikationsmethode von MCP. Jeder MCP-kompatible Client kann eine Verbindung herstellen, indem er den Prozess startet:

python -m propellerads_mcp

Der Server liest PROPELLERADS_API_TOKEN aus der Umgebung. Übergeben Sie es über die env-Konfiguration Ihres MCP-Clients oder legen Sie es in Ihrer Shell fest.

Projektstruktur

propellerads-mcp/
├── src/
│   └── propellerads_mcp/
│       ├── __init__.py       # Package init, version, exports
│       ├── __main__.py       # Module entry point (python -m)
│       ├── client.py         # PropellerAds API client (httpx-based)
│       └── server.py         # MCP server, tool definitions & handlers
├── .env.example              # Environment variable template
├── .gitignore
├── LICENSE                   # MIT License
├── pyproject.toml            # Build config, dependencies, metadata
└── README.md

Sicherheit & Berechtigungen

Mitwirken

Beiträge sind willkommen! So können Sie helfen:

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/my-feature)

3. Commiten Sie Ihre Änderungen (git commit -m "Add my feature")

4. Pushen Sie auf Ihren Branch (git push origin feature/my-feature)

5. Öffnen Sie einen Pull Request

Für Fehler und Funktionsanfragen öffnen Sie bitte ein Issue.

Autor

Jan Naftanaila -- Media Buyer & KI-Automatisierungsspezialist

Entwickelt Tools, die die Lücke zwischen KI und programmatischer Werbung schließen. Fokus darauf, AdTech zugänglich, automatisiert und intelligent zu machen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

PropellerAds MCP -- Open Source. Entwickelt für die Community der programmatischen Werbung.