Introduction
Connect any AI assistant or agentic framework to your Madgicx account and manage Facebook and Google Ads through natural language.
Madgicx MCP Documentation
Madgicx exposes its advertising tooling through the Model Context Protocol (MCP) — an open standard that gives AI assistants secure, authenticated access to external services. Connect Claude, ChatGPT, n8n, or any MCP-compatible client and manage your ads in plain English.
Two MCP Servers
Madgicx provides two separate remote MCP servers — one per ad platform. They share authentication (a single Madgicx login covers both) but expose different tools and have different prerequisites.
Facebook Ads MCP
Read, manage, and analyze Facebook campaigns, ad sets, ads, creatives, and insights
Google Ads MCP
Read and analyze Google Ads customers, campaigns, ad groups, ads, and performance metrics
| Facebook Ads MCP | Google Ads MCP | |
|---|---|---|
| Server URL | https://mcp.madgicx.com/mcp | https://mcp-google-ads.madgicx.com/mcp |
| Capabilities | Read + write (pause, start, budgets, bids, naming) | Read-only |
| Tool count | 48 tools | 6 tools |
| Required connection | Facebook ad account in Workspace | Google token + Google Ads accounts in Workspace |
What can you do?
- Read account structure — campaigns, ad sets / ad groups, ads, and creatives
- Act on Facebook ads — pause, start, adjust budgets, bids, and spending limits
- Analyze performance — pull insights with breakdowns by date, age, gender, placement, device, country, and more
- Automate naming — bulk rename, add prefixes, replace text across Facebook entities
Quick Start
Pick a client
Madgicx MCP works with Claude (Web, Desktop, Mobile, Code), ChatGPT (Web), 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(s)
Point your client at one or both Madgicx MCP servers:
You can connect both servers to the same client — they're independent and the assistant decides which tool set to use based on your question.
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. The same Madgicx login authorizes both servers.
Supported Clients
Claude
Web, Desktop, Mobile, and CLI — native MCP support across all Anthropic platforms
ChatGPT
Web interface — 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