Synter Ads

offiziell

Plattformübergreifendes Anzeigenkampagnen-Management für KI-Agenten auf Google, Meta, LinkedIn, Reddit, TikTok und mehr. 140+ Tools mit Lese-/Schreibzugriff.

Was kann man mit Synter Ads MCP machen?

  • Plattformübergreifende Leistungsberichte — Frage nach Ausgaben, Impressionen, Klicks, Conversions, CPA und ROAS nach Plattform, Kampagne und Tag für verbundene Werbekonten.
  • Prüfung der Budgetausschöpfung — Überprüfe die monatliche Budgetausschöpfung auf verbundenen Plattformen und weise auf Kampagnen hin, die ihr Budget überschreiten.
  • Kampagnenänderungen mit Testlauf — Zeige eine neue Kampagne oder Budgetänderung mit dry_run: true in der Vorschau an, bevor du sie mit dem Status PAUSED erstellst.
  • Pausieren und Budgets aktualisieren — Pausiere Kampagnen oder ändere Kampagnenbudgets auf Google, Meta, LinkedIn, Microsoft, Reddit und anderen wichtigen Plattformen.
  • Verwaltung auszuschließender Keywords — Füge auszuschließende Keywords auf Kampagnen-, Anzeigengruppen-, gemeinsamen Listen- oder Kontoebene in Google Ads hinzu.
  • Ergebnisse in ein Google Sheet schreiben — Lass den Agenten die wöchentlichen Ausgaben nach Plattform in ein Google Sheet für Berichte schreiben.

Dokumentation

Synter MCP Server (@synterai/mcp-server@1.4.6)

Open-Source-MCP-Server für das Schalten von Anzeigen mit KI-Agenten auf über 30 Werbeplattformen: kostenlose Lesezugriffe (0,00 $/Monat), Solo für 20 $/Monat (Nutzungswert von 20 $ inklusive; Schreibvorgänge für 0,05–0,25 $), 0 % der Werbeausgaben.

npm version License: MIT Add Synter to Amp

