Sprites MCP · Meta Ads MCP server · Gemini

Meta Ads MCP for Gemini: setup in two minutes

Add https://mcp.sprites.ai/mcp as a custom MCP connector in Gemini, sign in to Sprites, and Gemini can read your Meta Ads account and propose changes to it. Setup takes about two minutes and needs no API key. Every write comes back as an approval before it touches the account.

MCP server URLhttps://mcp.sprites.ai/mcp

5 steps · about 2 minutes

GeminiSprites connected

Which Meta creatives are fatiguing?

Spritesanalyzerunning
SpritesMetaNeeds your approval
  • UGC — kitchen v2freq 4.8 · CTR −41%
  • Static — price anchorfreq 1.9 · CTR flat
  • Carousel — 5 SKUsfreq 6.1 · CPA +73%
2 of 38 ads are past the breakReplace

Add Sprites to Gemini

Available on Gemini CLI, free and paid, on macOS, Linux and Windows. You need a Sprites account with Meta Ads already connected — the connector acts on that connection, so Gemini never handles a Meta credential.

  1. Open the Gemini settings file

    Gemini CLI keeps MCP servers in its settings JSON. Use ~/.gemini/settings.json to have Sprites available everywhere, or .gemini/settings.json inside a project to scope it there.

    Gemini CLI
    ~/.geminisettings.json
  2. Add Sprites under mcpServers

    Use httpUrl, not url or command — that is the key Gemini CLI reads for a streamable HTTP endpoint. A url entry is treated as SSE and a command entry as a local process, and neither is what this is.

    ~/.gemini/settings.json
    {
      "mcpServers": {
        "sprites": {
          "httpUrl": "https://mcp.sprites.ai/mcp"
        }
      }
    }
  3. Sign in

    Gemini CLI supports OAuth 2.0 for remote servers and discovers the authorization server from the endpoint itself. Restart the CLI, and the first call opens a browser for the Sprites consent screen; the token is stored in ~/.gemini/mcp-oauth-tokens.json.

    Spriteswants access on behalf of Gemini
    • Read your connected ad accounts and site data
    • Draft campaigns, creatives and pages for your approval
    • Apply only the changes you approve
    AllowCancel
  4. Check it landed

    Type /mcp in the CLI to list every server and the tools it exposes, or run gemini mcp list from a shell to see connection status without opening a session.

    Terminal
    gemini mcp list

Official Meta Ads MCP vs Sprites MCP

Meta runs its own MCP server at https://mcp.facebook.com/ads. Here is what each one covers, so you can pick the one that fits in Gemini — or connect both.

Meta hosts its own Ads MCP server as part of its ads AI connectors, alongside an Ads CLI for the terminal. You add it to ChatGPT, Claude or any MCP client as a custom connector and sign in with your Facebook Business login. It covers reporting, creating and editing campaigns, ad sets and ads, catalogs, datasets, A/B tests and conversion lift studies — on Meta, and only Meta.

Meta’s official Meta Ads MCP server compared with the Sprites MCP server
Meta officialhttps://mcp.facebook.com/adsSprites MCPapproval-gated
Endpointmcp.facebook.com/adsmcp.sprites.ai/mcp
ChannelsFacebook and InstagramMeta plus Google Ads, LinkedIn, TikTok, Reddit, GA4, Shopify, SEO and more — one connector
Setup in ChatGPTDeveloper-mode app, Facebook Business sign-inDeveloper-mode app, Sprites sign-in — Meta is connected once inside Sprites
WritesNew campaigns, ad sets and ads created paused; activation confirmed in your AI clientProposed as an editable card with before and after; applied only on approve
New creativeBuilds ads from creative you already haveDrafts hooks, headlines and image concepts, previewed in the placement
Competitor adsYour own ad accounts onlyLive ads from any advertiser in the Meta Ad Library
AnalysisInsights returned as data for the model to readA Meta specialist reads fatigue, frequency and learning phase before answering
Catalogs, datasets, lift studiesYes — its strongest groundNot the focus: campaigns, creative and budget are

If you only want to read Meta campaign data in ChatGPT, or you manage catalogs and lift studies, Meta’s official connector may be enough. Use Sprites when you run more than Meta, want new creative drafted rather than just managed, want competitor ads in the same thread, or need every write staged as an approval your team can see before it spends.

Why run Meta ads through Sprites

Gemini is the interface; the connector decides what it can see and what it is allowed to do. Six things change when that connector is Sprites.

Advice that sees every channel

