AI-Act-CheckKalenderChangelog
Menü

Meta-Werbekonten und Kampagnen lesen und ändern

facebook-ads-mcp-server · MCP-Server von gomarble-ai · MCP-Server

MCP-Server für Meta Ads · lesen und schreiben · MIT

Liest und schreibtWas der Baustein im Konto darf

Greift per Meta-Zugriffstoken auf Werbekonten, Kampagnen, Anzeigengruppen und Anzeigen samt Performance-Kennzahlen zu. Auch den Änderungsverlauf liest er aus.

Eigenes Profil aus den Quellen des Servers, Stand 05.10.2026 · Beleg 6

Was der Server kann

  • Werbekonten des Tokens auflisten und Kontodetails abrufen.
  • Kampagnen, Anzeigengruppen, Anzeigen und Creatives einzeln oder je Konto, Kampagne und Anzeigengruppe lesen.
  • Performance-Insights für Konto, Kampagne, Anzeigengruppe und Anzeige abrufen.
  • Den Änderungsverlauf eines Kontos oder einer Anzeigengruppe lesen.
  • Folgeseiten großer Ergebnisse über eine Pagination-URL nachladen.

Einsatz in Marketing und Vertrieb

Performance-Marketing
Der Assistent listet die Kampagnen eines Kontos, ruft deren Insights für einen Zeitraum ab und stellt die Ergebnisse nebeneinander.
Reporting
Für einen Wochenbericht liest der Assistent die Insights je Anzeigengruppe aus und prüft im Änderungsverlauf, ob Anpassungen die Entwicklung erklären.

Einrichtung

  1. Python 3.10 oder neuer bereitstellen und die Abhängigkeiten mit `pip install -r requirements.txt` installieren.
  2. Meta-Zugriffstoken mit den nötigen Rechten, etwa `ads_read`, besorgen.
  3. In der Client-Konfiguration `python` mit dem Pfad zu `server.py` und den Argumenten `--fb-token` plus Token eintragen und den Client neu starten.
  4. Alternativ bietet der Autor einen Installer unter gomarble.ai/mcp an.

Grenzen

  • Die in der README aufgeführten Werkzeuge sind lesend; Kampagnen anlegen oder ändern ist nicht dabei.
  • Läuft das Token ab, muss ein neues in die Client-Konfiguration eingetragen werden.
  • Beim Installer ohne eigenes Token erzeugt der GoMarble-Server das Token im Auftrag des Nutzers; es wird laut README lokal gespeichert.

Einordnung der Redaktion

Aufgaben: Anzeigen schalten, Auswerten & berichten. Für Marketing und Vertrieb gedacht.

Eigene Einordnung aus Name und Beschreibung des Anbieters, ohne technische Prüfung. Maßgeblich ist der Text des Anbieters.

Eckdaten

—: Angabe nicht belegt.

Maintainer
gomarble-ai
Repository-Lizenz
MIT
Letzter Repository-Commit

Commit innerhalb 90 Tagen

Dienstanbieter
Offizielle Dienstherkunft nicht belegt
Dienste
Meta Ads
Bereiche
Marketing
Plattformen
—

Werkzeuge

list_ad_accounts

Listet die mit dem Token verbundenen Werbekonten.

List down the ad accounts and their names associated with your Facebook account. CRITICAL: This function MUST automatically fetch ALL pages using pagination.… Angabe des Anbieters · Beleg 4
get_campaigns_by_adaccount

Liefert die Kampagnen eines Werbekontos.

Retrieves campaigns from a specific Facebook ad account.… Angabe des Anbieters · Beleg 4
get_adsets_by_campaign

Liefert die Anzeigengruppen einer Kampagne.

Retrieves ad sets associated with a specific Facebook campaign.… Angabe des Anbieters · Beleg 4
get_ads_by_adset

Liefert die Anzeigen einer Anzeigengruppe.

Retrieves ads associated with a specific Facebook ad set. This function allows querying all ads belonging to a specific ad set, with filtering options, pagination, and field selection.… Angabe des Anbieters · Beleg 4
get_ad_creatives_by_ad_id

