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…
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 hooks have the best 3-second hold 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, what are competitors running on TikTok in our category?
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 hook, not by campaign
Three-second hold, six-second hold and CPA per opening, so the pattern is visible before the spend is.
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 hold rate breaks trend, and what to swap in.
Spot the category move
What competitors are running now, read as angles you can test rather than clips you can watch.
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 hold, 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. Nothing is applied until you approve it, and the approval waits for you in Sprites — open it there and the same run continues.
What it reads
- Campaigns, ad groups, ads and their status
- Spend, CPA, ROAS, CTR, hold rate and completion
- Creative assets and per-creative performance
- Public competitor creative in the category
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. Nothing is applied until you approve it, and the approval waits for you in Sprites — open it there and the same run continues.
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.
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.
Does it read Spark ads?
Yes — Spark ads appear alongside in-feed creative with their own performance, so a creator post that works is visible next to the ads it beats.
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.