Server data from the Official MCP Registry
Supervised Meta Ads operating system for Claude Code with 57 campaign management tools.
Supervised Meta Ads operating system for Claude Code with 57 campaign management tools.
Valid MCP server (3 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Set these up before or after installing:
Environment variable: META_ACCESS_TOKEN
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-brandu-mos-konquest-meta-ads-mcp": {
"env": {
"META_ACCESS_TOKEN": "your-meta-access-token-here"
},
"args": [
"konquest-meta-ads-mcp"
],
"command": "uvx"
}
}
}From the project's GitHub README.
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
KonQuest Meta Ads MCP uses an open-core model:
Public (this repo) - 57 tools, MIT license:
Premium bundle - adds 41 tools:
Premium bundle available separately. Public tools work fully without it.
| Classification | Count | Description |
|---|---|---|
| production-safe | 38 | Read-only data access. No API writes, no local state changes. |
| supervised-only | 29 | Write/delete operations requiring operator approval before execution. |
| advisory-only | 31 | Generate recommendations, plans, copy, diagnostics. No Meta API writes. May write local files. |
| Total: 98 registered |
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)
| Category | Tools | Description |
|---|---|---|
| Account Management | 6 | Token health, ad accounts, pages, IG identity, discovery |
| Campaigns | 4 | Create, read, update campaigns |
| Ad Sets | 4 | Create, read, update ad sets with targeting |
| Ads | 4 | Create, read, update ads |
| Creatives | 3 | Create, read ad creatives |
| Insights & Analytics | 1 | Performance data with archetype-aware normalization |
| Pixels & Tracking | 5 | Pixel health, event diagnostics, test events, CAPI |
| Catalogs & DPA | 6 | Product catalogs, feeds, product sets, validation |
| Audiences | 1 | Custom audience listing |
| Targeting | 3 | Interest, behavior, and geo search |
| Video Management | 3 | Upload (simple + resumable) and processing status |
| Ad Builder | 1 | Multi-asset ad creation with IG gate enforcement |
| Copy Engine | 2 | Vault-driven ad copy generation and validation |
| Naming Convention | 1 | Enforced naming schema for all objects |
| Automation & Diagnostics | 6 | Greek QA, full diagnostic, bulk ops, account audit |
| Vault & Intelligence | 2 | Client vault reader, concept selection |
| Optimization Engine | 4 | Optimization cycles, launch planning, execution packs |
| Mutation Corridor | 2 | Budget/targeting changes with verification |
| Activation & Rollback | 4 | Status changes and undo with preflight checks |
| Review Queue | 7 | Operator review queue, outcome snapshots, digests |
| Learning Layer | 5 | Policy memory, outcome evaluation, learning cycles |
| Experiments | 7 | A/B testing, budget governor, creative rotation, scaling |
| Copy Generation | 2 | Auto copy chain, vault-grounded Greek copy |
Code that exists in the repository but is NOT part of the active tool surface:
cd meta-ads-mcp
uv sync
Copy .env.example to .env and fill in your values:
cp .env.example .env
Required:
META_ACCESS_TOKEN - Meta Marketing API access token (system user token recommended)Optional:
META_APP_SECRET - for appsecret_proof (recommended for production)META_APP_ID - Meta app IDVAULT_PATH - path to your marketing vault directory (defaults to ~/marketing-vault)Add to your Claude Code MCP config (.mcp.json):
{
"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"
}
}
}
}
If using the vault integration for client intelligence:
your-vault/
01_CLIENTS/{client-slug}/
00-profile.md # Account IDs, pixel, page, IG
02-icp-personas.md # Target audience profiles
04-brand-voice.md # Tone, language, style rules
05-messaging-house.md # Angles, value props
08-objections.md # Objections + bias deployment
matrix.md # Decision Matrix
02_COMPETITORS/{slug}/
landscape.md # Competitive landscape
uv run --extra dev python -m pytest tests/ -v
# Public package: 215 passed | Full (with premium): 246 passed
MIT - see LICENSE.
Be the first to review this server!
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
by Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI