scroll-world
A skill that turn any brand into a scrollable 3D world landing page
Read-only TikTok Business API: GMV Max campaigns and reports, ads, BC balances.
Skills that teach the AI this kind of work; they work alongside this one
A skill that turn any brand into a scrollable 3D world landing page
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install TikTok GMV Max. Follow https://mcp.popnx.com/i/buer2333-tiktok-gmvmax-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a TikTok GMV Max key (create it on the maker’s site) · 1 setting(s) to fill in (TIKTOK_APP_ID) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server TikTok GMV Max for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "tiktok-gmvmax": { "command": "uvx", "args": [ "tiktok-gmvmax-mcp" ], "env": { "TIKTOK_APP_ID": "your-value", "TIKTOK_SECRET": "your-value", "TIKTOK_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the TikTok GMV Max tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
TIKTOK_APP_ID TikTok Business API app IDDescriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"tiktok-gmvmax": {
"command": "uvx",
"args": [
"tiktok-gmvmax-mcp"
],
"env": {
"TIKTOK_APP_ID": "your-value",
"TIKTOK_SECRET": "your-value",
"TIKTOK_ACCESS_TOKEN": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use TikTok GMV Max and tell me what you can do for me, then show me one thing✓ If Claude says it is using TikTok GMV Max or shows a TikTok GMV Max tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TIKTOK_ACCESS_TOKEN_2 Optional second token, tried on permission errorsDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect TikTok GMV Max yet
TikTok GMV Max runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect TikTok GMV Max
B · Others in Marketing & social media that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a TikTok GMV Max key (create it on the maker’s site) · 1 setting(s) to fill in (TIKTOK_APP_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server TikTok GMV Max for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user tiktok-gmvmax --env TIKTOK_APP_ID=your-value --env TIKTOK_SECRET=your-value --env TIKTOK_ACCESS_TOKEN=your-value -- uvx tiktok-gmvmax-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the TikTok GMV Max tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
TIKTOK_APP_ID TikTok Business API app IDDescriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user tiktok-gmvmax --env TIKTOK_APP_ID=your-value --env TIKTOK_SECRET=your-value --env TIKTOK_ACCESS_TOKEN=your-value -- uvx tiktok-gmvmax-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see TikTok GMV Max listed as connected
Use TikTok GMV Max and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using TikTok GMV Max or shows a TikTok GMV Max tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TIKTOK_ACCESS_TOKEN_2 Optional second token, tried on permission errorsDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a TikTok GMV Max key (create it on the maker’s site) · 1 setting(s) to fill in (TIKTOK_APP_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server TikTok GMV Max for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "tiktok-gmvmax": { "command": "uvx", "args": [ "tiktok-gmvmax-mcp" ], "env": { "TIKTOK_APP_ID": "your-value", "TIKTOK_SECRET": "your-value", "TIKTOK_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the TikTok GMV Max tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
TIKTOK_APP_ID TikTok Business API app IDDescriptions are as written by the maker.
In the TikTok GMV Max settings, TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use TikTok GMV Max and tell me what you can do for me, then show me one thing✓ If Cursor says it is using TikTok GMV Max or shows a TikTok GMV Max tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TIKTOK_ACCESS_TOKEN_2 Optional second token, tried on permission errorsDescriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a TikTok GMV Max key (create it on the maker’s site) · 1 setting(s) to fill in (TIKTOK_APP_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server TikTok GMV Max for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "tiktok-gmvmax": { "type": "stdio", "command": "uvx", "args": [ "tiktok-gmvmax-mcp" ], "env": { "TIKTOK_APP_ID": "your-value", "TIKTOK_SECRET": "your-value", "TIKTOK_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the TikTok GMV Max tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
TIKTOK_APP_ID TikTok Business API app IDDescriptions are as written by the maker.
In the TikTok GMV Max settings, TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use TikTok GMV Max and tell me what you can do for me, then show me one thing✓ If VS Code says it is using TikTok GMV Max or shows a TikTok GMV Max tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
TIKTOK_ACCESS_TOKEN_2 Optional second token, tried on permission errorsDescriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user tiktok-gmvmax --env TIKTOK_APP_ID=your-value --env TIKTOK_SECRET=your-value --env TIKTOK_ACCESS_TOKEN=your-value -- uvx tiktok-gmvmax-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"tiktok-gmvmax": {
"command": "uvx",
"args": [
"tiktok-gmvmax-mcp"
],
"env": {
"TIKTOK_APP_ID": "your-value",
"TIKTOK_SECRET": "your-value",
"TIKTOK_ACCESS_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"tiktok-gmvmax": {
"command": "uvx",
"args": [
"tiktok-gmvmax-mcp"
],
"env": {
"TIKTOK_APP_ID": "your-value",
"TIKTOK_SECRET": "your-value",
"TIKTOK_ACCESS_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"tiktok-gmvmax": {
"type": "stdio",
"command": "uvx",
"args": [
"tiktok-gmvmax-mcp"
],
"env": {
"TIKTOK_APP_ID": "your-value",
"TIKTOK_SECRET": "your-value",
"TIKTOK_ACCESS_TOKEN": "your-value"
}
}
}
}TIKTOK_APP_ID required envTIKTOK_SECRET secret required envTIKTOK_ACCESS_TOKEN secret required envTIKTOK_ACCESS_TOKEN_2 secret envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account Buer2333, which owns the repo
Code last changed 14 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for tiktok-gmvmax-mcp@0.2.1
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/buer2333-tiktok-gmvmax-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 14 days ago, and the latest version (0.2.1) reached the registry 14 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| This one TikTok GMV Max | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | Yes | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
A read-only Model Context Protocol server for the TikTok Business (Marketing) API, with first-class GMV Max support. Ask your assistant how your GMV Max campaigns, regular ads, and Business Center budgets are doing, and get answers in your shop's timezone and in USD.
It runs daily in production behind a multi-shop TikTok Shop reporting stack, so most of the code beyond plain API wrappers handles things the raw API gets wrong. Report days are realigned from the ad account's timezone to the shop's. Non-USD accounts are converted at that day's rate. TikTok's transient 51010 timeouts are retried.
The Python import package
tiktok_ads_mcphas the same name as the one in thetiktok-ads-mcpPyPI distribution, so don't install both into the same environment.
GMV Max
| Tool | What it returns |
|---|---|
get_gmvmax_campaigns_tool | GMV Max campaigns with status and ROI-protection info |
get_gmvmax_campaign_info_tool | Budget, bid, products and schedule for one campaign |
get_gmvmax_reports_tool | GMV Max performance reports (/gmv_max/report/get/) |
get_gmvmax_report_aligned_tool | One shop-timezone day, rebuilt from hourly data: cost, gross revenue, orders, ROI |
get_gmvmax_range_report_tool | Aggregate cost / GMV / orders / ROI for a date range |
get_gmvmax_videos_tool | Videos available to GMV Max for a store |
get_gmvmax_store_list_tool | Stores linked to a GMV Max advertiser |
Accounts, campaigns and ads
| Tool | What it returns |
|---|---|
get_business_centers_tool | Business Centers visible to the token |
get_authorized_ad_accounts_tool | All authorized advertiser accounts |
get_campaigns_tool / get_ad_groups_tool / get_ads_tool | Campaign, ad group and ad lists with filtering |
get_identities_tool | TikTok identities (creator accounts) authorized to an advertiser |
get_video_info_tool | Video asset URL, poster and duration by video ID |
Reporting
| Tool | What it returns |
|---|---|
get_reports_tool | Integrated reports with custom dimensions and metrics |
get_ads_report_aligned_tool | Manual-bid ads, one shop-timezone day: cost, GMV, orders, ROAS |
get_ads_range_report_tool | Manual-bid ads aggregate for a date range |
get_creative_report_tool | Creative-level video insights (engagement, play metrics) |
Business Center finance
| Tool | What it returns |
|---|---|
get_advertiser_balance_tool | Balance and basic info per advertiser (≤100 IDs per call) |
get_bc_balance_tool | Business Center available funds |
get_bc_account_cost_tool | Spend per ad account under a BC for a date range |
get_bc_transactions_tool | Top-ups and deductions at BC or advertiser level |
get_bc_budget_changelog_tool | Who changed an advertiser's budget, and when |
Discovery
| Tool | What it returns |
|---|---|
get_trending_list_tool | Trending hashtags by country (7 or 30 days), optional daily history |
Requires Python 3.10+.
uvx tiktok-gmvmax-mcp # run without installing
pip install tiktok-gmvmax-mcp # provides the tiktok-gmvmax-mcp command
Create an app in the TikTok for Business developer portal, grant it read permissions for the endpoints you need (ad accounts, campaigns and ads, reporting, GMV Max, Business Center), and generate a long-lived access token.
| Variable | Required | Meaning |
|---|---|---|
TIKTOK_APP_ID | yes | App ID |
TIKTOK_SECRET | yes | App secret |
TIKTOK_ACCESS_TOKEN | yes | Access token |
TIKTOK_ACCESS_TOKEN_2 | no | Second token (e.g. another Business Center), tried on permission errors |
TIKTOK_ADVERTISER_ID | no | Default advertiser |
TIKTOK_SANDBOX | no | true to use the sandbox API |
TIKTOK_REQUEST_TIMEOUT | no | Seconds, default 30 |
TIKTOK_ADS_PROXY | no | Proxy URL used only for Business API calls |
LARK_BOT_CACHE_DIR | no | Where FX rates are cached (default ~/.cache/lark-bot) |
Versions before 0.2 read the token from TIKTOK_ACCESS_TOKEN_XINCHENG / TIKTOK_ACCESS_TOKEN_ZECHENG. Those names still work.
Claude Desktop / Claude Code (mcpServers):
{
"mcpServers": { "tiktok-gmvmax": { "command": "uvx", "args": ["tiktok-gmvmax-mcp"], "env": { "TIKTOK_APP_ID": "your_app_id", "TIKTOK_SECRET": "your_secret", "TIKTOK_ACCESS_TOKEN": "your_access_token" } } } }
*_aligned_tools fetch hourly rows and re-aggregate them into a day in the shop's timezone, so ad spend lines up with shop orders.51010 (TikTok backend timeout) is retried with backoff at the client layer. Rate-limit and 5xx errors are retried too.MCPServer (2.x) and falls back to FastMCP (1.x).git clone https://github.com/Buer2333/tiktok-gmvmax-mcp && cd tiktok-gmvmax-mcp
python -m venv .venv && .venv/bin/pip install -e ".[dev]" .venv/bin/python -m pytest tests -q
Issues and PRs are welcome. Please include a test with any behavior change.
tiktok-gmvmax-mcp; package links updated.tiktok-gmvmax-mcp.TIKTOK_ACCESS_TOKEN / TIKTOK_ACCESS_TOKEN_2. The legacy names still work.httpx client, FastMCP server.MIT. See LICENSE.
The six core campaign/report tools are based on ysntony/tiktok-ads-mcp (MIT).