Key Takeaways
- Meta launched its official Meta Ads MCP on April 29, 2026 — it gives Claude Code direct, live access to your ad account through 29 tools, no CSV exports or dashboards needed.
- Setup takes about 15 minutes and requires no coding — just editing one JSON config file.
- You can ask Claude to surface your top ROAS ads, identify the hooks and formats that are working, and write a ready-to-use creative brief — all in a single conversation.
- Fatigued ads lose 20–30% of engagement per week; Claude can flag campaigns where frequency is climbing before they drain budget.
- The output of the brief plugs directly into HeyOz, which generates production-ready ad creatives across 11+ formats from a single prompt.
- This entire loop — analysis, brief, new creative — runs inside one chat session and replaces hours of manual strategist work.
What Is the Meta Ads MCP and Why Does It Change Everything?
The Meta Ads MCP (Model Context Protocol) is an open standard that connects AI models like Claude directly to your Meta ad account — in real time, without exports or middleware. Instead of downloading a CSV and pasting it into ChatGPT, Claude reads your live campaign data, pulls your top performers, flags your weakest creatives, and generates the next round of ads in one continuous session. Meta launched its official MCP server on April 29, 2026, exposing the full Marketing API through 29 tools. As of now it is in open beta and free to use.
Before MCP, connecting an AI to your ad data meant exporting spreadsheets, copying metrics into a prompt, and hoping the model had enough context to give useful output. The results were generic. The workflow was tedious. And any follow-up question required starting over.
MCP changes that by making the AI a live participant in your ad account. Claude can query your campaigns the same way a human analyst would — except it can cross-reference 90 days of performance data, spot patterns across creatives, and write a detailed strategy brief in seconds, not hours.
By late 2025, the MCP SDK had reached 97 million monthly downloads with over 10,000 active servers deployed — a signal that the shift from manual data pulls to live AI connections is already underway across the industry.
How Do You Set Up the Meta Ads MCP With Claude Code?
Setup takes roughly 15 minutes. No coding needed. You will need Claude Code installed and access to your Meta Business account.
Step 1: Install Claude Code
Claude Code is Anthropic's official CLI. Install it by running the following command in your terminal:
npm install -g @anthropic-ai/claude-code
Once installed, run claude in your terminal to open a session.
Step 2: Connect the Meta Ads MCP Server
Meta's official MCP server runs over HTTP. Register it with Claude Code by running:
claude mcp add meta-ads --transport http https://mcp.meta.com/ads --headers "Authorization: Bearer YOUR_META_ACCESS_TOKEN"
Replace YOUR_META_ACCESS_TOKEN with a token from your Meta Business account. You can generate one in the Meta Business Suite under Business Settings → System Users → Generate Token. Grant it ads_read and ads_management permissions.
Step 3: Verify the Connection
Inside your Claude Code session, type:
Show me the active campaigns in my Meta ad account.
Claude will call the MCP and return your live campaign list. If it does, the connection is working. If you see a permissions error, check that your access token has the correct scopes and that your ad account flag is enabled. Meta is doing a phased rollout, so some accounts may have a short wait before the flag is active.
Note: Meta is currently rolling out this access account by account. If your account is not yet enabled, you can use Composio's Meta Ads toolkit as a fully functional alternative with the same capabilities.
What Prompts Do You Use to Find Winning Ads?
Once Claude Code is connected to your Meta account, these are the exact prompts to run. Copy them verbatim and adjust the date range to match your account.
Prompt 1: Surface Your Top Performers
Show me my top 5 ads by ROAS over the last 30 days. For each one, include: ad name, campaign name, ROAS, CTR, CPA, total spend, and total conversions.
Claude will pull the data and return a ranked list. Look at which campaigns and ad sets these top performers live in — that context matters for the brief you will write next.
Prompt 2: Decode What Is Working
Look at the names, copy, and format of my top 5 ads. What patterns do you see? What type of hook appears most — problem-centric, benefit-centric, comparison, or social proof? What creative format is dominant — video, static image, or carousel? What is the likely emotional trigger in each?
This is where Claude earns its keep. It will cross-reference ad names, format types, and performance data to surface the pattern behind your winners. A human strategist would spend half a day doing this manually.
Prompt 3: Identify the Dead Weight
Show me all active ads where ROAS is below 1.5 and spend in the last 14 days is over $200. Flag any where frequency is above 2.5.
According to research on Meta creative fatigue in 2026 , ads with frequency above 2.5–3 enter a danger zone where engagement drops consistently. The 45% conversion drop after four exposures is real — and Claude can catch this before you have wasted another week of budget on a dead creative.
Prompt 4: Spot Trends Over Time
Compare my CTR and CPA week-over-week for the last 6 weeks across all active campaigns. Tell me which campaigns are trending up and which are trending down.
This prompt gives you the macro view — which campaigns have momentum and which are running out of steam. Use it to prioritize where to refresh creative first.
How Do You Build a Creative Brief From Your Ad Data?
This is the step most people skip — and it is why their AI-generated ads do not perform. You need to translate the performance data into a brief before generating new creative. Otherwise you are just creating random variations, not informed iterations.
Run this prompt immediately after Prompt 2:
The Creative Brief Prompt
Based on the winning patterns you identified, write me a creative brief for 3 new ad concepts. For each concept include: (1) Hook type and exact opening line — the first 3 seconds of the ad, (2) Visual direction — what the viewer sees, the setting, the subject, the mood, (3) Core message — the single benefit or proof point the ad communicates, (4) Call to action — the exact CTA text and where it appears, (5) Format recommendation — video, static image, or carousel, and why.
Claude will produce three distinct briefs grounded in what has already worked in your account. Each one is a hypothesis built on real data — not a guess.
Optional: The HeyOz Prompt Builder
If you want to go straight to production, add this to the end of your brief request:
For each concept, also write me a production prompt formatted for HeyOz. The prompt should describe the ad format, the visual scene, the actor or presenter type (if needed), the script or hook text, and the brand tone. Make it ready to paste directly into HeyOz.
Claude will output three briefs plus three HeyOz-ready prompts in one response. You go from live ad data to production-ready creative brief in one conversation, with no manual reformatting.
How Do You Generate New Ads With HeyOz?
Once Claude has written your production prompts, the next step is generating the actual creatives. This is where HeyOz comes in.
HeyOz is an AI ad creation platform that turns a single brief into production-ready creatives across 11+ formats — static ads, AI UGC video, carousels, AI presenter videos, product photoshoots, meme formats, and more. Where Claude identifies what to make and writes the strategy, HeyOz builds the actual output.
Step 1: Open HeyOz and Create a New Project
Log into heyoz.com and start a new project. Paste your product URL and HeyOz will automatically pull your brand assets — logo, colors, typography, and product visuals. This takes about 30 seconds.
Step 2: Paste the Claude Brief Into HeyOz
Copy the production prompt Claude wrote and paste it into HeyOz's prompt field. Select the format Claude recommended — for example, AI UGC Hook Video if Claude identified video as your winning format. HeyOz will use your brand assets plus the brief to generate the creative.
Step 3: Generate Variations and Pick Winners
Run each of Claude's three briefs through HeyOz. You will typically get 3–5 output variations per brief, giving you 9–15 new creatives total from one analysis session. Review them, pick the strongest 3–5, and push them to Meta. Then come back to Claude in two weeks and repeat the analysis loop.
AI-powered workflows like this deliver 10–20x the creative throughput of a human-only workflow — without the agency fees. A traditional creative strategist costs $3,000–$5,000 per month. This stack costs a fraction of that and moves faster.
How Do You Catch Dying Ads Before They Tank Your ROAS?
Most advertisers only notice creative fatigue after their ROAS has already collapsed. By then they have wasted days of budget. Claude, connected live to your account, can catch the signals earlier.
The numbers are stark: according to Meta ad fatigue research , fatigued creatives lose 20–30% of engagement every single week, and there is a 45% conversion drop after four exposures. For a brand spending $10,000 per month at a 4x ROAS, that translates to up to $18,000 in lost monthly revenue from a single tired creative.
Meta's own analytics team found that 19% of all ad impressions come from creatives the same person has already seen more than five times in 30 days. That means nearly one in five of your impressions is going to waste.
The Fatigue Detection Prompt
Run this weekly to monitor for fatigue:
Check all active ads in my account. Flag any where: (1) frequency has crossed 2.5 in the last 7 days, (2) CTR has dropped more than 20% week-over-week, or (3) CPA has increased more than 25% week-over-week while spend held steady. For each flagged ad, tell me the current metrics and whether you recommend pausing or refreshing.
Claude will return a ranked list of ads at risk. Ads flagged by criteria 1 and 2 together are almost certainly in fatigue and should be paused or replaced within 48 hours. Ads flagged only by criteria 3 may have an audience issue rather than a creative one — Claude can investigate further if you ask.
What to Do After You Pause a Fatigued Ad
Once you have paused the ad, run the creative brief prompt from the previous section. Use the paused ad's format and hook type as the starting point, and ask Claude to write a refreshed version that changes the angle — same audience problem, different emotional trigger. Then generate it in HeyOz and launch it into the same ad set.
The 60-30-10 budget allocation framework works well here: put 60% of budget into proven winners, 30% into refreshed variants of those winners, and 10% into completely new concepts. Data from 500+ Meta advertising accounts shows this delivers 23% higher blended ROAS than equal-budget testing.
Frequently Asked Questions
Does this work without coding experience?
Yes. Setup requires running two terminal commands and editing one JSON file. Everything after that — analysis, briefs, prompts — is plain English in a chat interface. If you can use Slack, you can use this workflow.
Is the Meta Ads MCP free?
The Meta Ads MCP server is currently in open beta and free. You do pay for Claude Code usage through Anthropic's standard API pricing. For the volume of queries in this workflow, expect to spend $5–$20 per month on API costs depending on how often you run analysis sessions.
What if Claude cannot access my ad account yet?
Meta is doing a phased account-by-account rollout. If your account flag is not active yet, use Composio's Meta Ads toolkit as a drop-in alternative — it offers the same capabilities and is available immediately.
How is this different from Meta Advantage+ AI?
Meta Advantage+ automates bidding and audience targeting within the platform. The Claude + MCP workflow is about strategy and creative — it analyzes what is working and generates new creative briefs and production prompts. The two are complementary, not competing.
How many new ads can I generate per session?
A single analysis session typically yields 3 creative briefs, each producing 3–5 variations in HeyOz. That is 9–15 new production-ready ads per session. Running sessions weekly gives you a constant pipeline of fresh creative without hiring a strategist or a creative team.
Is my ad account data safe when Claude accesses it?
Claude Code processes data locally in your terminal session. Your credentials are stored in your local config, not transmitted to third parties beyond the Meta API and Anthropic's inference endpoint. Treat your Meta access token the same way you would treat a password — store it securely and regenerate it if you suspect exposure.
About the author
Ahad Shams
Ahad Shams is the Founder of HeyOz, an all-in-one ads and content platform built for founders and small teams. He has worked across consumer goods and technology, with experience spanning Fortune 100 companies such as Reckitt Benckiser and Apple. Ahad is a third-time founder; his previous ventures include a WebXR game engine and Moemate, a consumer AI startup that scaled to over 6 million users. HeyOz was born from firsthand experience scaling consumer products and the need for a unified, execution-focused marketing platform.

