Skip to main content
Glama
PropellerAds MCP Server

PropellerAds MCP Server

by JanNafta

PropellerAds MCP-Server

Demokratisierung von programmatischer Werbung mit KI

Python 3.10+ MCP License: MIT Status GitHub Stars GitHub Forks

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


Related MCP server: Google Ad Manager MCP Server

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

Tool

Beschreibung

Erforderliche Parameter

list_campaigns

Alle Kampagnen mit optionalen Filtern auflisten

--

get_campaign_details

Vollständige Kampagneninfos abrufen (Targeting, Creatives, Einstellungen)

campaign_id

create_campaign

Eine neue Werbekampagne erstellen

name, ad_format, countries, daily_budget, bid, target_url

update_campaign

Kampagneneinstellungen ändern (Budget, Gebot, Name, Status)

campaign_id

start_campaigns

Eine oder mehrere pausierte Kampagnen aktivieren

campaign_ids

stop_campaigns

Eine oder mehrere aktive Kampagnen pausieren

campaign_ids

clone_campaign

Eine bestehende Kampagne duplizieren

campaign_id

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

Statistik & Analytik

Tool

Beschreibung

Erforderliche Parameter

get_performance_report

Detaillierte Statistiken mit berechneten Metriken (CTR, CVR, CPC, CPA, ROI)

--

get_campaign_performance

Leistungszusammenfassung für eine bestimmte Kampagne

campaign_id

compare_periods

Zwei Zeiträume mit Veränderungsindikatoren vergleichen

period1_from, period1_to, period2_from, period2_to

get_zone_performance

Analytik auf Zonen-/Platzierungsebene, sortierbar

--

get_creative_performance

Aufschlüsselung der Creative-Leistung

--

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

Tool

Beschreibung

Erforderliche Parameter

find_underperforming_zones

Zonen finden, die Geld ausgeben, ohne zu konvertieren (Blacklist-Kandidaten)

campaign_id

find_top_zones

Bestleistung erbringende Zonen finden (Whitelist-Kandidaten)

campaign_id

find_scaling_opportunities

Kampagnen finden, die bereit für eine Skalierung sind (hoher ROI + Volumen)

--

auto_blacklist_zones

Schlechte Zonen in einem Schritt finden und blacklisten (standardmäßig Testlauf)

campaign_id

Targeting

Tool

Beschreibung

Erforderliche Parameter

add_to_whitelist

Zonen zur Whitelist einer Kampagne hinzufügen

campaign_id, zone_ids

add_to_blacklist

Zonen zur Blacklist einer Kampagne hinzufügen

campaign_id, zone_ids

Konto

Tool

Beschreibung

Erforderliche Parameter

get_balance

Aktuellen Kontostand prüfen

--

get_available_countries

Alle für das Targeting verfügbaren Länder auflisten

--

get_ad_formats

Verfügbare Werbeformate auflisten (push, onclick, etc.)

--


Tech-Stack

Komponente

Technologie

Laufzeit

Python 3.10+

Protokoll

Model Context Protocol (MCP) 1.0

HTTP-Client

httpx

Validierung

Pydantic v2

API

PropellerAds SSP API v5

Build-System

Hatchling

Transport

stdio (Standard-MCP-Transport)


Schnellstart

Voraussetzungen

  1. PropellerAds-Konto mit API-Zugriff

  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

Aspekt

Details

Authentifizierung

Bearer-Token über Umgebungsvariable (niemals hartcodiert)

Leseoperationen

Werden ohne zusätzliche Bestätigung ausgeführt

Schreiboperationen

Erfordern explizite Benutzerabsicht (erstellen, aktualisieren, starten, stoppen, blacklisten)

Auto-Blacklist

Standardmäßig dry_run: true -- Vorschau vor der Ausführung

Ratenbegrenzung

Respektiert die Ratenbegrenzungen der PropellerAds-API

Keine Datenspeicherung

Der Server ist zustandslos; es werden lokal keine Daten gespeichert


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.

LinkedIn Website GitHub


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.

Available Tools

21 tools
add_to_blacklistC

Add zones to campaign blacklist.

Inputs: campaign_id (required), zone_ids (required).

add_to_whitelistC

Add zones to campaign whitelist.

Inputs: campaign_id (required), zone_ids (required).

