PropellerAds MCP Server
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
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 |
| Alle Kampagnen mit optionalen Filtern auflisten | -- |
| Vollständige Kampagneninfos abrufen (Targeting, Creatives, Einstellungen) |
|
| Eine neue Werbekampagne erstellen |
|
| Kampagneneinstellungen ändern (Budget, Gebot, Name, Status) |
|
| Eine oder mehrere pausierte Kampagnen aktivieren |
|
| Eine oder mehrere aktive Kampagnen pausieren |
|
| Eine bestehende Kampagne duplizieren |
|
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 |
| Detaillierte Statistiken mit berechneten Metriken (CTR, CVR, CPC, CPA, ROI) | -- |
| Leistungszusammenfassung für eine bestimmte Kampagne |
|
| Zwei Zeiträume mit Veränderungsindikatoren vergleichen |
|
| Analytik auf Zonen-/Platzierungsebene, sortierbar | -- |
| 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 |
| Zonen finden, die Geld ausgeben, ohne zu konvertieren (Blacklist-Kandidaten) |
|
| Bestleistung erbringende Zonen finden (Whitelist-Kandidaten) |
|
| Kampagnen finden, die bereit für eine Skalierung sind (hoher ROI + Volumen) | -- |
| Schlechte Zonen in einem Schritt finden und blacklisten (standardmäßig Testlauf) |
|
Targeting
Tool | Beschreibung | Erforderliche Parameter |
| Zonen zur Whitelist einer Kampagne hinzufügen |
|
| Zonen zur Blacklist einer Kampagne hinzufügen |
|
Konto
Tool | Beschreibung | Erforderliche Parameter |
| Aktuellen Kontostand prüfen | -- |
| Alle für das Targeting verfügbaren Länder auflisten | -- |
| Verfügbare Werbeformate auflisten (push, onclick, etc.) | -- |
Tech-Stack
Komponente | Technologie |
Laufzeit | Python 3.10+ |
Protokoll | |
HTTP-Client | |
Validierung | Pydantic v2 |
API | |
Build-System | |
Transport | stdio (Standard-MCP-Transport) |
Schnellstart
Voraussetzungen
PropellerAds-Konto mit API-Zugriff
Mindestanforderung: 1.000 $ Gesamtausgaben oder Einzahlung
API-Token abrufen: https://ssp.propellerads.com/#/app/profile
Python 3.10+
Claude Desktop oder Claude Code (oder ein beliebiger MCP-kompatibler Client)
Installation
Option 1: Installation über PyPI (Empfohlen)
pip install propellerads-mcpOption 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.jsonWindows:
%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_mcpStellen 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_mcpDer 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.mdSicherheit & 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 |
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:
Forken Sie das Repository
Erstellen Sie einen Feature-Branch (
git checkout -b feature/my-feature)Commiten Sie Ihre Änderungen (
git commit -m "Add my feature")Pushen Sie auf Ihren Branch (
git push origin feature/my-feature)Ö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.
Available Tools
21 toolsadd_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
Scored across 21 tools
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.
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.
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).
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
Related MCP Connectors
Build, edit and sync Google, Microsoft, Reddit and Meta ad campaigns from your assistant.
Manage and optimize your ads on Meta, Google, TikTok, X, ChatGPT Ads, Reddit and LinkedIn from chat.
Manage Google, Meta, TikTok, Microsoft, Pinterest, Amazon, LinkedIn & Reddit ads from your AI
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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.54MIT
- AlicenseAqualityDmaintenanceEnables 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.3558 PyPI20MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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-

AdButler MCP Serverofficial
AlicenseCqualityCmaintenanceEnables 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.100150 npm1MIT