KonQuest Meta Ads MCP · MCP Server

Beschreibung des Anbieters

Supervised Meta Ads operating system for Claude Code with 57 campaign management tools.

Werkzeuge

get_ads

List ads for an account, campaign, or ad set. Args: account_id: Ad account ID (e.g., 'act_123456789'). campaign_id: Optional - filter ads by campaign.… Angabe des Anbieters · Beleg 5

get_ad_details

Get detailed ad information including creative reference, tracking specs, conversion specs, issues, and recommendations. Args: ad_id: Ad ID (numeric string). Angabe des Anbieters · Beleg 5

create_ad_from_manifest

Create an ad from a manifest entry (always PAUSED, manifest-driven, no exceptions).… Angabe des Anbieters · Beleg 5

update_ad

Update an existing ad. Supervised write - validates before applying.… Angabe des Anbieters · Beleg 5

upload_video_resumable

Upload a video file using resumable upload (supports files >100MB up to 4GB). Use this for large files that fail with upload_video_asset.… Angabe des Anbieters · Beleg 6

bulk_rename_objects

Rename multiple Meta Ads objects in one call. Args: renames_json: JSON array of rename specs: [{object_id: '...', new_name: '...', object_type: 'campaign|adset|ad'}, ...] Angabe des Anbieters · Beleg 6

delete_campaign_structure

Delete entire campaign structure (ads -> adsets -> campaigns) in correct order. Args: account_id: Ad account ID. campaign_ids_json: JSON array of campaign IDs to delete.… Angabe des Anbieters · Beleg 6

diagnose_pixel_on_site

Diagnose pixel installation on a website via headless browser check. Checks: pixel script presence, consent/cookie blocking, Lead event setup, Complianz/cookie banner status.… Angabe des Anbieters · Beleg 6

resolve_page_identity

Resolve full identity for a Facebook Page: page details + Instagram business account. Uses the 3-step IG resolution ladder (registry -> promote_pages -> ad account).… Angabe des Anbieters · Beleg 6

run_setup_check

Check MCP setup readiness and return structured results. Validates token, permissions, account access, pages, Instagram identity, pixels, and local configuration.… Angabe des Anbieters · Beleg 7

upload_video_asset

Upload a local video file to a Meta ad account. Validates the file, uploads via simple upload (for files < 1GB), and returns the meta_video_id for use in ad creation.… Angabe des Anbieters · Beleg 8

poll_video_processing

Poll video processing status until ready, failed, or max attempts reached. Args: video_id: Meta video ID from upload_video_asset.… Angabe des Anbieters · Beleg 8

get_adsets

List ad sets for an account or filtered by campaign. Args: account_id: Ad account ID (e.g., 'act_123456789').… Angabe des Anbieters · Beleg 9

get_adset_details

Get detailed ad set information including targeting, optimization, learning stage, frequency caps, and attribution settings. Args: adset_id: Ad set ID (numeric string). Angabe des Anbieters · Beleg 9

create_adset

Create a new ad set (always PAUSED, no exceptions).… Angabe des Anbieters · Beleg 9

update_adset

Update an existing ad set. Supervised write - validates before applying.… Angabe des Anbieters · Beleg 9

upload_ad_image

Upload an image from URL into Meta ad images library. Downloads the image from the provided URL, then uploads it to Meta via multipart form upload.… Angabe des Anbieters · Beleg 10

get_ad_image

Retrieve metadata and URL for an uploaded ad image by hash. Returns the image URL, dimensions, name, and other metadata. Args: account_id: Ad account ID (e.g., 'act_123456789').… Angabe des Anbieters · Beleg 10

generate_names

Generate correctly named Meta Ads object following naming convention.… Angabe des Anbieters · Beleg 11

get_pixel_info

Get pixel status, connections, last fired time, and availability. Args: pixel_id: Pixel ID (numeric string). Angabe des Anbieters · Beleg 12

get_pixel_events

Get events received by a pixel in the last 24 hours, broken down by event type and hourly counts. Args: pixel_id: Pixel ID (numeric string). Angabe des Anbieters · Beleg 12

get_event_stats

Get event statistics with archetype-aware diagnostic analysis. Checks event coverage, parameter completeness, diagnostic flags, and classifies overall tracking health.… Angabe des Anbieters · Beleg 12

send_test_event

Send a test event via the Conversions API Test Events endpoint. Args: pixel_id: Pixel ID (numeric string). event_name: Event name to send (default 'PageView').… Angabe des Anbieters · Beleg 12

run_tracking_diagnostic

Run comprehensive tracking diagnostic for an ad account. Checks all connected pixels, event coverage, parameter completeness, and Meta diagnostic flags.… Angabe des Anbieters · Beleg 12

check_token_status

Check Meta API token health, permissions, and rate limit status. Returns token validity, granted permissions, missing permissions, and current rate limit usage percentage. Angabe des Anbieters · Beleg 13

get_ad_accounts

List all ad accounts accessible to the authenticated user. Returns account IDs, names, statuses, currencies, and timezones for all accounts in your business portfolio.… Angabe des Anbieters · Beleg 13

get_account_info

Get detailed information about a specific ad account. Returns account configuration, status, spend data, pixel info, and connected assets.… Angabe des Anbieters · Beleg 13

get_account_pages

List Facebook Pages available for ads on a specific ad account. Args: account_id: Ad account ID (e.g., 'act_123456789'). Angabe des Anbieters · Beleg 13

get_instagram_identities

List Instagram accounts available for ads on a specific ad account. Returns instagram_user_id (the canonical identifier) for each account.… Angabe des Anbieters · Beleg 13

discover_all_accounts

Discover all ad accounts, their pages, pixels, and Instagram accounts. Used to generate or update the account registry (config/accounts.yaml).… Angabe des Anbieters · Beleg 13

Voraussetzungen

• META_ACCESS_TOKEN · Umgebungsvariable · erforderlich · Beleg 1
• uvx · Paketmanager · erforderlich · Beleg 1
• META_APP_SECRET · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 14
• META_APP_ID · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 14
• VAULT_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 7

Installation

uvx konquest-meta-ads-mcp==2.0.0

Angaben zum Baustein

—: Angabe nicht belegt.

Maintainer

brandu-mos

Repository-Lizenz

MIT

Letzter Repository-Commit

2026-04-23

Commit innerhalb zwölf Monaten

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

Meta Ads

Bereiche

Marketing, Entwicklung, Vertrieb, Kommunikation

Plattformen

—

Version

2.0.0

Release

v2.0.0

Clients

Claude Code

Repository-Themen

claude-code, facebook-ads, instagram-ads, mcp, mcp-server, meta-ads, meta-marketing-api, model-context-protocol, open-core, python

Zugriffe und Risiken

Regelbasiert abgeleitete Zugriffe

lesen, schreiben, löschen, senden

Authentifizierung

Token

Transport

stdio

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe. Vor dem Einsatz Konten, Dateien, Netzwerkverbindungen und Ausführungsrechte im konkreten Paket prüfen. Eine frische Änderung am Repository belegt keine Wartung jeder einzelnen Datei.

Nur die für den Arbeitsablauf nötigen Berechtigungen vergeben und Schreibaktionen mit einem Freigabeschritt absichern. Lizenz und Wartungsdatum sind keine Sicherheitsfreigabe.

Der Lizenzbeleg betrifft das Quellcode-Repository. Einzelne Unterpakete und gehostete Dienste können eigene Bedingungen haben; prüfe sie beim konkreten Installations- oder Diensteangebot.