Madgicx MCP: Manage Your Meta Ads with AI

What is Madgicx MCP?

Madgicx MCP is a secure connection between your Madgicx account and any MCP-compatible AI assistant. Once connected, you can ask your AI to pull campaign performance, pause underperforming ads, adjust budgets, rename ad sets, and much more — all without leaving your conversation. It works with Claude, ChatGPT, and any other client that supports the MCP standard.

MCP stands for Model Context Protocol — an open standard that gives AI assistants authenticated, structured access to external services. Madgicx runs a remote MCP server that any compatible AI client can connect to securely over OAuth 2.0.

As Meta's largest partner for SMB and eCommerce advertisers — with visibility into over $10B in annual ad spend — Madgicx brings that data advantage directly into your AI conversations.

Why MCP Instead of AI Browser Agents?

Many advertisers have tried using AI browser agents (tools that take control of Chrome to click through Meta Ads Manager on their behalf). Meta's policies prohibit this kind of automated browser interaction, and accounts using these tools are being banned.

Madgicx MCP is the compliant alternative. It connects directly to Madgicx's backend through a secured API — no browser automation, no policy violations. Your account stays safe while you gain the full power of AI-driven ad management.

How to Connect

Madgicx MCP works with any MCP-compatible client — including Claude (Web, Desktop, Mobile, and Code), ChatGPT (Web and API), n8n, and more. It also supports backend integrations with agentic frameworks like OpenAI Agents, LangGraph, Google ADK, and CrewAI.

The MCP server URL is: https://mcp.madgicx.com/mcp

For AI assistants (Claude, ChatGPT, etc.):

1. Open your AI client's connector/integration settings
2. Add https://mcp.madgicx.com/mcp as a custom connector
3. Authorize with your Madgicx account via the OAuth login flow
4. Enable the connector in a conversation and start asking

For agentic frameworks and automation tools (n8n, OpenAI Agents, LangGraph, etc.): These connect using client credentials (Client ID + Client Secret) from your Madgicx Workspace Settings → MCP Integration — no interactive login required.

For full step-by-step setup guides per platform, visit the Madgicx MCP Documentation.

Tip: For a smoother experience with Claude, set read-only tools to "Always allow" and write/delete tools to "Needs approval." This way Claude can pull data automatically, while actions like pausing campaigns or changing budgets still require your confirmation.

What You Can Do

Madgicx MCP gives your AI assistant 49 tools across six capability areas. You don't need to know tool names — just ask naturally and the AI picks the right tool automatically.

1. Read Your Account Structure

Understand what's in your account at every level — ad accounts, campaigns, ad sets, ads, and creatives.

Example prompts:

• "Show me all my active campaigns."
• "List the ad sets in my Summer Sale campaign."
• "Get me the details for ad set 120211556789."
• "What creatives are running in my top campaign?"
• "How many ad accounts do I have connected?"

2. Analyze Performance

Pull insights and performance metrics with breakdowns by age, gender, placement, and more — at any level of your account.

Example prompts:

• "What's the performance of my campaigns this week? Show me spend, impressions, and ROAS."
• "Break down my top campaign's results by age group."
• "Which ad set had the lowest CPA last month?"
• "Show me insights for all ads in my Retargeting campaign."
• "What's my total account spend this month?"

3. Control Campaigns, Ad Sets & Ads

Take action directly from your conversation — pause, start, adjust budgets, change bids, and manage spending limits.

Example prompts:

• "Pause all ad sets with a CPA above $50."
• "Start campaign 'Black Friday 2025'."
• "Increase the budget of my top-performing ad set by 20%."
• "Set the budget for campaign 'Brand Awareness' to $500/day."
• "Decrease the bid on ad set 'Lookalike - US' by $0.10."
• "What was the activity log for my account yesterday?"

4. Automate Naming & Organization

Bulk rename campaigns, ad sets, and ads — add prefixes, remove text, or replace naming patterns across your entire account in seconds.

Example prompts:

• "Add the prefix 'Q2-' to all my active campaign names."
• "Remove the word 'TEST' from all ad set names."
• "Replace 'Summer' with 'Fall' in all campaign names."
• "Rename all ads in this ad set to follow the format: [Product] - [Audience] - [Date]."

Example: Full Ad Account Analysis with Claude

One of the most powerful things you can do with Madgicx MCP is run a comprehensive Meta Ads account analysis entirely through a conversation with Claude.

The fb-ads-analyzer is a pre-built AI workflow that uses the Madgicx MCP tools to pull your real account data and generate an actionable insights report — covering campaign performance, creative health, budget allocation, audience saturation, placement efficiency, and funnel drop-off. It applies a creative-first media buying framework using your own account baselines, never generic industry benchmarks.

What it produces:

• An executive summary answering "what happened with my money?"
• A campaign-level breakdown of what's working and what isn't
• Creative health assessment grounded in actual ad-level data
• Scaling recommendations with a process, not a one-time action
• A prioritized action plan with graduated next steps

How to use it: Connect Madgicx MCP to Claude, then ask: "Analyze my Meta Ads account" or "Run a full account audit." Claude will guide you through setup questions and generate the report in your preferred format (PDF, HTML, or inline chat).

What's Not Available Yet

The following tools are in development and not yet released. They require additional stability testing before being made available:

• Creating campaigns, ad sets, and ads (full creation workflows)
• Duplicating campaigns, ad sets, and ads
• Ad preview generation
• Bid strategy management (set campaign/ad set bid strategy)
• Spending limit removal

These will be released in upcoming iterations. The existing 49 tools already cover the full read, analyze, control, and organize workflows.

Madgicx MCP for AI Agents

This documentation is designed to be readable by both humans and AI agents. The following is a structured capability summary for AI systems:

Server URL: https://mcp.madgicx.com/mcp Authentication: OAuth 2.0 with PKCE Total released tools: 49 Tool categories: Identity (1), Ad Accounts (3), Campaigns (11), Ad Sets (17), Ads (10), Creatives (3), Insights (4)

Read-only tools (22): List and get operations across all entity types, activity logs, insights with breakdowns Write/delete tools (27): Start/pause entities, budget management (set/increase/decrease), bid management, spending limits, name manipulation (add/remove/replace text) Not yet available: Entity creation, duplication, ad preview, bid strategy changes, spending limit removal

For full parameter documentation on every tool, see the Tools Reference.

Next Steps

• Full Setup Guide — Step-by-step instructions for Claude, ChatGPT, and other MCP clients
• Available Tools Reference — Complete tool list with parameters and examples
• Authentication & Security — How OAuth 2.0 keeps your account safe

Last updated: March 2026