# tiktok_live-leaderboards-get

`MCP Tool`

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.

## MCP Server

This tool is available via the Euler Stream MCP server. Connect using any MCP-compatible client.

**Endpoint:** `https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY`

**Configuration (mcp-remote):**
```json
{
  "mcpServers": {
    "euler-stream": {
      "command": "npx",
      "args": ["mcp-remote", "https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY"]
    }
  }
}
```

**Direct URL (Cursor, etc.):**
```json
{
  "mcpServers": {
    "euler-stream": {
      "url": "https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}
```


## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | 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). |
| `league` | enum(NONE, D5, D4, D3, D2, D1, C5, C4, C3, C2, C1, B5, B4, B3, B2, B1, A3, A2, A1) | No | Optional league level filter (e.g. "D5", "A1"). Only applicable to RANKING_LEAGUE. |
| `rank_name` | enum(DAILY_RANK, HOURLY_RANK, FANS_TEAM_RANK, SALE_RANK, DAILY_GAME_RANK, WEEKLY_GAME_RANK, WEEKLY_GAME_HIGHLIGHT_1, WEEKLY_GAME_HIGHLIGHT_2, WEEKLY_GAME_HIGHLIGHT_3, RANKING_LEAGUE) | Yes |  |
| `region` | enum(WW, AD, AE, AL, AM, AR, AT, AU, AZ, BA, BE, BG, BH, BO, BR, BY, CA, CH, CL, CO, CR, CZ, DE, DK, DO, DZ, EC, EE, EG, ES, FI, FR, GB, GE, GH, GR, HR, HU, ID, IE, IL, IQ, IS, IT, JM, JP, KE, KR, KZ, LB, LT, LU, LV, MA, MD, MK, MT, MX, MY, NG, NL, NO, NP, NZ, PA, PE, PH, PL, PT, RO, RS, SA, SE, SG, SI, SK, TH, TR, TT, TW, UA, US, UY, VN, ZA) | Yes | The region to query (or "WW" for worldwide). |