A Meta-only connector can only ever answer with Meta. Sprites reads Meta beside Google Ads, TikTok, LinkedIn, Reddit, GA4 and Shopify, so it can say the next $1,000 earns more on Google search than on a tired prospecting ad set — and propose the move as one approval.

Every channel on one connector

No stake in your Meta budget

Meta earns more when you spend more on Meta. Sprites is priced per plan, not as a share of spend, so it earns the same whether it tells you to raise a budget, cut one, or move the money off Meta entirely.

See what competitors are running

Ask for any advertiser and Sprites returns their live Meta ads, longest-running first, read as hooks, offers and formats rather than screenshots — then drafts tests for your account from what is clearly working for theirs.

Browse the ads library

It makes the ads, not just the campaign

Hooks, headlines, primary text and on-brand images, generated from your brand kit and previewed in the real Feed, Stories and Reels placements. Campaign, ad sets, audiences and creative arrive as one proposal.

Connected the way Meta intends

Meta is connected once in Sprites through Meta’s own OAuth, with the standard ads scopes — ads_read, ads_management, business_management. No developer app, no system-user token pasted into a chat, and ChatGPT never holds a Meta credential. Calls are paced per ad account, so a busy agent cannot rate-limit you out of your own account.

Built so agents can’t do unsafe things

Safety lives in the harness, native to ads — not in a prompt the model can ignore. Sprites catches edits that would reset Meta’s learning, changes only what the live account allows, forecasts every budget move, and checks every number against your data. Nothing ships without your approval.

Safety built into the harness, native to ads

  • Protects the learning phase

    Sprites reads every ad set’s learning stage before it touches anything, and flags the edits that would throw Meta’s delivery algorithm back into learning — so a quick tweak never costs you a week of optimization.

  • Safe edits, on live state

    Every change is built from a fresh read of the account: which level owns the budget, which parent controls delivery, and whether Meta will accept the edit. No changes against a stale report, and a clear reason when an edit can’t be made.

  • Budget forecasting

    Every budget change is forecast into the month before you approve it, so you see exactly where it lands. Switch on an enforced ceiling and anything that would break it is refused in code.

  • Anti-hallucination

    Totals are computed in code and every figure is traced back to your account data. A number that doesn’t check out is withheld, not guessed.

  • Approval on every write

    Every change arrives with its before and after, editable in place, and applies only when you approve it — with a record of who approved.

  • Native Meta permissions

    Connected through Meta’s own OAuth with the standard ads scopes. Calls are paced per ad account so a busy agent never locks you out, and no credential ever enters the chat.

Run the first prompt

Ask Gemini this. It routes to a Sprites door, which reads your Meta Ads account and answers — no account to name, no confirmation to give first.

  • With Sprites, which Meta creatives are fatiguing and what should replace them?
  • Ask Sprites for 5 new hooks for our best-performing Instagram ad.
  • Use Sprites to compare Meta ROAS this month against last month by ad set.
  • Have Sprites check which of our Meta ad sets are stuck in learning.
  • With Sprites, show me what our top 3 competitors are running on Meta right now.

Run `gemini mcp list`, or type /mcp inside the CLI — Sprites should show as connected with its tools listed.

Running Meta Ads from Gemini

The jobs people hand over first, start to finish: what you type, what Sprites does with it, and what comes back to approve.

  1. The Monday review

    You, in GeminiWith Sprites, how did our Meta ads do last week, and what changed?

    Sprites does
    Reads spend, ROAS and CPA by campaign and ad set against the week before, then checks frequency and learning phase for the ones that moved.
    You get back
    A short read in the thread — what moved and why — with one or two proposed fixes as approval cards.
  2. Replace tired creative

    You, in GeminiAsk Sprites which Meta ads are fatiguing and draft replacements.

    Sprites does
    Finds the ads past the break on CTR and frequency, reads what is still working, and drafts new hooks, headlines and images in that direction.
    You get back
    Replacement ads previewed in placement, and one approval that swaps them in for the tired ones.
  3. Launch a campaign

    You, in GeminiUse Sprites to launch a Meta campaign for our fall sale at $80 a day.

    Sprites does
    Builds the campaign, ad sets, audiences and ads with creative attached, and checks the budget against any spend ceiling you have set.
    You get back
    One editable proposal. Change the audience, the copy or the budget in the card; nothing goes live until you approve.
  4. Competitor teardown

    You, in GeminiWith Sprites, what is Gymshark running on Meta and what should we test?

    Sprites does
    Pulls their live ads from the Meta Ad Library, longest-running first, and reads the angles, offers and formats they keep paying for.
    You get back
    Their ads in the thread, and three test concepts drafted for your account.

