KonQuest Meta Ads MCP server

by brandu-mos·io.github.brandu-mos/konquest-meta-ads-mcp·v2.0.0·44 stars

No reviews yet

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

C69/100grade C

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

C69/100

full report

Adoption

Growing

44 stars13 downloads/wk

Reviews

Write one

Nobody has reviewed KonQuest Meta Ads MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

KonQuest Meta Ads MCP tools (57, 18 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

bulk_rename_objects
Rename multiple Meta Ads objects in one call.
check_token_status
Check Meta API token health, permissions, and rate limit status.
create_ad_creativewrite action
Create a standalone single-image ad creative.
create_ad_from_manifestwrite action
create_adsetwrite action
Create a new ad set (always PAUSED, no exceptions).
create_campaignwrite action
Create a new campaign (always PAUSED, no exceptions).
create_multi_asset_adwrite action
Create an ad with enforced identity, multi-asset support, and verification.
create_product_setwrite action
Create a product set with filter rules for DPA targeting.
delete_campaign_structurewrite action
Delete entire campaign structure (ads -> adsets -> campaigns) in correct order.
diagnose_pixel_on_site
Diagnose pixel installation on a website via headless browser check.
discover_all_accounts
Discover all ad accounts, their pages, pixels, and Instagram accounts.
duplicate_adset
Duplicate a single ad set into a target campaign within the same account.
duplicate_campaign
Duplicate a campaign (and optionally its child ad sets and ads) within the same account.
estimate_audience_size
Estimate audience reach for a targeting specification.
generate_names
Generate correctly named Meta Ads object following naming convention.
get_account_info
Get detailed information about a specific ad account.
get_account_pages
List Facebook Pages available for ads on a specific ad account.
get_ad_accounts
List all ad accounts accessible to the authenticated user.
get_ad_creatives
List ad creatives for an account or specific ad, with image hash resolution.
get_ad_details
Get detailed ad information including creative reference, tracking specs, conversion specs, issues, and recommendations.
get_ad_image
Retrieve metadata and URL for an uploaded ad image by hash.
get_ads
List ads for an account, campaign, or ad set.
get_adset_details
Get detailed ad set information including targeting, optimization, learning stage, frequency caps, and attribution settings.
get_adsets
List ad sets for an account or filtered by campaign.
get_bulk_insights
Get performance insights across all accessible ad accounts in one call.
get_campaign_details
Get detailed information about a specific campaign including budget, objective, bid strategy, special categories, and issues.
get_campaigns
List campaigns for an ad account with status and budget info.
get_catalog_info
Get catalog details including product count, vertical, name, and connected event sources (pixels).
get_catalog_products
List products in a catalog with price, availability, review status, and URLs.
get_creative_details
Get full creative details including mode classification, media URLs, object_story_spec, asset_feed_spec, and degrees_of_freedom_spec.
get_event_stats
Get event statistics with archetype-aware diagnostic analysis.
get_insights
Get performance insights for any Meta Ads object (account, campaign, ad set, or ad).
get_instagram_identities
List Instagram accounts available for ads on a specific ad account.
get_interest_suggestions
Get related interest suggestions from seed interests.
get_pixel_events
Get events received by a pixel in the last 24 hours, broken down by event type and hourly counts.
get_pixel_info
Get pixel status, connections, last fired time, and availability.
get_product_sets
List product sets in a catalog with product counts and filter rules.
list_custom_audiences
List custom audiences for an ad account with type classification, size estimates, delivery status, and diagnostic warnings.
poll_video_processing
Poll video processing status until ready, failed, or max attempts reached.
read_client_vault
Read all client intelligence from the Obsidian vault for ad operations.
resolve_page_identity
Resolve full identity for a Facebook Page: page details + Instagram business account.
run_setup_checkwrite action
Check MCP setup readiness and return structured results.
run_tracking_diagnosticwrite action
Run comprehensive tracking diagnostic for an ad account.
search_behaviors
Search or list behavior-based targeting options.
search_demographics
Search or list demographic targeting options.
search_geo_locations
Search geographic locations for ad targeting.
search_interests
Search for interest-based targeting options.
send_test_eventwrite action
Send a test event via the Conversions API Test Events endpoint.
update_adwrite action
Update an existing ad. Supervised write - validates before applying.
update_ad_creativewrite action
Update an existing ad creative's name.
update_adsetwrite action
Update an existing ad set. Supervised write - validates before applying.
update_campaignwrite action
Update an existing campaign. Supervised write - validates before applying.
update_product_setwrite action
Update a product set name or filter rules.
upload_ad_imagewrite action
Upload an image from URL into Meta ad images library.
upload_video_assetwrite action
Upload a local video file to a Meta ad account.
upload_video_resumablewrite action
Upload a video file using resumable upload (supports files >100MB up to 4GB).
validate_catalog_connections
Validate the catalog-pixel-account-page connection chain and run diagnostic health assessment.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan48 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 158 days ago8/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How KonQuest Meta Ads MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 69/100; higher than 33% of 48,273 servers
Tools: 57; the typical server has 7
Tools that change things: 32%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 44; more than 93% of 28,534 servers
Downloads a week: 13; more than 4% of 11,915 servers with a package

What its tools let an agent do: 38 read · 10 create · 5 change · 1 delete · 1 send or post · 2 run or deploy

Install KonQuest Meta Ads MCP in Claude Code, Cursor or VS Code

claude mcp add konquest-meta-ads-mcp -- uvx konquest-meta-ads-mcp

Add to Cursor

What the publisher says

From the KonQuest Meta Ads MCP repository's README, as published. We do not edit it. Read it on GitHub

KonQuest Meta Ads MCP

Supervised Meta Ads Operating System for Claude Code. You can find the premium version here: https://farasokster.gumroad.com/l/konquest-meta-ads-mcp-premium

Open-Core Model

KonQuest Meta Ads MCP uses an open-core model:

Public (this repo) - 57 tools, MIT license:

Full CRUD for campaigns, ad sets, and ads
Multi-asset ad creation (video + static image, multi-dimension)
Image upload and retrieval
Campaign and ad set duplication
Insights and bulk cross-account analytics
Pixel and tracking diagnostics (5 tools)
Catalog and DPA support (6 tools, including product set create/update)
Full targeting toolkit (6 tools)
Setup readiness checker (42+ checks with fix instructions)
Validation pipeline, naming enforcement, post-write verification
Safety tiers, rate limiting, rollback references
215 automated tests

Premium bundle - adds 41 tools:

Advisory optimization engine (review queues, learning, experiments, budget governor, creative rotation)
Vault intelligence and copy generation (brand voice, ICP targeting, concept selection)
Greek language QA (Greeklish detection, orthography checks)
Automation suite (diagnostics, bulk operations, account audit)
Vault bootstrap (15 template files per client)
Premium tests and evaluations

Premium bundle available separately. Public tools work fully without it.

What Makes This Different

Production-tested across 37+ client campaigns with real budgets and real edge cases
Not a wrapper - includes optimization engine, safety gates, validators, and rollback
Vault-integrated - reads client intelligence (ICPs, brand voice, angles) to generate better ads
Greek language QA built in (adaptable to any language validation)
All ads created PAUSED - nothing goes live without explicit operator approval
Supervised, not autonomous - operator confirms every write, every activation, every budget change

Tool Classification

Architecture

meta_ads_mcp/
  core/          # 66 tools - API read/write operations
  engine/        # 32 tools - optimization, review, learning, experiments
  validators/    # Quality gates (compliance, creative specs, tracking, structure)
  safety/        # Rate limiting, rollback, duplicate checking, file locks, tier access
  ingestion/     # Internal: video manifest management
  reporting/     # Internal: not currently active (see Non-Shipped Code)

Tool Categories

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

KonQuest Meta Ads MCP: common questions

Is KonQuest Meta Ads MCP server safe?: With care: it is graded C, so read the findings first (69/100). Read the KonQuest Meta Ads MCP safety report
How do I install KonQuest Meta Ads MCP?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does KonQuest Meta Ads MCP need an API key?: Yes. The registry entry asks for META_ACCESS_TOKEN.
Is KonQuest Meta Ads MCP maintained?: The last commit was 193 days ago (2026-04-23). The latest release is v2.0.0.
How does KonQuest Meta Ads MCP compare with other MCP servers?: safety score 69/100 (higher than 33% of 48,273 servers); tools 57 (the typical server has 7); tools that change things 32% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.