Agency AI MCP

---

📋 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.

💡 Example: "Compare my top 5 campaigns by ROAS last month"

🎯 Strategist

Receive budget guidance, creative recommendations, scaling plans, and cross-channel campaign planning strategies.

💡 Example: "Which campaigns should I scale and why?"

⚡ 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.

💡 Example: "Pause all campaigns with ROAS below 2:1"

---

🧰 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 – one row per platform per day, each with a data_status (complete, partial, not_synced, error) and last_synced_at per platform; the window is at most 366 days
get_pacing	Month-to-date spend vs the monthly budget you set, per platform – a platform whose spend couldn't be fetched is marked available: false with no spend figure, and spendComplete: false says the total leaves it out
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
• ✔️ Any Claude plan (including free) OR a ChatGPT plan supporting custom connectors
• ✔️ At least one connected ad account (Meta and/or Google) in Agency AI

---

🚀 Quick Start

Endpoint URL

https://s.agencyai.app/mcp

You'll need this URL for ChatGPT; Claude finds Agency AI in its connector directory.

📱 Claude Setup

1. Open Claude (claude.ai)
2. Click your profile → Settings → Connectors
3. Click Browse connectors and search for Agency AI
4. Click Connect
5. Sign in with your Agency AI account when prompted
6. ✅ Done! Start asking Claude about your ads

Not seeing it? Click Add custom connector and paste https://s.agencyai.app/mcp.

💬 ChatGPT Setup

1. Open ChatGPT (chatgpt.com)
2. Click your profile → Settings → Connectors
3. Click Add connector
4. Paste: https://s.agencyai.app/mcp
5. Sign in with your Agency AI account when prompted
6. ✅ 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:

📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"

🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"

⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"

---

❓ 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.