KonQuest Meta Ads MCP — Claude Code MCP server setup
Manages Meta ad campaigns inside Claude Code under operator supervision. Handles campaign drafting, tracking audits, and targeting searches without unapproved budget changes.
claude mcp add konquest-meta-ads-mcp -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcpWhat KonQuest Meta Ads MCP does
This server provides 57 open-source tools communicating with the Meta Marketing API. An agent can draft ad sets, upload creative assets, inspect catalog setups, and query audience criteria directly in chat. Tools are organized into read-only data queries, operator-confirmed writes, and advisory recommendations.
Safety mechanisms prevent accidental ad spend. The server initializes every new ad in a paused state. Every budget alteration, deletion, or campaign activation demands direct operator approval before execution.
A valid META_ACCESS_TOKEN is mandatory. Meta system user tokens are recommended. Without active credentials, the server cannot inspect accounts or apply campaign changes.
What it helps with
- build paused ad campaigns and sets with structural validation
- inspect Meta Pixel health and event delivery setups
- look up targeting parameters for interests and geographic areas
- pull comparative performance stats across advertising accounts
Example prompts for the agent
- Check the health and event status of my Meta Pixel
- Draft an ad set with paused video ads for the current campaign
- Search for targeting options related to running shoes in Germany
How to install KonQuest Meta Ads MCP
Platform CLI
claude mcp add konquest-meta-ads-mcp -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>
Platform CLI
codex mcp add konquest-meta-ads-mcp --env META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>
Config file
{
"mcpServers": {
"konquest-meta-ads-mcp": {
"command": "uvx",
"args": [
"konquest-meta-ads-mcp"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>
Config file
{
"servers": {
"konquest-meta-ads-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"konquest-meta-ads-mcp"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>
Platform CLI
gemini mcp add -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> konquest-meta-ads-mcp uvx konquest-meta-ads-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about KonQuest Meta Ads MCP
How do I install KonQuest Meta Ads MCP in Claude Code?
Run claude mcp add konquest-meta-ads-mcp -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcp with your Meta token.
Can the server publish ads without human approval?
No. It creates every ad in a paused state, and all write operations require explicit operator confirmation.
What does the MIT public version include?
The open core contains 57 tools covering campaign CRUD, creative uploads, pixel diagnostics, catalog helpers, and targeting search.
