The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Agency AI – Meta & Google Ads Automation listing page.
Turns Claude and ChatGPT into a CMO for your Meta and Google ads
🎯 Full ad management in chat | 📊 Real-time performance insights | ⚡ Ad creation + editing | 💰 Budget optimization
Connect once. Your assistant analyzes, launches, optimizes and reports on your campaigns, on a schedule you set.
Works with any e-commerce platform or website. Deepest automation on Shopify.
Agency AI MCP turns Claude and ChatGPT into a CMO for your Meta (Facebook, Instagram) and Google ad accounts. Give it a goal instead of a to-do list – "keep my blended ROAS above 3 and scale what's working" – and it analyzes, launches, optimizes and reports without leaving the chat:
✨ Performance Analysis – campaign data, breakdowns, NCROAS and advanced KPIs 🎯 Strategy – budget guidance, creative recommendations, scaling plans ⚡ Ad Creation & Editing – create conversion-optimized ads, update budgets, pause or launch campaigns 🤖 Autopilot – schedule recurring ad management with Claude and ChatGPT scheduled tasks ⏱️ Fast & Efficient – faster responses with less token spend than direct-to-ad-platform MCPs
Get campaign data, performance breakdowns, NCROAS and advanced KPIs across Meta and Google. Understand what's working and what's not.
Receive budget guidance, creative recommendations, scaling plans, and cross-channel campaign planning strategies.
Create new ads, pause underperformers, adjust budgets, and launch campaigns across Meta and Google in seconds – without leaving the chat. Put it on a schedule and your account manages itself.
15 tools: 10 read tools for analysis and 5 write tools for ad management.
| Tool | What it returns |
|---|---|
get_brand_info | Brand profile and economics – what the store sells, its audience, and breakeven ROAS |
get_campaigns | Meta + Google campaigns with spend, revenue, ROAS, impressions, clicks, conversions, objective |
get_adsets | Meta ad sets (with daily budget and performance) or Google asset groups |
get_ads | Meta ads with performance for the date range, ranked by spend – also the source-ad picker for create_ad |
get_ad_creative | One Meta ad's creative: type, primary text, headline, description, CTA, landing page, media URLs |
get_performance_timeseries | Daily spend, revenue, and ROAS per connected platform |
get_pacing | Month-to-date spend vs the monthly budget you set, per platform |
get_anomalies | Statistically unusual spend/ROAS days over the trailing 30 days |
get_recommendations | AI optimization recommendations with reasoning and confidence |
get_operation_status | Progress, result, or error of a queued ad creation |
| Tool | What it changes |
|---|---|
create_ad | Creates a new Meta campaign, ad set, or ad – with fresh conversion-optimized creative or an existing ad's creative |
update_campaign | Campaign name, daily budget, and/or status – Meta and Google |
update_adset | Meta ad set name, daily budget, and/or status; Google asset group name and/or status |
update_ad | Meta ad name and/or status |
set_campaign_status | Starts or pauses up to 25 campaigns in one call, across both platforms |
Five write tools let Claude or ChatGPT create ads, edit campaigns, and act on your ad account directly. Nothing runs without you: your assistant confirms every write with you before it executes – see Guardrails below.
create_ad – Creates a new Meta campaign, ad set, or ad. Creative comes from one of two places: brand-new conversion-optimized creative and copy generated by Agency AI, or an existing ad you point at (its creative is reused). placement decides how much structure is created:
placement | What gets created |
|---|---|
new-campaign | Campaign + ad set + ad (needs a daily budget) |
new-adset | Ad set + ad inside an existing campaign |
existing-adset | Ad only, inside an existing ad set |
Creation runs in the background and returns an operation_id; ask your assistant to check on it and it will call get_operation_status. A source ad set's schedule is not inherited: the new ad set runs with no end date unless you give a future one.
update_campaign – Renames a campaign, changes its daily budget, and/or starts/pauses it, on Meta or Google. Each field reports its own outcome, so a partial result ("renamed, but the budget was rejected") comes back honestly rather than as a blanket failure.
update_adset – Same three fields for a Meta ad set. Google asset groups support name and status only; their budget lives on the campaign.
update_ad – Renames or starts/pauses a Meta ad. Meta only – Google Performance Max has no separate ad level.
set_campaign_status – Bulk start/pause for up to 25 campaigns in a single call, Meta and Google mixed. Each campaign succeeds or fails independently and the result lists every outcome, so one bad id never blocks the rest.
Pair the write tools with Claude's and ChatGPT's built-in scheduled tasks and routine ad management runs itself. Set the rule once in plain English; your assistant runs it on schedule:
readOnlyHint: false, destructiveHint: true), so your assistant asks before running one and the client can show its own approval prompt. The server also instructs the model to confirm with you before any write.get_operation_status; pause the result if you change your mind.Agency AI MCP works with any e-commerce platform or website – connect your Meta and Google ad accounts and everything above works.
On Shopify? The Agency AI Shopify app adds a deeper data layer – store revenue matched against ad spend, NCROAS and advanced KPIs – for the most accurate analysis and automation. We recommend it for Shopify stores.
Not on Shopify? Create a standalone Agency AI account at agencyai.app/mcp and connect your Meta and Google ad accounts directly.
You'll need this URL for ChatGPT; Claude finds Agency AI in its connector directory.
Not seeing it? Click Add custom connector and paste https://s.agencyai.app/mcp.
https://s.agencyai.app/mcp📖 Need detailed steps? See llms-install.md for a complete walkthrough.
Try these questions with your connected Claude or ChatGPT:
What is Agency AI MCP? An MCP server that connects your Meta and Google ad accounts to Claude and ChatGPT. It handles performance analysis, budget optimization, creative recommendations, and scaling strategy, and it creates ads, edits campaigns, and runs your account on autopilot – all by chat.
Do I need Shopify? No. Agency AI MCP works with any e-commerce platform or website. Shopify stores get the deepest data layer and the most accurate automation through the Agency AI Shopify app, so we recommend it if you're on Shopify.
Can Claude or ChatGPT actually create and edit my ads? Yes. Your assistant can create new conversion-optimized ads, change budgets and names, and pause or launch campaigns, ad sets, and ads across Meta and Google.
Will it change anything without my approval? No. Write tools are declared destructive so your assistant confirms with you before acting. Changes are budget-capped, ownership-checked, and every one lands in your activity log.
How is this different from connecting Meta or Google MCPs directly? One connector covers both platforms with pre-computed KPIs, a strategy layer, and ad creation built in. Responses come back faster with less token spend than direct-to-ad-platform MCPs.
What does it cost? MCP access is included with Agency AI plans. Create an account at agencyai.app/mcp to get started.
| Link | Purpose |
|---|---|
| 🌐 Website | Learn more about Agency AI |
| 🚀 Get Started | Create an account and connect |
| 🛍️ Shopify App | Install from Shopify App Store |
| 📧 Support | Get help or send feedback |
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.