Liefert die Creatives einer Anzeige.

Retrieves the ad creatives associated with a specific Facebook ad.… Angabe des Anbieters · Beleg 4
get_adaccount_insights

Liefert Performance-Insights eines Werbekontos.

Retrieves performance insights for a specified Facebook ad account.… Angabe des Anbieters · Beleg 4
get_campaign_insights

Liefert Performance-Insights einer Kampagne.

Retrieves performance insights for a specific Facebook ad campaign.… Angabe des Anbieters · Beleg 4
get_ad_insights

Liefert Performance-Insights einer Anzeige.

Retrieves detailed performance insights for a specific Facebook ad.… Angabe des Anbieters · Beleg 4
get_activities_by_adaccount

Liefert den Änderungsverlauf eines Werbekontos.

Retrieves activities for a Facebook ad account.… Angabe des Anbieters · Beleg 4
fetch_pagination_url

Lädt Daten von einer Pagination-URL nach.

Fetch data from a Facebook Graph API pagination URL Use this to get the next/previous page of results from an insights API call. Args: url: The complete pagination URL (e.g.… Angabe des Anbieters · Beleg 4
get_details_of_ad_account
Get details of a specific ad account as per the fields provided Args: act_id: The act ID of the ad account, example: act_1234567890 fields: The fields to get from the ad account.… Angabe des Anbieters · Beleg 4
get_adset_insights
Retrieves performance insights for a specific Facebook ad set. Provides advertising performance statistics for an ad set, allowing for analysis of metrics across its child ads.… Angabe des Anbieters · Beleg 4
get_ad_creative_by_id
Retrieves detailed information about a specific Facebook ad creative.… Angabe des Anbieters · Beleg 4
get_ad_by_id
Retrieves detailed information about a specific Facebook ad by its ID.… Angabe des Anbieters · Beleg 4
get_ads_by_adaccount
Retrieves ads from a specific Facebook ad account.… Angabe des Anbieters · Beleg 4
get_ads_by_campaign
Retrieves ads associated with a specific Facebook campaign.… Angabe des Anbieters · Beleg 4
get_adset_by_id
Retrieves detailed information about a specific Facebook ad set by its ID.… Angabe des Anbieters · Beleg 4
get_adsets_by_ids
Retrieves detailed information about multiple Facebook ad sets by their IDs.… Angabe des Anbieters · Beleg 4
get_adsets_by_adaccount
Retrieves ad sets from a specific Facebook ad account.… Angabe des Anbieters · Beleg 4
get_campaign_by_id
Retrieves detailed information about a specific Facebook ad campaign by its ID.… Angabe des Anbieters · Beleg 4
get_activities_by_adset
Retrieves activities for a Facebook ad set. This function accesses the Facebook Graph API to retrieve information about key updates to an ad set.… Angabe des Anbieters · Beleg 4

Voraussetzungen

  • DEBUG · Umgebungsvariable · optional · Beleg 5
1 Umgebungsvariable laut Anbieter
  • PYTHONPATH · Umgebungsvariable · Beleg 5

Rechte

Liest und schreibt

Einordnung aus Werkzeugliste, Paketangaben und Paketinhalt, keine technische Prüfung · So entsteht die Ampel

  • Alle 21 Werkzeuge der belegten Liste fragen nur Daten ab.
  • Der Anbieter deklariert: lesen und schreiben.

Verbinde zuerst ein Testkonto oder eine Sandbox und lass Änderungen einzeln bestätigen, bevor der Baustein mit echten Daten arbeitet.

Meta-Zugriffstoken, in der README mit Beispiel-Recht ads_read. Die aufgelisteten Werkzeuge lesen Daten. Das Token wird laut Konfigurationsbeispiel als Startargument übergeben und kann ablaufen.

Zugriffe laut Paketangaben
lesen, schreiben
Authentifizierung
—
Transport
—
Technische Prüfung
Ungeprüft
Paket und InstallationshinweiseRepository öffnen
Quellen (6)
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. Abgerufen und Felder geprüft: 2026-10-05; technische Prüfung: ungeprüft
  8. Paketpfad: .

Verbundenes