What it does
The server exposes 24 read-only tools over the TikTok Business (Marketing) API. They cover GMV Max campaigns and performance reports, regular ads and creatives, Business Center balances, spend and transactions, and trending hashtags. Report days are realigned from the ad account's timezone to the shop's, and cost and revenue in non-USD accounts are converted to USD at that day's ECB midpoint rate.
It suits questions an assistant should answer from TikTok data, such as how GMV Max campaigns or regular ads are performing, or how Business Center budgets are moving. Because spend is aligned to the shop's day, it can be compared with shop orders. Transient TikTok timeouts (code 51010) and rate-limit or 5xx errors are retried automatically.
Setup needs Python 3.10 or later and a TikTok for Business developer app with read permissions for the endpoints you need, plus a long-lived access token. The app ID, app secret and access token are required; a second token, default advertiser ID, sandbox switch, request timeout and proxy are optional. It is registered as an mcpServers entry in Claude Desktop or Claude Code and works with mcp 1.x and 2.x.
Limitations and requirements
Requires Python 3.10+, a TikTok for Business developer app with read permissions, and a long-lived access token; TIKTOK_APP_ID, TIKTOK_SECRET and TIKTOK_ACCESS_TOKEN are mandatory. Do not install it alongside the tiktok-ads-mcp PyPI distribution in the same environment, as both use the same Python import package name. If the FX rate API is unavailable, an approximate built-in rate table is used for that call only; currencies other than USD without a rate are returned unconverted (rate 1.0) with a logged error.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
TikTok GMV Max
Read-only TikTok Business API: GMV Max campaigns and reports, ads, BC balances.
v0.2.1As shown on registry.modelcontextprotocol.io when we last read it