Sprites MCP · TikTok Ads MCP server · Gemini

TikTok 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 TikTok 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 TikTok openings are converting?

Spritesanalyzerunning
SpritesTikTokNeeds your approval
  • Problem-first openCTR 2.4% · CPA $18
  • Founder to cameraCTR 1.9% · CPA $24
  • Product beauty shotCTR 0.6% · CPA $91
Beauty shots are burning 31% of spendRotate

Add Sprites to Gemini

Available on Gemini CLI, free and paid, on macOS, Linux and Windows. You need a Sprites account with TikTok Ads already connected — the connector acts on that connection, so Gemini never handles a TikTok 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 TikTok Ads MCP vs Sprites MCP

TikTok runs its own MCP server at business-api.tiktok.com/open_mcp/tt-ads-mcp-layer. Here is what each one covers, so you can pick the one that fits in Gemini — or connect both.

TikTok for Business hosts its own MCP server for the Marketing API, with no developer credentials needed. It comes in two shapes: a flat server exposing about 400 tools, and a layered one exposing about 40 core tools and loading the rest as needed. Between them they read and write campaigns, audiences, bidding, creative and catalogs — on TikTok, and only TikTok.

TikTok’s official TikTok for Business MCP server compared with the Sprites MCP server
TikTok officialbusiness-api.tiktok.com/open_mcp/tt-ads-mcp-layerSprites MCPapproval-gated
Endpointbusiness-api.tiktok.com/open_mcp/tt-ads-mcp-layer (or -flat)mcp.sprites.ai/mcp
ToolsAbout 40 core tools layered, or about 400 flatBroad doors: analyze, optimize, launch, change
ChannelsTikTokTikTok plus Meta, Google Ads, LinkedIn, Reddit, GA4 and SEO
WritesCampaigns, audiences, bidding and creative through the APIEach change an approval card with before and after, applied only on approve
New creativeManages creative you have uploadedDrafts hooks, scripts and concepts from the ads converting in your account
AnalysisReturns data for the model to readA TikTok specialist compares CPA and CTR across every ad before answering

If you run TikTok alone and want its data and controls in a chat, TikTok’s own server is the direct route — choose the layered version so 400 tool descriptions do not crowd out your question. Use Sprites when TikTok is one channel of several, when you want the next creative batch drafted, or when every change should wait for an approval your team can see.

Run the first prompt

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

  • With Sprites, which TikTok ads have the lowest CPA this month?
  • Ask Sprites for 6 new TikTok hooks based on our top performer.
  • Use Sprites to find TikTok ad groups spending with no conversions in 7 days.
  • Have Sprites launch a TikTok campaign for the summer bundle at $150/day.
  • With Sprites, find TikTok hook ideas in what our customers complain about on Reddit.

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

What Gemini can do with TikTok 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.

Read performance by ad, not just by campaign

Spend, CTR, CPC, conversions and CPA for every ad, so the openings that convert stand apart from the ones that do not.

Keep the batch coming

New hooks and scripts drafted against the ones already earning, in the volume the platform demands.

Rotate before the drop

The day a creative's CPA breaks trend, and what to swap in.

Hooks from real audience language

Pain points and phrasing mined from Reddit threads in your category, turned into openings you can test.

Launch in the right shape

Campaign, ad groups and ads built for TikTok's structure, not a search campaign wearing a costume.

Stop feeding the losers

Ad-group spend moved onto the creatives that convert, with the trade stated in the card.

How approvals work here

Gemini renders tool results as text, so a TikTok 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 groups, ads and their status
  • Spend, impressions, clicks, CTR, CPC, CPM, conversions and CPA
  • Per-ad performance for every creative
  • Your uploaded videos, images and music

What it can change

  • Create campaigns, ad groups and ads
  • Budgets, schedules, statuses and targeting
  • New hooks and scripts, previewed before they ship

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.

TikTok 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 TikTok Ads account without asking?

Gemini renders tool results as text, so a TikTok 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 TikTok Ads API key or developer token?

No. TikTok Ads is connected once inside Sprites through TikTok Ads Manager, and the connector acts on that connection. Gemini never sees a credential for it.

Why Gemini for TikTok 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 TikTok Ads MCP server?

Yes. TikTok for Business runs its own hosted MCP server, in two shapes: a flat server with about 400 tools and a layered one with about 40 core tools loaded progressively. It reads and writes TikTok only. Sprites is a separate server that covers TikTok with Meta, Google, LinkedIn and Reddit, drafts new hooks and concepts, and holds every change for approval.

Can it upload video?

It drafts hooks, scripts and concepts and proposes the ad; the video file itself is attached in the approval card before anything publishes.

Keep going

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

All TikTok guides

TikTok Ads, from Gemini

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