TikTok LIVE Leaderboards
MCP tools for tiktok live leaderboards operations on the Euler Stream API.
Get Catalog
List every region that has TikTok LIVE leaderboard data, with the rank names and league tiers valid for each. Call this before tiktok_live-leaderboards-get to discover valid region, rank_name and league values instead of guessing them.
Parameters
No parameters required.
No parameters required.
Get
Retrieve a TikTok LIVE leaderboard snapshot for a region and rank type (e.g. DAILY_RANK in US, or WW for worldwide). Omit date for the most recent snapshot; league applies only to RANKING_LEAGUE. Returns the top 25 creators — total_ranks reports how many the board actually holds.
Parameters
The UTC date to retrieve the snapshot for (e.g. "2026-03-09"). Omitted = the board's most recent snapshot (matching what the catalog advertises).
Optional league level filter (e.g. "D5", "A1"). Only applicable to RANKING_LEAGUE.
The region to query (or "WW" for worldwide).
Get Dates
List the dates a TikTok LIVE leaderboard has snapshots for, newest first. Call this before passing date to tiktok_live-leaderboards-get. league is required for RANKING_LEAGUE and rejected for every other rank_name. Returns the newest 31 dates — total_dates and earliest report the full span.
Parameters
League level filter (e.g. "D5", "A1"). Required for RANKING_LEAGUE, must not be provided for other rank types.
The region to query (or "WW" for worldwide).
Anchor Boards
List the leaderboards a creator appeared on within a UTC date range, as a map of region to rank names. Use it to find the region and rank_name values tiktok_live-leaderboards-anchor_history and tiktok_live-leaderboards-anchor_streams take.
Parameters
Start of the UTC date range, inclusive (e.g. "2026-03-01").
End of the UTC date range, inclusive (e.g. "2026-03-31").
TikTok numeric user id of the creator.
Anchor History
Retrieve a creator's daily rank and score on one leaderboard over a UTC date range, oldest first. Returns the newest 60 days — total_points reports how many the range holds.
Parameters
Start of the UTC date range, inclusive (e.g. "2026-03-01").
End of the UTC date range, inclusive (e.g. "2026-03-31").
The leaderboard region (e.g. "US").
TikTok numeric user id of the creator.
Anchor Streams
List the LIVE streams in which a creator was seen in the Top 99 of a leaderboard over a UTC date range, newest first, with estimated earnings per stream (DAILY_RANK only; every other board reports null). Returns the newest 25 streams — total_streams reports how many the range holds.
Parameters
Start of the UTC date range, inclusive (e.g. "2026-03-01").
End of the UTC date range, inclusive (e.g. "2026-03-31").
The leaderboard region (e.g. "US").
TikTok numeric user id of the creator.