What Gemini can do with Meta Ads

The same doors, whichever client you are in. The account and the analytics are already Google: Gemini reads Google Ads and GA4 alongside Search Console without leaving the family it belongs to.

See fatigue before the CPA does

Frequency and the day a creative's CTR broke trend, per ad rather than per campaign.

Get new creative, not a brief

Hooks, headlines and image concepts drafted against what is already working, previewed in the real placement.

Untangle the ad sets

Learning-phase status, delivery issues and the targeting on every ad set, read side by side.

Watch the competition

Live ads from any advertiser in the Meta ad library, read as angles rather than screenshots.

Launch across placements

Campaign, ad sets, audiences and ads in one editable proposal, with the creative attached.

Reallocate on evidence

Move budget to the ad set that earns it, with the before-and-after stated in the card.

How approvals work here

Gemini renders tool results as text, so a Meta change comes back written out rather than as a card. The approval waits for you in Sprites — open it there and the same run continues. Nothing is applied until you approve it.

What it reads

  • Campaigns, ad sets, ads, audiences and their status
  • Spend, ROAS, CPA, CTR, frequency and placement breakdowns
  • Creative assets and per-creative performance
  • Public competitor ads from the Meta ad library

What it can change

  • Create campaigns, ad sets, audiences and ads
  • Budgets, schedules, statuses and targeting
  • New creative, previewed in placement before anything ships

When it does not work in Gemini

Three things go wrong in this client specifically, and each has a one-line fix.

Gemini connects but reports no tools.

The entry is probably using url rather than httpUrl, so the CLI is speaking SSE to a streamable HTTP endpoint. Change the key and restart.

Edits to settings.json do nothing.

The CLI reads its settings at startup. Restart it, then re-check with /mcp.

A project file and your home file disagree.

.gemini/settings.json in the working directory takes precedence. Keep Sprites in one of the two rather than both.

And on the Meta side

The ad account I want is not listed.

Sprites sees the ad accounts your Facebook login can manage. Ask the Business Manager admin to give your user a role on that ad account — or, for a client, have their Business add yours as a partner — then refresh the Meta connection in Sprites.

Meta says the connection has expired.

Reconnect Meta on the Sprites integrations page. The run in your agent parks rather than failing, and continues once the connection is back.

Meta returns “(#17) User request limit reached”.

Meta limits calls per ad account, shared by every tool on it. Sprites paces its calls and slows as the account nears the limit, so a heavy question becomes a slower answer. If another tool has already spent the quota, wait a few minutes and ask again.

Meta Ads and Gemini: questions

Which URL do I paste into Gemini?

https://mcp.sprites.ai/mcp. There is one endpoint and every client uses it — every OAuth grant is bound to exactly that address, so a variant of it will not be honoured.

Can Gemini change my Meta Ads account without asking?

Gemini renders tool results as text, so a Meta change comes back written out rather than as a card. The approval waits for you in Sprites — open it there and the same run continues. Nothing is applied until you approve it.

Do I need a Meta Ads API key or developer token?

No. Meta Ads is connected once inside Sprites through Meta (Facebook and Instagram) Ads, and the connector acts on that connection. Gemini never sees a credential for it.

Why Gemini for Meta Ads specifically?

The account and the analytics are already Google: Gemini reads Google Ads and GA4 alongside Search Console without leaving the family it belongs to.

Is there an official Meta Ads MCP server?

Yes. Meta runs its own Ads MCP server at mcp.facebook.com/ads, as part of its ads AI connectors. It covers Meta only: reporting, campaign and ad management, catalogs, datasets and lift studies. Sprites is a separate MCP server that reaches Meta plus Google, LinkedIn, TikTok, Reddit and SEO, drafts new creative, and stages every write as an approval.

Is it safe to let an AI agent manage my Meta ads?

With Sprites, the agent proposes and you decide. Every change arrives with its before and after and applies only when you approve it. Sprites checks the learning phase before an edit, forecasts every budget change against your ceiling, refuses an over-ceiling change in code when enforcement is on, and traces every number back to your account. The agent never holds a Meta credential.

Keep going

The same Gemini connector reaches every other channel — nothing else to add.

All Meta guides

Meta Ads, from Gemini

Paste one URL, sign in once, and the next Meta question you ask Gemini gets answered from the live account.