Manage your Meta ads with your AI agent
The simplest way to manage your Meta ad account with your AI agent. Connect Claude, ChatGPT, Cursor or any MCP client, sign in with Facebook, and ask in plain words. Your agent sees the numbers, alerts and rules you see in IQuly, and changes ads only when you ask.
One address, every agent
Add IQuly as a remote MCP server with this address:
https://iquly.com/mcp
There is no API key and no Meta developer app. You sign in with Facebook, and if you’re new, your IQuly account is created on the spot. The first 14 days are free, with no card.
Connect your agent
Claude (web, desktop and mobile)
Settings → Connectors → Add custom connector. Name it IQuly, paste the address, choose Connect and sign in with Facebook.
Claude Code
Run this once, then type /mcp in Claude Code to sign in:
claude mcp add --transport http iquly https://iquly.com/mcp
ChatGPT
Turn on developer mode in Settings → Apps & Connectors → Advanced, then create a connector with the address above and OAuth sign-in.
Cursor
Add this to .cursor/mcp.json (or Settings → MCP), then sign in when Cursor asks:
{ "mcpServers": { "iquly": { "url": "https://iquly.com/mcp" } } }
VS Code (Copilot agent mode)
Run this, then start the server from the MCP list and sign in:
code --add-mcp '{"name":"iquly","type":"http","url":"https://iquly.com/mcp"}'
Codex CLI
Run this, then sign in when Codex opens your browser:
codex mcp add iquly --url https://iquly.com/mcp
Manus, Gemini CLI, Windsurf and others
Add a remote MCP server (streamable HTTP) with the address above. Sign-in happens through OAuth, so there is no API key to copy.
More detail for Claude is on IQuly for Claude.
Set up from the chat
Just signed up? Ask your agent to pick the ad accounts IQuly should watch, or to load the demo data and try everything on two sample accounts. No need to open the app.
Things to ask
- “How did my Meta ads do this week compared with last week?”
- “Which ads are getting tired, and what should I do about them?”
- “Is anything wasting money in my ad accounts right now?”
- “Break down last month’s spend and ROAS by placement.”
- “Pause the ad set with the worst cost per purchase.”
- “Set up a rule that alerts me when an ad set spends $50 without a purchase.”
- “Write three new ads based on my best performer.”
What your agent can read
These tools only read, so most agents can use them without asking each time.
- list_accounts: Your ad accounts, their health, when they last synced and whether changes are allowed
- get_account_summary: Spend, results and ROAS for a period, with open alerts
- get_performance: Campaigns, ad sets and ads with their numbers, biggest spenders first
- get_entity_detail, get_entity_insights: One campaign, ad set or ad in depth
- get_breakdown: Results by age and gender, placement, device, country or region
- get_ad_creative: An ad’s copy, headline and picture or video
- list_signals, get_signal_counts: Problems IQuly found: wasted spend, broken tracking and more
- get_ad_fatigue: Ads ranked by how tired they look
- list_rules, list_rule_activity: Your automation rules and what they did
- list_studio_drafts: New ads waiting for you to publish
- list_connections: Platform connections and whether they need reconnecting
- set_monitored_accounts: Choose which ad accounts IQuly watches, right from the chat
- load_demo_data: Adds two sample accounts to try IQuly with (only touches sample data)
What your agent can change
These tools change your ads or your IQuly setup, so your agent normally asks for your OK first. They are available only if you allow changes when you connect.
- set_status: Pause or turn on a campaign, ad set or ad
- set_daily_budget: Change a daily budget
- queue_change, publish_changes: Prepare changes, then publish them together
- undo_change: Put back a change IQuly made
- save_rule, set_rule_enabled, set_rule_live: Create rules (they start as a dry run), then turn them on
- undo_rule_action: Put back what a rule changed
- set_signal_state: Acknowledge, snooze or reopen an alert
- create_ad_drafts, generate_ad_drafts: Write new ads into Changes; nothing goes live until you publish
Questions
What is the IQuly MCP server?
A remote MCP server at iquly.com/mcp that gives AI agents such as Claude, ChatGPT and Cursor safe access to your Meta (Facebook and Instagram) ad accounts: results, wasted spend, tired ads, budgets, rules and new ads.
Do I need an API key or a Meta developer app?
No. You sign in with Facebook through OAuth, the same way you sign in to IQuly. New people get an account on the spot and can finish setup from the chat.
Can the agent change my ads without asking?
Only if you allow changes when you connect. Changes to live ads also need the Meta permission to manage ads, which you grant once in IQuly. Pauses, budget changes and rule actions can be undone, new rules start as a dry run and new ads start paused.
What does it cost?
IQuly has a 14-day free trial with no card. The MCP server is included in every plan.
See the privacy policy and information and security. IQuly answers your agent’s requests only and never sees your conversation.
Help
Something not working? Email [email protected] and tell us which agent you use, what you asked and what happened.