auto_blacklist_zonesC

Automatically find and blacklist underperforming zones for a campaign.

Inputs: campaign_id (required), min_spend, max_conversions, date_from, +2 more.

clone_campaignC

Create a copy of an existing campaign.

Inputs: campaign_id (required), new_name.

compare_periodsC

Compare performance between two time periods.

Inputs: period1_from (required), period1_to (required), period2_from (required), period2_to (required), +1 more.

create_campaignC

Create a new advertising campaign with specified settings.

Inputs: name (required), ad_format (required), countries (required), daily_budget (required), +4 more.

find_scaling_opportunitiesC

Find campaigns ready for scaling based on ROI and conversion volume.

Inputs: min_roi, min_conversions, date_from, date_to.

find_top_zonesC

Find best performing zones. Useful for whitelist candidates.

Inputs: campaign_id (required), min_conversions, min_roi, limit, +2 more.

find_underperforming_zonesB

Find zones that are spending money but not converting. Useful for blacklist candidates.

Inputs: campaign_id (required), min_spend, max_conversions, date_from, +1 more.

get_ad_formatsB

Get list of available ad formats.

Inputs: no named parameters.

get_available_countriesB

Get list of available countries for targeting.

Inputs: no named parameters.

get_balanceB

Get current account balance.

Inputs: no named parameters.

get_campaign_detailsB

Get complete details for a specific campaign including targeting, creatives, and settings.

Inputs: campaign_id (required).

get_campaign_performanceC

Get performance summary for a specific campaign with calculated metrics and insights.

Inputs: campaign_id (required), date_from, date_to.

get_creative_performanceC

Get performance statistics for creatives.

Inputs: campaign_id, date_from, date_to.

get_performance_reportC

Get detailed performance statistics with metrics like impressions, clicks, conversions, spend, CTR, CVR, CPC, CPA, and ROI.

Inputs: date_from, date_to, group_by, campaign_id.

get_zone_performanceB

Get performance statistics grouped by zone/placement. Useful for whitelist/blacklist optimization.

Inputs: campaign_id, date_from, date_to, limit, +1 more.

list_campaignsB

List all campaigns with optional filters. Returns campaign ID, name, status, ad format, and basic metrics.

Inputs: status, ad_format, name.

start_campaignsC

Activate/start one or more campaigns.

Inputs: campaign_ids (required).

stop_campaignsC

Pause/stop one or more campaigns.

Inputs: campaign_ids (required).

update_campaignC

Update campaign settings like budget, bid, targeting, or status.

Inputs: campaign_id (required), name, daily_budget, total_budget, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes with clear boundaries, such as campaign management (create, clone, update, start, stop), performance analysis (get_campaign_performance, get_performance_report), and zone optimization (find_top_zones, find_underperforming_zones). However, some overlap exists between get_campaign_performance and get_performance_report, which could cause confusion about which to use for campaign-specific metrics.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as create_campaign, list_campaigns, get_balance, and find_top_zones. All tools use snake_case without deviation, making them predictable and easy to parse for agents.

    Tool Count4/5

    With 21 tools, the count is slightly high but reasonable for the comprehensive advertising campaign management domain. It covers campaign lifecycle, performance reporting, and optimization tasks, though it borders on being heavy compared to typical well-scoped servers (3-15 tools).

    Completeness5/5

    The toolset provides complete coverage for the advertising campaign domain, including CRUD operations (create, list, get, update, clone), lifecycle management (start, stop), performance analysis (various get and compare tools), and optimization features (blacklist/whitelist, scaling, zone analysis). No obvious gaps are present, enabling agents to handle end-to-end workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.
      54
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage Google Ad Manager campaigns, line items, creatives, and advertisers through natural language, automating ad operations that normally require countless clicks through the UI.
      35
      58 PyPI
      20
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive management of Google Ads campaigns through natural language, including campaign creation, ad group management, keyword operations, Performance Max campaigns, conversion tracking, and performance insights with support for multiple accounts.
      3
      -
    • A
      license
      C
      quality
      C
      maintenance
      Enables managing your entire AdButler advertising account from any AI assistant, exposing over 600 tools covering the full AdButler v2 API for display ads, video, targeting, reporting, programmatic, and more, plus pre-built workflow prompts.
      100
      150 npm
      1
      MIT