Konquest Meta Ads
Supervised Meta Ads operating system for Claude Code. 57 tools for campaign management, multi-asset ads, targeting, pixel diagnostics, catalogs, and safety gates. All ads created PAUSED - operator approves every action.
What is Konquest Meta Ads?
Konquest Meta Ads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to supervised meta ads operating system for claude code. 57 tools for campaign management, multi-asset ads, targeting, pixel diagnostics, catalogs, and safety gates. all ads created paused - operator app...
Supervised Meta Ads operating system for Claude Code. 57 tools for campaign management, multi-asset ads, targeting, pixel diagnostics, catalogs, and safety gates. All ads created PAUSED - operator approves every action.
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Supervised Meta Ads operating system for Claude Code. 57 too
Use Cases
Maintainer
Works with
Installation
PIP
pip install konquest-meta-ads-mcpManual Installation
pip install konquest-meta-ads-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Konquest Meta Ads
The Konquest Meta Ads MCP server is a supervised Meta Marketing API operating system for Claude Code, providing 98 registered tools across three safety tiers that cover campaign and ad-set management, multi-asset ad creation, pixel diagnostics, audience targeting, catalog management, video uploads, and A/B testing. All write operations are created in PAUSED state and require operator approval before anything goes live, making it safe for AI-assisted advertising workflows. Marketing teams and agencies use it to automate repetitive Meta Ads tasks while maintaining human oversight over every action that touches a live account.
Prerequisites
- Python 3.10 or higher with uv package manager
- A Meta (Facebook) Marketing API access token — a system user token is recommended for production
- A Meta App ID and optionally an App Secret for appsecret_proof signing
- An MCP-compatible client such as Claude Desktop or Claude Code
Clone the repository
Clone the konquest-meta-ads-mcp repository. This package is installed from source rather than directly from PyPI for full configurability.
git clone https://github.com/brandu-mos/konquest-meta-ads-mcp.git
cd konquest-meta-ads-mcpInstall dependencies with uv
Use uv to sync all Python dependencies from the lockfile.
uv syncConfigure environment variables
Copy the example env file and fill in your Meta API credentials. META_ACCESS_TOKEN is the only required variable.
cp .env.example .envEdit .env with your credentials
Open .env and set at minimum your META_ACCESS_TOKEN. Add META_APP_SECRET for production appsecret_proof signing.
META_ACCESS_TOKEN=your_meta_system_user_token
META_APP_ID=your_meta_app_id
META_APP_SECRET=your_meta_app_secret
VAULT_PATH=/path/to/your/marketing-vaultRegister with your MCP client
Add the server to your MCP configuration file (.mcp.json for Claude Code or claude_desktop_config.json for Claude Desktop).
{
"mcpServers": {
"meta-ads": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/konquest-meta-ads-mcp", "run", "python", "-m", "meta_ads_mcp"],
"env": {
"META_ACCESS_TOKEN": "your_token_here",
"VAULT_PATH": "/path/to/your/marketing-vault"
}
}
}
}Run the test suite to verify setup
Run the included tests to confirm the server is configured correctly before connecting it to a live Meta Ads account.
uv run --extra dev python -m pytest tests/ -vKonquest Meta Ads Examples
Client configuration
Claude Desktop / Claude Code configuration for the Meta Ads MCP server using uv to run the Python module.
{
"mcpServers": {
"meta-ads": {
"command": "uv",
"args": ["--directory", "/home/user/konquest-meta-ads-mcp", "run", "python", "-m", "meta_ads_mcp"],
"env": {
"META_ACCESS_TOKEN": "your_meta_system_user_token",
"META_APP_ID": "your_app_id",
"META_APP_SECRET": "your_app_secret",
"VAULT_PATH": "/home/user/marketing-vault"
}
}
}
}Prompts to try
Example prompts for managing Meta Ads campaigns through Claude with the server active.
- "List all active campaigns in ad account 123456789 and show their current spend."
- "Create a new traffic campaign targeting US users aged 25-44 interested in fitness — leave it paused for my review."
- "Run pixel diagnostics on pixel ID 987654 and report any firing issues."
- "Show me the top 5 performing ad sets by ROAS for last month."
- "What audiences are available in my Meta account and which ones overlap significantly?"Troubleshooting Konquest Meta Ads
META_ACCESS_TOKEN is rejected with 'invalid OAuth access token'
System user tokens from Business Manager do not expire and are recommended. User tokens expire after 60 days. Regenerate the token in Facebook Business Manager under System Users and paste the full token without trailing spaces.
uv command not found when Claude tries to start the server
Install uv with curl -LsSf https://astral.sh/uv/install.sh | sh and ensure ~/.local/bin is in your PATH. Use the absolute path to the uv binary in the command field if needed.
Write operations are blocked by the safety tier system
This is by design — supervised-only tools (tier 2) require explicit operator approval before execution. Review the pending action in the vault directory and confirm it to proceed.
Frequently Asked Questions about Konquest Meta Ads
What is Konquest Meta Ads?
Konquest Meta Ads is a Model Context Protocol (MCP) server that supervised meta ads operating system for claude code. 57 tools for campaign management, multi-asset ads, targeting, pixel diagnostics, catalogs, and safety gates. all ads created paused - operator approves every action. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Konquest Meta Ads?
Install via pip with: pip install konquest-meta-ads-mcp. Then configure your AI client to connect to this MCP server.
Which AI clients work with Konquest Meta Ads?
Konquest Meta Ads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Konquest Meta Ads free to use?
Yes, Konquest Meta Ads is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Konquest Meta Ads Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Konquest Meta Ads? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
TopRank
★ 2.6kGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Konquest Meta Ads in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Konquest Meta Ads?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.