konquest-meta-ads-mcp
A Windows-ready MCP server to manage Meta Ads with Claude Code, providing ad creation, targeting checks, diagnostics, and safety gates for supervised ad operations.
README
๐ค konquest-meta-ads-mcp - Control Meta Ads with Ease
๐งญ Overview
konquest-meta-ads-mcp is a Windows-ready tool that helps you work with Meta Ads through Claude Code. It gives you a guided way to manage ads, audiences, and reports from one place.
It is built for users who want a safer way to handle Meta Ads tasks without jumping between many screens. The app supports core ad actions, multi-asset ads, targeting checks, diagnostics, and safety gates. If you need more advanced control, the premium side adds tools for optimization, vault intelligence, and copy generation.
๐ฅ Download
Use this link to visit the page and download the app:
๐ช Windows Setup
- Open the download page in your browser.
- Download the latest Windows package from the page.
- If the file comes as a ZIP, right-click it and choose Extract All.
- Open the extracted folder.
- Find the main app file and double-click it.
- If Windows asks for permission, choose Yes.
- Follow the on-screen steps to finish setup.
If you do not see the file right away, check your Downloads folder first. Most browsers save files there by default.
โ What You Can Do
- Create and manage Meta Ads assets
- Work with multiple ad assets in one flow
- Check targeting before you launch
- Review diagnostics for common setup issues
- Use safety gates to reduce risky changes
- Run supervised ad actions with Claude Code
- Access a larger tool set with premium features
๐ ๏ธ Main Features
๐งฉ Core Ad Tools
The main tool set covers the day-to-day work most users need:
- Create campaigns, ad sets, and ads
- Update existing ad items
- Read account data and ad details
- Handle multi-asset ad setups
- Work with basic reporting and status checks
These tools help you make changes without moving between many separate steps.
๐ฏ Targeting Tools
Targeting matters when you want your ads to reach the right people. This app includes tools that help you:
- Review audience settings
- Check location and age choices
- Inspect interest and behavior filters
- Spot overlap or narrow targeting
This makes it easier to keep your ad setup clean and focused.
๐ก๏ธ Safety Gates
The app includes safety checks before key actions. These checks help you:
- Review changes before they go live
- Reduce mistakes in ad setup
- Catch risky edits early
- Keep control over major account changes
This is useful when you want a clearer path for review before posting or editing.
๐ Diagnostics
Diagnostics tools help you find setup issues fast. They can help you:
- Check account and asset status
- Review errors from ad setup steps
- Find missing fields or broken links
- Spot problems that can stop an ad from running
These checks save time when something does not work as expected.
๐ง Premium Tools
Premium adds 41 extra tools for more advanced work:
- Optimization engine
- Vault intelligence
- Copy generation
- Extra ad workflow tools
- Deeper account insights
- More guided decision support
These tools are built for users who want more control over performance and creative work.
๐ System Requirements
Before you run the app on Windows, make sure your device meets these basic needs:
- Windows 10 or Windows 11
- A modern web browser
- Internet access
- Enough free disk space for the app and its files
- A Meta Ads account
- Claude Code access if your workflow uses it
For smoother use, keep Windows updated and close extra apps if your computer runs slowly.
๐ Getting Started
- Open the GitHub page from the download link.
- Get the latest Windows file from the repository.
- Save the file to your computer.
- Extract it if the file is compressed.
- Open the app folder.
- Start the main program file.
- Connect your Meta Ads account if the app asks for it.
- Follow the setup prompts shown in the app.
If you are not sure which file to open, look for the one with the app name or the main executable file.
๐ Account Access
To use Meta Ads tools, you may need:
- A Meta Ads account
- The right account permissions
- Access to the ad account you want to manage
- Claude Code access for supervised actions
Use the same account details you already use for Meta Ads. If your business uses shared access, make sure you have permission to edit campaigns before you start.
๐งช First Run Checklist
Before you make changes, check these items:
- The app opens without errors
- Your internet connection works
- Your Meta Ads login works
- The correct ad account is selected
- You can see campaigns or assets in the app
- The safety checks appear before major changes
If something looks wrong, refresh the app and try again.
๐ Common Folder Layout
You may see files and folders like these after extraction:
- App file
- Readme file
- Config folder
- Logs folder
- Data folder
- Assets folder
Do not move files around unless the setup steps tell you to. Keep the folder together so the app can find what it needs.
โ๏ธ Basic Use
A simple first use flow looks like this:
- Open the app.
- Sign in or connect your account.
- Pick the ad account you want to manage.
- Choose the task you want to run.
- Review the safety checks.
- Confirm the action.
- Check the result in the app.
This flow keeps the process clear and helps you avoid mistakes.
๐ Troubleshooting
App does not open
- Make sure the file finished downloading
- Extract the ZIP before opening it
- Right-click the file and choose Run as administrator
- Check that Windows did not block the file
Login does not work
- Check your internet connection
- Make sure your Meta Ads account is active
- Confirm that you have the right access level
- Try signing in again
No ads or campaigns appear
- Pick the correct ad account
- Refresh the view
- Check that your account has active data
- Make sure the app has permission to read the account
An action fails
- Read the error message
- Check required fields
- Review the safety gate prompt
- Try the action again after confirming your settings
๐งฐ Tips for Smooth Use
- Keep the app in the same folder after extraction
- Use one Meta Ads account at a time if you are new
- Review safety prompts before confirming changes
- Start with simple tasks before using advanced tools
- Save a copy of important settings before big edits
๐ Topic Fit
This project relates to:
- Claude Code
- Facebook Ads
- Instagram Ads
- MCP
- MCP server
- Meta Ads
- Meta Marketing API
- Model Context Protocol
- Open-core software
- Python
๐ What This Repo Is For
This repository is meant for users who want a supervised way to manage Meta Ads with Claude Code. It brings together account actions, targeting checks, diagnostics, and safety controls in one place.
The open-core setup gives you the main tools first. If you need more, the premium tool set adds extra depth for optimization and content work.
๐ฅ๏ธ Windows Use Cases
You can use this app on Windows to:
- Set up new ad campaigns
- Edit existing ads
- Review audience settings
- Check for common setup mistakes
- Manage multi-asset ad workflows
- Keep a safer edit process
- Support ad work with Claude Code
๐ฆ Install and Run
- Open the download page.
- Download the latest Windows version.
- Extract the file if needed.
- Open the folder.
- Run the main app file.
- Complete the setup prompts.
- Sign in with your Meta Ads account.
- Start with a small task to test the setup.
If Windows asks whether to allow the app, choose the option that lets it run.
๐ Download Again
Download or open the latest release page
๐งญ Next Steps
- Open the app
- Connect your account
- Review your first campaign
- Use the safety checks
- Try the targeting tools
- Explore the diagnostics view
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.