Introduction
Connect any AI assistant or agentic framework to your Madgicx account and manage Facebook ads through natural language.
Madgicx MCP Documentation
Madgicx MCP lets you manage your Facebook advertising through AI assistants like Claude and ChatGPT — using plain English. Ask questions about your campaigns, adjust budgets, duplicate ads, pull performance reports, and more, all from a single conversation.
What is MCP?
The Model Context Protocol (MCP) is an open standard that gives AI assistants secure, authenticated access to external services. Madgicx runs a remote MCP server that any compatible client can connect to over OAuth 2.0.
This means you can:
- Read your account structure — campaigns, ad sets, ads, and creatives
- Act on your ads — pause, start, adjust budgets and bids
- Analyze performance — pull insights with breakdowns by age, gender, placement, and more
- Automate naming and organization — bulk rename, add prefixes, replace text across entities
Quick Start
Pick a client
Madgicx MCP works with Claude (Web, Desktop, Mobile, Code), ChatGPT (Web, API), n8n, and agentic frameworks like OpenAI Agents, LangGraph, Google ADK, and CrewAI. Any MCP-compatible client can connect via OAuth or client credentials.
Add the connector
Point your client at the Madgicx MCP server:
Each client has a slightly different setup flow — see the guides below.
Authorize
You'll be redirected to Madgicx to log in and select a team. OAuth 2.0 with PKCE keeps your tokens safe — no secrets are stored in the client.
Supported Clients
Claude
Web, Desktop, Mobile, and CLI — native MCP support across all Anthropic platforms
ChatGPT
Web interface and Responses API — connect via OpenAI's MCP integration
n8n
Workflow automation via MCP Client node with HTTP Streamable transport
Agentic Frameworks
Backend integrations — OpenAI Agents, LangGraph, Google ADK, CrewAI
Other Clients
Any MCP-compatible client via OAuth or client credentials
Available Tools
| Category | Examples |
|---|---|
| Identity | Check your connection, team, and token status |
| Ad Accounts | List accounts, get details, view activity logs |
| Campaigns | Start, pause, set budgets, rename |
| Ad Sets | Start, pause, manage budgets, bids, spending limits, rename |
| Ads | Start, pause, rename |
| Creatives | Inspect and batch-retrieve creatives |
| Insights | Performance metrics at account, campaign, ad set, and ad level with breakdowns |
See the Tools section for full parameter documentation on every tool.