konquest-meta-ads-mcp

Overview

KonQuest Meta Ads MCP is a comprehensive production-tested server that provides full CRUD operations for Meta Ads campaigns, ad sets, and ads. It features a supervised architecture where all write operations require operator approval, ensuring safety in real advertising environments. The open-core model offers 57 public tools with an additional 41 premium tools for optimization, intelligence, and automation. The server includes robust safety features like rate limiting, rollback capabilities, and validation pipelines to maintain advertising policy compliance.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• create_campaign

  Create a new advertising campaign

  Try:Create a new campaign for our summer product launchTry:Set up a campaign targeting 25-35 year old women in the US
• update_ad_set

  Update an existing ad set with targeting parameters

  Try:Update ad set targeting to include new demographicsTry:Modify the daily budget for this ad set
• create_ad

  Create a new ad with creative assets

  Try:Create a new video ad for our productTry:Design a static image ad with specific dimensions
• get_insights

  Retrieve performance insights for campaigns and ads

  Try:Show me the performance metrics for last week's campaignsTry:Compare ROI across different ad creatives
• check_pixel_health

  Verify Meta Pixel installation and health

  Try:Check if our Facebook Pixel is working properlyTry:Diagnose why our Pixel events aren't firing
• upload_creative

  Upload image or video creative assets

  Try:Upload this video file to our ad libraryTry:Check if our image meets platform specifications
• create_ad_set_with_targeting

  Create a new ad set with detailed targeting parameters

  Try:Create an ad set targeting people interested in hiking gearTry:Set up lookalike audiences based on our customer list
• run_diagnostics

  Run comprehensive diagnostics across all ad accounts

  Try:Run a full diagnostic on our ad accountsTry:Check for policy violations across active campaigns
• generate_ad_copy

  Generate ad copy based on brand voice and targeting parameters

  Try:Generate ad copy for our summer collection saleTry:Create ad headlines targeting young professionals
• optimize_campaign_budget

  Optimize campaign budgets based on performance

  Try:Optimize our campaign budgets for maximum ROITry:Shift budget underperforming campaigns to better performers
• validate_creative_specs

  Validate creative assets meet Meta's technical specifications

  Try:Check if our video meets aspect ratio requirementsTry:Validate our image ad creative before launch
• create_product_set

  Create a product set for Dynamic Product Ads

  Try:Create a product set for our new collectionTry:Set up a product set featuring sale items only

Comparable tools

Installation

cd meta-ads-mcp
uv sync
cp .env.example .env

{
  "mcpServers": {
    "meta-ads": {
      "command": "uv",
      "args": ["--directory", "/path/to/meta-ads-mcp", "run", "python", "-m", "meta_ads_mcp"],
      "env": {
        "META_ACCESS_TOKEN": "your_token_here",
        "VAULT_PATH": "/path/to/your/marketing-vault"
      }
    }
  }
}

uv run --extra dev python -m pytest tests/ -v

Compare konquest-meta-ads-mcp with