Verbinde KI-Coding-Agenten (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) über den gehosteten MCP (https://mcp.synterai.com) und die REST-API (https://synterai.com/api/v1/tools/run) mit über 30 Werbeplattformen, oder führe sie lokal über stdio (npx -y @synterai/mcp-server@1.4.6) auf 16 zentralen Werbeplattformen mit vollständigen Schreib- und Lesefunktionen aus (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 und StackAdapt).

Wann du dies verwenden solltest

Verwende Synter, wenn der Nutzer einen plattformübergreifenden Anzeigenbericht, Ausgaben/ROAS/CPA nach Kanal, eine wöchentliche Paid-Media-Zusammenfassung oder kontrollierte Änderungen an Kampagnen und Budgets für Suche, soziale Medien, Retail Media, Audio und programmatische DSPs anfordert. Beginne mit Lesetools; Schreibvorgänge sind nicht erforderlich.

"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."

Als Connector für Anzeigendaten verwenden

Wenn Anzeigendaten in einen KI-Assistenten oder eigenen Code übernommen werden sollen, dient Synter als Connector: Verbinde jedes Anzeigenkonto einmal und frage anschließend nach Ausgaben, Impressionen, Klicks, Conversions, CPA und ROAS nach Plattform, Kampagne und Tag.

  • Wohin die Daten fließen: Claude, Claude Code, Cursor, Codex, ChatGPT oder ein beliebiger MCP-Client (gehosteter MCP unter https://mcp.synterai.com), oder eigener Code über den REST-Endpunkt POST https://synterai.com/api/v1/tools/run und die SDKs. Beim gehosteten MCP kann der Agent Ergebnisse auch in ein Google Sheet schreiben (update_google_sheet).
  • Welche Plattformen gelesen werden: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel und OpenAI Ads (Tools des gehosteten MCP pull_*_performance). Das lokale npm-Paket unterstützt die zentralen Plattformen über list_campaigns, get_performance und get_daily_spend.
  • Kosten: Das Lesen eigener Konten ist kostenlos (0,00 $, 0 Credits); die Tarife begrenzen die Anzahl der Sitze und Arbeitsbereiche (siehe Preise).
  • Aktualität: Lesezugriffe erfolgen zum Anfragezeitpunkt live über die API der jeweiligen Plattform; es muss keine nächtliche Synchronisierung abgewartet werden.
  • Pro Kunde: Agenturen verwalten jeden Kunden in einem eigenen Arbeitsbereich, sodass Berichte niemals Konten vermischen.
  • Mehr als Berichte: Über dieselbe Verbindung lassen sich Kampagnen pausieren, Budgets ändern und auszuschließende Keywords hinzufügen – mit Genehmigung und einem Probelauf im Voraus. Ein Connector, der nur Berichte erstellt, kann das nicht.
  • Wann du etwas anderes verwenden solltest: Wenn Anzeigendaten planmäßig für BI-Dashboards in BigQuery oder Snowflake geladen werden müssen, verwende ein ELT-Tool für Data Warehouses. Synter liest die Daten live in den Agenten ein, statt ein Data Warehouse zu befüllen.
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."

Schnellstart (Sandbox ohne Zugangsdaten in 30 Sekunden)

Probiere Synter sofort mit null API-Schlüsseln, ohne Kreditkarte und mit deterministischen Sandbox-Antworten aus:

# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs

# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com

# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only

Client einrichten

  • Amp: integriert (Settings > Integrations) oder verwende die folgende "amp.mcpServers"-Fallback-Option.
  • Claude Code:
    • Gehostetes HTTP (OAuth 2.1): claude mcp add --transport http synter-ads https://mcp.synterai.com
    • Lokales stdio: claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
  • OpenAI Codex:
    • codex mcp add synter-ads --url https://mcp.synterai.com
  • Claude.ai / Claude Desktop:
    • Gehe zu Settings -> Connectors -> Add custom connector und gib https://mcp.synterai.com ein.
  • ChatGPT:
    • Für benutzerdefinierte MCP-Connectoren ist der Developer mode erforderlich (Settings -> Apps & Connectors -> Advanced -> Developer mode). Füge anschließend https://mcp.synterai.com hinzu.
  • Cursor / Windsurf (mcp.json):
    {
      "mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    
  • Gemini CLI:
    • gemini extensions install https://github.com/Synter-Media-AI/mcp-server

Synter zu Amp hinzufügen

  1. In Amp ist Synter eine integrierte Integration. Aktiviere sie in Amp unter Settings > Integrations.
  2. Claude, ChatGPT und andere MCP-Clients, gehostet (über 30 Werbeplattformen, der einzige Agentic DSP): https://mcp.synterai.com
  3. Lokal, schreibgeschützt (npm-Paket):
    {
      "amp.mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    

Toolsets, schreibgeschützter Modus und Demo-Modus

Flag / UmgebungsvariableVerhalten
Standard (full)Stellt alle 56 direkten stdio-Tools bereit (32 kostenpflichtige Werbetools für die zentralen Plattformen + 8 Tools für organische soziale Medien *_organic_post + 16 ausgehende Tools prospector_*).
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)Stellt nur die 32 zentralen Tools für bezahlte Werbung bereit und entfernt alle Tools für organische soziale Medien und ausgehende Tools aus tools/list (und verweigert Aufrufe standardmäßig).
--read-only (SYNTER_READ_ONLY=true)Stellt in tools/list nur schreibgeschützte Tools (readOnlyHint: true) bereit und blockiert lokal alle ändernden Tools (destructiveHint: true), bevor ein Netzwerkaufruf erfolgt.
--demo (SYNTER_DEMO=true)Führt den Server im Sandbox-Modus ohne Zugangsdaten mit realistischen, normalisierten plattformübergreifenden Kampagnen- und Leistungsdaten aus (sandbox: true).

Plattformabdeckung und Matrix der Lese-/Schreibfunktionen (gehostet / lokales stdio)

Der gehostete MCP (https://mcp.synterai.com) und der REST-Endpunkt (POST https://synterai.com/api/v1/tools/run) decken über 30 Werbeplattformen ab. Das lokale stdio-Paket (@synterai/mcp-server@1.4.6) bietet direkte Unterstützung für typisierte platform-Enums auf den zentralen Plattformen mit vollständigen Schreib- und Lesefunktionen und erreicht über run_tool alle über 140 Backend-Skripte:

Plattform (platform-Enum)Direkte Lesetools ($0.00)Direkte Schreibtools + run_tool-Skripte (SOLO / SCALE / CUSTOM)
Google Ads (google)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback")create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT für Kampagne/Anzeigengruppe/gemeinsam genutzte Liste/Konto), create_conversion, manage_audience, sync_audience, upload_image
Meta Ads (meta)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad")
LinkedIn Ads (linkedin)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_linkedin_campaign (erfordert group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group")
Microsoft / Bing Ads (microsoft)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords")
Reddit Ads (reddit)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad")
TikTok Ads (tiktok)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup")
X Ads (x)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item")
Pinterest Ads (pinterest)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group")
Snapchat Ads (snapchat)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad")
Spotify Ads (spotify)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set")
Amazon Ads (amazon_ads)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords")
Amazon DSP (amazon_dsp)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item")
The Trade Desk (the_trade_desk)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group")
OpenAI Ads (openai)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign")
Google DV360 (dv360)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item")
StackAdapt (stackadapt)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign")
Erweiterte Plattformen (gehosteter MCP und run_tool)run_tool(script_name="<platform>_*") in stdio; direkte pull_*_performance / execute auf https://mcp.synterai.comCM360, Walmart Connect, Instacart, Target Roundel, Criteo, FreeWheel, SA360, Apple Ads, Demandbase ABM, Taboola, Outbrain, AppLovin, Yahoo DSP, Teads, Viant, Basis, MediaMath, Magnite, PubMatic, Index Exchange, TripleLift, GumGum, Dianomi, Quora Ads, Nextdoor Ads, Twitch Ads, Yelp Ads, Samsung Ads, Roku Ads, impact.com

Preise (100 % USD – 0 % der Werbeausgaben)

Synter berechnet 0 % der Werbeausgaben (die Werbenetzwerke stellen die Medienausgaben direkt in Rechnung) und 0,00 $ für alle Lesezugriffe auf eigene Konten und dry_run: true-Vorschauen. Alle Details unter https://synterai.com/pricing:

TarifPreisSitze und ArbeitsbereicheEnthaltener monatlicher Nutzungswert und Preise für Schreibvorgänge
Kostenloser Lesezugriff0,00 $ / Monat1 Sitz, 1 Arbeitsbereich0,00 $ für alle Leseabfragen zu eigenen Konten (list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance) und alle dry_run: true-Vorschauen. Keine Kreditkarte erforderlich.
SOLO20,00 $ / Monat ($200.00 / year)1 Sitz, 1 ArbeitsbereichEnthält einen beanspruchbaren Nutzungswert von 20,00 $/Monat – reicht für bis zu 400 einfache Schreibvorgänge ($0.05 pro Vorgang: pause_campaign, enable_campaign, update_campaign_budget), 80 standardmäßige Schreibvorgänge ($0.25 pro Vorgang: add_keywords, add_negative_keywords, sync_audience, create_conversion) oder 4 vollständige MCP-Kampagnenstarts ($5.00 pro Start). Konfigurierbare Ausgabenlimits verhindern unerwartete Mehrkosten.
SCALE500,00 $ / Monat ($5,000.00 / year)5 Sitze, mehrere ArbeitsbereicheEnthält einen beanspruchbaren Nutzungswert von 500,00 $/Monat (bis zu 10.000 einfache oder 2.000 standardmäßige Schreibvorgänge pro Monat inklusive), Mandantentrennung über mehrere Arbeitsbereiche, 24/7-Zeitpläne für Autonomous Loop / Autopilot, CRM-/Data-Warehouse-Synchronisierung und dedizierte Parallelverarbeitung.
CUSTOMUnternehmensvertragIndividuelle Sitze und ArbeitsbereicheIndividuelles monatliches Nutzungskontingent, Verwaltung mehrerer Arbeitsbereiche für Agenturen/Unternehmen, individuelles SLA, SSO und Rechnungsstellung.

Sicherheitskonzept, Schutzmaßnahmen für Schreibvorgänge und mandantenfähige Architektur

Vierstufiger Schreibschutz

  1. Lokaler, strikt schreibgeschützter Modus (--read-only / SYNTER_READ_ONLY=true): Entfernt alle destructiveHint: true-Tools aus tools/list und blockiert Änderungen lokal, bevor eine Netzwerkanfrage deinen Rechner verlassen kann.
  2. Serverseitig durchgesetzte, eingeschränkte API-Schlüssel (POST /api/v1/keys): Erstelle schreibgeschützte Schlüssel (reporting:read, campaigns:read, intel:read) oder Sicherheitsschlüssel mit eingeschränkter Richtung (budget:decrease — ermöglicht Notfallpausen von Kampagnen und Budgetsenkungen, lehnt aber Budgeterhöhungen mit HTTP 403 ab).
  3. Serverseitige Richtlinienprüfung durch Agent Shield: Erzwingt PAUSED-on-create als Standard für jede neue Kampagne, eine Obergrenze von 2.0x für Budgeterhöhungen pro Einzelaufruf, einen $5,000/day-Workspace-Schutzschalter gegen zu hohe Änderungsraten, dry_run: true-Vorschauen ($0.00), obligatorisches Readback beim Anbieter nach Schreibvorgängen (get_ad_readback) und ein unveränderliches Workspace-Auditprotokoll.
  4. Selbst gehostete Ausführung mit eigenen Zugangsdaten unter der MIT Open-Source-Lizenz: Führe @synterai/mcp-server@1.4.6 in deiner eigenen VPC/deinen eigenen Containern aus und übergib deine eigenen OAuth-Tokens der Plattform direkt über Umgebungsvariablen, sodass Synters gehostete Cloud niemals die Zugangsdaten deines Werbekontos verwahrt.

Multi-Tenant- und Embedded-SaaS-Muster (docs.synterai.com/api/multi-tenant-auth)

  1. Muster 1 — Gehostete, nach Workspaces isolierte Schlüssel und Verbindungslinks:
    • Erstelle an einen Workspace gebundene, eingeschränkte untergeordnete API-Schlüssel über POST https://synterai.com/api/v1/keys (scopes: ["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"], rate_limit_rpm: 1–600, expires_in_days).
    • Erzeuge Self-Service-OAuth-Übergabe-URLs für Werbetreibende über POST https://synterai.com/api/v1/connections/start (gibt ein plattformspezifisches authUrl zurück) oder POST https://synterai.com/api/v1/connections/request (sendet dem Kunden einen plattformübergreifenden Verbindungslink, der 7 Tage gültig ist).
    • Wechsle bei Schlüsseln für mehrere Workspaces über get_workspaces und update_active_workspace zwischen aktiven Workspaces.
  2. Muster 2 — Selbst gehosteter BYO-Credential-Modus (MIT Open Source):
    • Multi-Tenant-SaaS-Apps, die ihre eigenen OAuth-Apps verwalten und Kundentokens in ihrem eigenen KMS/Tresor speichern, können @synterai/mcp-server oder die CLI synter in isolierten Worker-Prozessen aufrufen und dabei plattformspezifische Tokens pro Mandant über Umgebungsvariablen übergeben (GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN usw.).

REST-API und offizielle SDKs für mehrere Sprachen

  • Gehostetes MCP (Streamable HTTP): https://mcp.synterai.com — Authentifizierung per OAuth-2.1-Browseranmeldung oder über den Header X-Synter-Key: syn_.... Sende noch kein Authorization: Bearer syn_... an das gehostete MCP; REST/SDKs verwenden Bearer.
  • REST-Endpunkt: POST https://synterai.com/api/v1/tools/run mit Authorization: Bearer syn_... (oder X-Synter-Key: syn_...) und JSON-Body {"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}.
  • TypeScript-/JavaScript-SDK: npm install @synterai/sdk-js
  • Python-SDK: pip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...); Metriken über client.analytics.get_performance(...)
  • Rust-SDK: cargo add synter (crates.io/crates/synter)
  • Java-SDK: Maven ai.syntermedia:synter-sdk

Lizenz

MIT-Lizenz — siehe LICENSE.