Meta Ads MCP server
Hosted Meta Ads MCP server
NotFair ships a hosted Model Context Protocol server at https://notfair.co/api/mcp/meta_ads. Drop the generic config below into any MCP-compatible client so your AI can diagnose Facebook + Instagram ad accounts and draft fixes — auth via OAuth or Bearer token.
Free · OAuth 2.0 · No credit card
New to MCP? Read the spec at modelcontextprotocol.io.
Generic MCP config
Two configs that work in any MCP client
For client-specific walkthroughs (Claude.ai, Claude Code, Codex), see the per-client setup guides linked below.
OAuth 2.0 (recommended)
Drop into ~/.cursor/mcp.json (Cursor), the Cline settings JSON, or any client that takes the standard MCP config schema. The client opens a browser for sign-in.
{
"mcpServers": {
"NotFair-MetaAds": {
"url": "https://notfair.co/api/mcp/meta_ads"
}
}
}Bearer token (for clients without OAuth)
Pass an Authorization header instead. The token below is your personal API key.
Get your API key
Sign in with Google to generate your personal API key. We'll substitute it into the Bearer config below automatically.
{
"mcpServers": {
"NotFair-MetaAds": {
"url": "https://notfair.co/api/mcp/meta_ads",
"headers": {
"Authorization": "Bearer YOUR_ADSAGENT_API_KEY"
}
}
}
}Tools exposed
What your AI client can read and change
Read tools provide live ad-account context. Write tools propose changes — every write requires explicit human approval before it hits the Meta Marketing API.
| Tool | Type | What it does |
|---|---|---|
runScript | Read | Sandboxed JS with Graph API fan-out — fan out 20 calls in one pass for audits and analysis. |
getInsights | Read | Performance insights with breakdowns: spend, impressions, clicks, CTR, CPC, CPM, conversions. |
listCampaigns | Read | List campaigns with status, objective, budget, bid strategy, and schedule. |
listAdSets | Read | Ad set details: optimization goal, billing event, daily/lifetime budget, targeting summary. |
listAds | Read | Ads with status, parent ad set/campaign, creative envelope, configured status. |
getAdAccount | Read | Account snapshot: currency, timezone, balance, amount spent, spend cap, parent BM. |
| and more | ||
Ready to wire up your client?
Sign in to NotFair, link your Meta ad accounts, then paste a config above into your MCP client.
FAQ — NotFair Meta MCP server
Common questions about authenticating, configuring, and using the NotFair Meta Ads MCP server.
What is the NotFair Meta Ads MCP server?
It's a hosted Model Context Protocol server that exposes your Meta ad accounts (Facebook + Instagram) to MCP-compatible AI clients. Read tools provide live campaign context for diagnosis; write tools propose fixes that you approve in chat.
Which MCP clients are supported?
Any client that speaks the MCP Streamable HTTP transport — Claude.ai (Web, Desktop, Cowork), Claude Code, OpenAI Codex CLI, Cursor, Cline, and custom MCP clients. The server URL is the same; only the client-side config differs.
Do I need to self-host anything?
No. The Meta Ads MCP server is hosted at https://notfair.co/api/mcp/meta_ads. You just point your client at it and authenticate.
How does authentication work?
OAuth 2.0 with PKCE is the recommended flow — Claude.ai and Codex run it automatically. For clients that don't support OAuth, you can use a Bearer token via the Authorization header. Generate either at notfair.co/connect/meta-ads.
Is the MCP server free?
Yes. Connecting to NotFair's Meta MCP is free with no credit card. Paid plans unlock higher usage limits and team features.
Can the AI write to my Meta ad accounts through this server?
Only with your explicit approval. Write tools propose changes (pause campaigns, adjust budgets, rename entities, etc.), the client surfaces them, and you confirm before anything hits the Meta Marketing API. Read access is unrestricted; write access is gated.
Does this work for both Facebook and Instagram ads?
Yes. Meta Ads covers both Facebook and Instagram inventory under a single ad account. The MCP exposes everything Meta surfaces through the Marketing API: campaigns, ad sets, ads, creative, audiences, insights, and the parent Business Manager.
Per-client setup guides
Walkthroughs for each supported client.
Meta Ads Claude Connector setup guide
Install NotFair's Meta connector inside Claude.ai Web, Desktop, or Cowork.
Meta Ads Claude Code plugin setup guide
Install the NotFair plugin in Claude Code via the toprank marketplace for Meta Ads.
Meta Ads Codex MCP setup guide
One-line install of the NotFair Meta MCP for OpenAI's Codex CLI.