MCP Ads

Der Open-Source-Marketing-MCP-Server. Betreibe Google Ads, Meta Ads, GA4, Search Console, Tag Manager, WordPress und mehr aus Claude, ChatGPT, Cursor oder jedem beliebigen MCP-Client heraus – lies Performance-Daten aus, prüfe verschwendete Ausgaben, erstelle Berichte und starte Kampagnen (standardmäßig als pausiert erstellt, bis du etwas anderes angibt).

~3.100 registrierte Aktionen über 12+ Plattformen, bereitgestellt durch 17 Kategorie-Dispatcher, sodass dein Agent ~20 Tool-Definitionen lädt statt Tausender.

Wähle deinen Weg

☁️ Cloud – in 2 Minuten verbunden, kostenloser Plan

Geh auf mcp-ads.com, melde dich an, autorisiere deine Ad-Konten per OAuth im Browser und füge eine URL in Claude ein. Fertig.

• Keine API-Anträge, keine Developer-Tokens, keine App Reviews – die Plattform-Freigaben (Google Ads Developer Token, Meta App Review und der Rest) sind bereits eingerichtet

• Gratis-Plan: 30 Tool-Aufrufe/Monat, auf jeder Plattform. Bezahlpläne für unbegrenzte Nutzung

• Deine Zugangsdaten werden verschlüsselt gespeichert; jederzeit widerrufbar über das Dashboard

Das ist die richtige Wahl für fast jede und jeden, die Tools nutzen statt selbst hosten möchten.

🔧 Self-gehostet – für immer kostenlos, deine Schlüssel, deine Maschine

Klone dieses Repo und betreibe es mit deinen eigenen Plattform-Zugangsdaten. MIT-lizenziert, ohne Verpflichtungen, ohne Telefon-Nachrichten. Deine Tokens verlassen nie deinen Rechner.

Der ehrliche Preis: Mehrere Ad-Plattformen verhindern eine Bewerbung für API-Zugriff (siehe Tabelle unten). Wenn du die Zugangsdaten bereits besitzt – etwa als Agentur mit einem Google-Ads-Developer-Token oder als Entwickler mit einer geprüften Meta-App – ist Self-Hosting in Minuten erledigt. Wenn nicht, plane Tage bis Wochen für die eigenen Genehmigungswarteschlangen der Plattformen ein – oder nutz einfach die Cloud.

Derselbe Code, dieselben Aktionen, egal ob lokal oder in der Cloud. Das gehostete Produkt ist genau dieser Server plus Multi-User-Auth und bereits erteilte. Stanzen.

Related MCP server: AdLoop: Google Ads, Reddit Ads & GA4

Self-Hosting Schnellstart

git clone https://github.com/RoyAzran/mcp-ads.git
cd mcp-ads
pip install -r requirements.txt
cp .env.example .env      # fill in the platforms you use
python server.py doctor   # shows what's connected

Füge es dann zu Claude Desktop (claude_desktop_config.json) oder Claude Code (.mcp.json) hinzu:

{
  "mcpServers": {
    "mcp-ads": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-ads/server.py"]
    }
  }
}

Das ist die ganze Installation. Frag deinen Agenten „prüf meine verschwendeten Ausgaben in Google Ads“ und sie ihm zu.

Stattdessen Docker:

cp .env.example .env
docker compose up -d      # HTTP server on 127.0.0.1:8000, MCP endpoint at /mcp

HTTP-Modus ohne Docker: python server.py serve --transport http

OAuth-Helfer für die Plattformen mit Bearer-Token (öffnet einen Browser, speichert und aktualisiert das Token automatisch):

python server.py auth snapchat_ads

Was wirklich von Haus aus funktioniert – ehrlich

Self-Hosting heißt: Du hältst die Schlüssel für jede Plattform selbst. Einige geben sie nach Minuten heraus, bei anderenn musst du dich darum. So sieht die Realität aus:

Wenn dich diese Tabelle müde macht, genau dafür ist die Cloud-Version nützlich – die Fluiditätungen sind schon erledigt, du verbindest nur deine Konten.

So funktioniert die Tool-Oberfläche

Dein Agent sieht einen Dispatcher pro Plattform plus list_actions:

1. list_actions(category="meta_ads_action", search="budget")
2. meta_ads_action(action="<name from step 1>", params={...})

• Schreibaktionen erstellen alles pausiert, es sei denn es wird ausdrücklich ein Start verlangt

• Das Rollengating (permissions.py) trennt Lese- und Schreibtools anhand des Namens

• --surface full registriert stattdessen jede Aktion als eigenes MCP-Tool – nützlich für programmatische Clients, viel zu viele Tools für einen Chat-Cleinten

Die NPX-CLI

Maschine ohne Python? Die CLI ist ein ~300-zeitig-Stdio-Proxy (cli/), der an einen beliebigen MCP-Server weiterleitet:

# against your self-hosted server
MCP_ADS_BASE_URL=http://127.0.0.1:8000 npx -y @marketingmcp/cli

# against the cloud (API key from mcp-ads.com/manage)
MCP_ADS_API_KEY=mcp_live_xxx npx -y @marketingmcp/cli

Ein Hinweis zur Google-Ads-Transparenz

tools/google_ads_transparency.py liest Googles öffentliches Ads-Transparency-Center, indem es die Endpunkte aufruft, die auch die Website selbst. Google dokumentiert keine API für diese Daten; die Endpunkte können sich jederzeit ändern oder Anfragen ohne Vorwarnung ablehnen, und automatisierte Zugriffe auf sie sind nicht von Google abgesegnet. Diese Familie ist standardmäßig deaktiviert – setze GOOGLE_ADS_TRANSPARENCY_ENABLED=true erst, nachdem du das Docstring des Moduls gelesen hast. Die Tools der Meta Ad Library verwenden Metas offizielle API und haben diese Einschränkung nichtö.

Sicherheitsvorkehrungen

• Zugangsdaten kommen aus deiner .env und einem optionalen, mit Ferric verschlüsselten lokalen Speicher (MCP_ADS_SECRET_KEY). Nichts meldet sich nach Hause: Telemetrie ist vollständig opt-in und aus, solange du nicht dein eigenes Analyse-Projekt konfigurierst.

• Der HTTP-Modus ist unauthentiziert – von Design (du bist es, über Loopback). Der Server weigert sich, eine öffentliche Schnittstelle zu binden, es sei denn du setzt MCP_ADS_ALLOW_PUBLIC_BINDERSTRIP=true, weil er Zugangsdaten enthält, die echtes Geld ausgeben können.

• CI führt ein Grenz-Gate (tests/test_no_private_imports.py) aus, das bei jedem, was wie ein Geheimnis aussieht und in den Code-Baum gelangt, fehlschlägt.

Siehe für Meldungen SECURITY.md.

Mitmachen

Issues und PRs werden gerne gesehen – siehe CONTRIBUTING.md. Die Check-Skripte in scripts/ bezeichnen die Richtkante: Jedes davon einen Fehler, der in Produktion tatsächlich aufgetreten ist, und python scripts/check_tools_execute.py vor einem PR fängt einen Großteil dessen, was ein Review auch finden würde.

Das, wobei wir dir nicht geschäft. Plattform-API-Zugänge besorgen. Diese Genehmswarteschlangen liegen bei Google, Meta, LinkedIn, TikTok und Microsoft.