Tera Ads
Enables AI to manage Facebook ad campaigns through Meta Ads, including performance insights, pausing or enabling ads, budget changes, duplication, and creation of paused campaigns, ad sets, and ads.
Includes Google Ads spend in profit-after-returns calculations; reading or changing Google Ads campaigns is not supported through the server yet.
Enables AI to manage Instagram ad campaigns through Meta Ads, including performance insights, pausing or enabling ads, budget changes, duplication, and creation of paused campaigns, ad sets, and ads.
Provides tools for Meta Ads management: reading live campaign and ad insights, pausing or enabling ads, changing budgets within caps, duplicating campaigns, and creating paused campaigns, ad sets, and ads. Changes can require approval and can be undone.
Connects Shopify store data to calculate profit after returns using orders, returns, product cost, shipping, fees, refunds, and ad spend. Returns aggregate totals only, with no customer details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tera AdsWhat was my profit after returns in the last 30 days?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tera Ads: Meta Ads MCP with approval, undo and real profit
Connect your Meta (Facebook and Instagram) ads and your Shopify store to Claude, ChatGPT, Cursor, VS Code or Claude Code, then ask in your own words. Your AI reads your live campaigns and your store's profit after returns. It can also pause ads, turn them on, change budgets and build new campaigns, within the limits below.
https://teraads.co/mcpThat address is the whole setup. It is a remote MCP server: you sign in on teraads.co, and there is nothing to install or host.
Why Tera Ads
Approval before a change. For each connection you choose whether your AI makes changes itself, asks you first, or only reads. With Ask me first, a change waits in Tera Ads until you approve it there, and your AI can't approve it for you.
Undo after it. A pause, turn-on or budget change can be undone in Tera Ads for 7 days. Everything your AI creates starts paused and spends nothing until it is turned on.
Profit after returns, not only ROAS. Answers come from your store's orders, returns, product cost, shipping, fees and refunds, minus your Meta and Google ad spend. Meta's attributed revenue is labelled as Meta's.
Changes go to Meta through Tera Ads' approved Meta app. Each change is checked against Meta first, made once, then read back.
Related MCP server: Adako
Set it up
You need a free Tera Ads account with your Meta ad account connected. Connect Shopify too, so your AI can see store sales and profit. Only the business owner can connect an AI.
Claude Code
claude mcp add --transport http tera-ads https://teraads.co/mcpStart Claude Code, type /mcp, choose tera-ads and sign in to Tera Ads in your browser.
To add the server together with the six skills in this repo, install it as a plugin instead:
claude plugin marketplace add Teralabsx/meta-ads-mcpclaude plugin install tera-ads@tera-adsClaude (web and desktop)
In Claude, open Customize, then Connectors.
Choose + Add, then Add custom connector. Name it Tera Ads, paste
https://teraads.co/mcp, choose Continue, then Add.Choose Connect, sign in to Tera Ads and pick the business to share.
In a chat, choose + at the lower left, then Connectors, and switch Tera Ads on.
On Team and Enterprise plans, an owner adds Tera Ads under Organization settings, then Connectors. Members then choose Connect.
ChatGPT
In ChatGPT on the web, open Settings, then Apps.
Open Advanced settings and turn on Developer mode.
Choose Create app, name it Tera Ads, paste
https://teraads.co/mcpand choose OAuth for authentication.Sign in to Tera Ads and pick the business to share, then add Tera Ads to a chat from the + menu.
Developer mode needs a ChatGPT plan that includes it. In Business workspaces, an admin adds the app.
Cursor
Add configs/cursor/mcp.json to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project). When Cursor asks, sign in to Tera Ads in your browser.
VS Code
Add configs/vscode/mcp.json to .vscode/mcp.json, or run MCP: Add Server from the Command Palette. Start the server, sign in to Tera Ads, then switch Tera Ads on under Configure Tools in Chat.
What you can ask
Ask | What your AI looks up |
"What was my profit after returns in the last 30 days?" |
|
"Meta says my ROAS is 3. What did my store actually make?" |
|
"Which campaigns spent the most this week, and what did they bring in?" |
|
"Which ads spent money in the last 14 days without a sale?" |
|
"Pause those three ads." |
|
"Raise the budget of my best ad set by 20%." |
|
"Copy my best campaign as a paused draft." |
|
"Build a paused sales campaign for this product in the US and Canada." |
|
"Write two new versions of my best ad's text." |
|
"What changed in my ads this week, and can I still undo it?" |
|
More in docs/prompts.md. Every tool is listed in docs/tools.md.
Skills
The Claude Code plugin adds six skills. Each one tells your AI which tools to use, in what order, and what to check first.
Skill | What it does |
Puts Meta's numbers next to your store's profit after returns | |
Compares this week with last week and suggests changes, without making any | |
Finds ads spending without sales and pauses the ones you pick | |
Raises a winner's budget in safe steps, or copies it as a paused draft | |
Builds a whole campaign, ad set and ad, all paused, for you to check | |
Writes new versions of a tired ad as paused ads beside it |
The skill files are plain Markdown, so you can read them or copy them into other assistants.
Limits and safety
You set what your AI may do. Make changes itself, ask you first, or only read. You can switch a connection between the first two at any time under AI connections in Tera Ads.
New things start paused. Campaigns, ad sets, ads and copies spend nothing until something turns them on.
Budget steps are capped. One change can at most triple a budget or cut it to a tenth.
Daily cap. Assistants can make at most 50 changes a day to one business.
No delete tool. Your AI can pause, but it can't delete anything.
Undo. A pause, turn-on or budget change can be undone in Tera Ads for 7 days. New campaigns, ad sets, ads and copies can't be undone, but they start paused.
One business per connection. A connection can't read another business, even one you also own.
Sign-in stays on teraads.co. Sign-in uses OAuth 2.1 with PKCE. Tera Ads stores tokens only as one-way hashes. Access tokens last 1 hour, and a connection lasts 30 days.
Ad text is data. Campaign names and ad text reach your AI as data, and Tera Ads tells it not to follow instructions inside them. To see every change before it happens, choose Ask me first.
The full detail is on the security page.
Pricing
Plan | Calls | Meta ad accounts | Price |
Free | 30 a week | 1 | Free |
Connect Pro | 3,000 a month | 3 | $15 a month (€13, £11), charged in your own currency |
Connect Pro is included with the Growth and Scale plans. A call is one lookup your AI makes in Tera Ads, and one question can take a few. At the limit, your AI gets a plain message with the reset time. Nothing is charged automatically. See pricing.
How it compares
If you only need your AI to read and change Meta ads, Meta's own ads MCP server is free. Tera Ads adds approval in Tera Ads before a change, a 7-day undo, and your store's profit after returns. Each comparison below has sources for every fact:
Questions
Is the server's code in this repo? No. Tera Ads runs the server at https://teraads.co/mcp. This repo holds the setup files, skills and docs, under the MIT licence.
Does it work outside the US? Yes. Tera Ads works worldwide, shows money in your store's own currency and charges in yours.
Does my AI see customer details? No. Store tools return totals only: no names, emails, addresses or order numbers.
Does it cover Google Ads? Profit after returns subtracts your Google ad spend too. Your AI can't read or change Google campaigns through Tera Ads yet.
Is profit exact? It is an estimate for the whole store, built from store orders at your margin setting. It is not split by campaign, and it is not cash in the bank.
Links
MCP Registry name:
co.teraads/connect
This server cannot be deployed
Maintenance
Related MCP Connectors
Run Meta Ads and Google Ads for your Shopify store from Claude, ChatGPT or Cursor, with the store's own Shopify, Stripe or Klaviyo revenue next to ad spend. New campaigns are created paused.
- mcpOAuthio.autoady.www
Run Meta ads from your AI assistant: briefings, drop diagnosis, winners, budgets, receipts.
Meta ads from your AI assistant: results, wasted spend, campaigns. Every change is previewed first.
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceConnects Google Ads, Meta Ads, and LinkedIn Ads to AI assistants, enabling natural language ad campaign management, reporting, and optimization across platforms.MIT- FlicenseNot gradedqualityCmaintenanceConnects AI assistants to Google Ads, Meta Ads, ChatGPT Ads, TikTok Ads and LinkedIn Ads so users can query live campaign performance, budgets and audiences in the account's own currency and prepare changes as proposals that only take effect after explicit approval. Reads run immediately, while every write is staged as an approvable proposal with before/after values, and newly created campaigns, ad sets and ads start paused.1-
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to read Meta Ads performance with breakdowns and diagnostics and to create, update, or pause campaigns, ad sets, ads, creatives, audiences, and catalogs, with every write requiring explicit user approval. Runs as a hosted, OAuth-authenticated remote server with no local install.1MIT
- AlicenseNot gradedqualityBmaintenanceConnects Meta advertising accounts to AI assistants so users can query campaign performance, pull insights and metrics, and explore audiences and targeting options in natural language. It also allows creating, updating, and deleting campaigns, ad sets, ads, creatives, and lead forms, with new campaigns paused by default and write or destructive actions gated by admin permissions.MIT