# tiktok_live-leaderboards-get_dates

`MCP Tool`

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.

## 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 |
|-----------|------|----------|-------------|
| `league` | enum(NONE, D5, D4, D3, D2, D1, C5, C4, C3, C2, C1, B5, B4, B3, B2, B1, A3, A2, A1) | No | League level filter (e.g. "D5", "A1"). Required for RANKING_LEAGUE, must not be provided for other rank types. |
| `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). |