Agency AI – Meta & Google Ads Automation README
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.
Agency AI MCP Server
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.
📋 Table of Contents
- Overview
- What You Can Do
- Tool Reference
- Ad Management & Autopilot
- Platforms
- Requirements
- Quick Start
- Example Prompts
- FAQ
- Links
🎯 Overview
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
🎨 What You Can Do
📊 Analyst
Get campaign data, performance breakdowns, NCROAS and advanced KPIs across Meta and Google. Understand what's working and what's not.
🎯 Strategist
Receive budget guidance, creative recommendations, scaling plans, and cross-channel campaign planning strategies.
⚡ Ad Manager
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.
🧰 Tool Reference
15 tools: 10 read tools for analysis and 5 write tools for ad management.
📖 Read tools
| 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 |
✍️ Ad management tools (write)
| 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 |
⚡ Ad Management & Autopilot (write tools)
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.
🛠️ What each write tool does
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.
🤖 Autopilot
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:
- A 9am daily check that pauses anything below breakeven ROAS
- A Monday budget rebalance toward last week's winners
- A daily anomaly scan that flags unusual spend before it compounds
🛡️ Guardrails
- 🔐 Your account only – the account is resolved from your verified connection, never from what the assistant passes in. Ids that don't belong to your connected Meta or Google account are rejected before anything is written.
- ✅ Confirmation first – write tools are declared to Claude and ChatGPT as destructive (
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. - 💰 Budget ceiling – Meta daily budgets are clamped to $1–$5,000/day, in chat exactly as in the dashboard.
- 📋 Same pipeline as the dashboard – writes go through the same services and ownership checks the Agency AI dashboard uses, and every change lands in your activity log.
- 📊 Metered – every tool call is recorded for your account (tool, duration, response size, errors), so what your assistant did is auditable.
- ↩️ Reversible – anything paused can be re-activated the same way. A queued ad creation can be checked with
get_operation_status; pause the result if you change your mind.
🛒 Platforms
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.
✅ Requirements
- ✔️ An Agency AI account – install the Shopify app or create an account on any platform
- ✔️ Claude Max subscription OR ChatGPT plan supporting custom connectors
- ✔️ At least one connected ad account (Meta and/or Google) in Agency AI
🚀 Quick Start
Endpoint URL
You'll need this URL for ChatGPT; Claude finds Agency AI in its connector directory.
📱 Claude Setup
- Open Claude (claude.ai)
- Click your profile → Settings → Connectors
- Click Browse connectors and search for Agency AI
- Click Connect
- Sign in with your Agency AI account when prompted
- ✅ Done! Start asking Claude about your ads
Not seeing it? Click Add custom connector and paste https://s.agencyai.app/mcp.
💬 ChatGPT Setup
- Open ChatGPT (chatgpt.com)
- Click your profile → Settings → Connectors
- Click Add connector
- Paste:
https://s.agencyai.app/mcp - Sign in with your Agency AI account when prompted
- ✅ Done! Start asking ChatGPT about your ads
📖 Need detailed steps? See llms-install.md for a complete walkthrough.
💬 Example Prompts
Try these questions with your connected Claude or ChatGPT:
❓ FAQ
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.
🔗 Links
| 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 |
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.