SpritesI stopped doing this in week 2Shop now
Add Sprites to Codex
Available on Anywhere Codex CLI runs — a ChatGPT plan that includes Codex, or an API key. You need a Sprites account with TikTok Ads already connected — the connector acts on that connection, so Codex never handles a TikTok credential.
Add the server
One command writes the entry into ~/.codex/config.toml for you.
Terminalcodex mcp add sprites --url https://mcp.sprites.ai/mcpOr write the config by hand
The same entry in ~/.codex/config.toml, or in .codex/config.toml inside a trusted project when you want the connector scoped to one repo.
~/.codex/config.toml[mcp_servers.sprites] url = "https://mcp.sprites.ai/mcp" auth = "oauth"Sign in
Codex opens a browser for the Sprites consent screen and stores the token locally. Sprites supports dynamic client registration and client ID metadata documents, so there is nothing to pre-register.
Terminalcodex mcp login spritesApprove changes by name
Codex renders results as text, so a pending change comes back written out rather than as a card you can click. Nothing is applied until you approve it, and the approval waits for you in Sprites — open it there and the same run continues.
Pending changeChangeDaily budget $40 → $65Gategate_7f2c…
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 Codex — 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 officialbusiness-api.tiktok.com/open_mcp/tt-ads-mcp-layer | Sprites MCPapproval-gated | |
|---|---|---|
| Endpoint | business-api.tiktok.com/open_mcp/tt-ads-mcp-layer (or -flat) | mcp.sprites.ai/mcp |
| Tools | About 40 core tools layered, or about 400 flat | Broad doors: analyze, optimize, launch, change |
| Channels | TikTok | TikTok plus Meta, Google Ads, LinkedIn, Reddit, GA4 and SEO |
| Writes | Campaigns, audiences, bidding and creative through the API | Each change an approval card with before and after, applied only on approve |
| New creative | Manages creative you have uploaded | Drafts hooks, scripts and concepts from the ads converting in your account |
| Analysis | Returns data for the model to read | A 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 Codex 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 `codex mcp list` and confirm sprites shows as connected.
What Codex can do with TikTok Ads
The same doors, whichever client you are in. Marketing work that belongs in a commit: Codex can read the landing page it is about to ship and brief Sprites on the campaign pointing at it, in one session.
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
Codex 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 Codex
Three things go wrong in this client specifically, and each has a one-line fix.
Codex says the tool is not found.
The config was edited while a session was open. Restart Codex — it reads config.toml at startup.
Login loops without ever completing.
The OAuth callback defaults to http://127.0.0.1/callback. If something else on the machine holds that port, set mcp_oauth_callback_url in config.toml and log in again.
Codex says a change was applied and nothing happened in the account.
It was proposed, not applied — that is the design. The approval is waiting in Sprites; open it there and the run continues from where it stopped.
TikTok Ads and Codex: questions
Which URL do I paste into Codex?
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 Codex change my TikTok Ads account without asking?
Codex 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. Codex never sees a credential for it.
Why Codex for TikTok Ads specifically?
Marketing work that belongs in a commit: Codex can read the landing page it is about to ship and brief Sprites on the campaign pointing at it, in one session.
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 Codex connector reaches every other channel — nothing else to add.
TikTok Ads, from Codex
Paste one URL, sign in once, and the next TikTok question you ask Codex gets answered from the live account.