LogoEuler Stream

Rankings

MCP tools for rankings operations on the Euler Stream API.

Tools
MCPGet leaderboard catalogMCPGet leaderboard

Get Leaderboard Catalog

MCPrankings-get_leaderboard_catalog

List every region that has TikTok LIVE leaderboard data, with the rank names and league tiers valid for each. Call this before rankings-get_leaderboard to discover valid region, rank_name and league values instead of guessing them.

Parameters

No parameters required.

Playground

No parameters required.

Get Leaderboard

MCPrankings-get_leaderboard

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

datestring (date-time)

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).

leagueenum

Optional league level filter (e.g. "D5", "A1"). Only applicable to RANKING_LEAGUE.

rank_name*enum
region*string

The region to query (or "WW" for worldwide).

Playground
datestring
league"NONE" | "D5" | "D4" | "D3" | "D2" | "D1" | "C5" | "C4" | "C3" | "C2" | "C1" | "B5" | "B4" | "B3" | "B2" | "B1" | "A3" | "A2" | "A1"
rank_name"DAILY_RANK" | "FANS_TEAM_RANK" | "SALE_RANK" | "RANKING_LEAGUE"required
regionstringrequired
xs