# MCP Tools

Model Context Protocol tools available on the Euler Stream API.

## 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"
    }
  }
}
```


## Tools

- `tiktok_live-get_room_id` — Fetch the Room ID for a TikTok user and check if they are currently live
- `tiktok-get_user_basic` — Fetch basic public TikTok profile info (nickname, region, avatar) for a user by their @unique_id (handle). Works for any TikTok user, live or not.
- `tiktok_live-get_live_feed` — Browse a random sample of TikTok LIVE streams currently live in a region. Returns each room's ID, title, viewer count and creator — use it to discover who is live rather than to look up a known user.
- `tiktok_live-get_user_id` — Resolve a TikTok @unique_id (handle) to its numeric TikTok user ID. The rankings tools all key on the numeric ID, so start here when the user gives you a handle.
- `tiktok-get_user_profile` — Fetch a TikTok user's full public profile by their @unique_id (handle): bio, verification, privacy, follower, following, like and video counts and, while they are live, their room ID. Works for any TikTok user, live or not.
- `tiktok-get_user_videos` — List a TikTok user's videos and photo posts, newest first, by their @unique_id (handle). Omit cursor for the first page; while has_more is true, pass the returned cursor back for the next page, which needs a Business plan. Returns each post's ID, caption, counts and sound: pass an ID to tiktok-get_video or tiktok-get_video_comments.
- `tiktok-get_video` — Fetch one TikTok video by its numeric video ID: caption, hashtags, sound, duration, when it was posted and play, like, comment and share counts, plus the author's handle.
- `tiktok-get_video_comments` — List the comments on a TikTok video by its numeric video ID, with each commenter's handle and the comment's like and reply counts. page starts at 0; while has_more is true, ask for the next page.
- `tiktok-get_tag_videos` — List the videos posted under a TikTok hashtag, given with or without its #. page starts at 0; while has_more is true, ask for the next page.
- `tiktok-search_users` — Search TikTok users by keyword. Returns each match's @handle, nickname, bio, verification and follower count. page starts at 0; while has_more is true, ask for the next page.
- `tiktok-search_videos` — Search TikTok videos by keyword. Returns each video's ID, caption, author, counts and sound. page starts at 0; while has_more is true, ask for the next page.
- `tiktok_live-bans-add` — Ban (kick) a user from a TikTok LIVE room
- `tiktok_live-bans-remove` — Unban a previously kicked user from a TikTok LIVE room
- `tiktok_live-bans-list` — Retrieve the list of banned users in a TikTok LIVE room
- `tiktok_live-mutes-add` — Mute a user in a TikTok LIVE room
- `tiktok_live-mutes-remove` — Unmute a user in a TikTok LIVE room
- `tiktok_live-mutes-list` — Retrieve the list of muted users in a TikTok LIVE room
- `tiktok_live-comments-toggle` — Toggle comments on or off in a TikTok LIVE room
- `tiktok_live-moderators-list` — Retrieve the list of moderators in a TikTok LIVE room
- `tiktok_live-sensitive_words-add` — Add a sensitive word to a TikTok LIVE room's filter list
- `tiktok_live-sensitive_words-remove` — Delete a sensitive word from a TikTok LIVE room's filter list
- `tiktok_live-sensitive_words-list` — Retrieve the list of sensitive words for a TikTok LIVE room
- `tiktok_live-moderators-add` — Add a moderator to a TikTok LIVE room
- `tiktok_live-moderators-remove` — Remove a moderator from a TikTok LIVE room
- `tiktok_live-leaderboards-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.
- `tiktok_live-leaderboards-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.
- `tiktok_live-leaderboards-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.
- `tiktok_live-search_ranked_anchors` — Find TikTok LIVE creators in the rankings data by @handle or nickname (at least 3 characters). Returns each match's numeric user ID, which the leaderboard tools take. limit defaults to 1 and caps at 10.
- `tiktok_live-leaderboards-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.
- `tiktok_live-leaderboards-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.
- `tiktok_live-leaderboards-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.
- `tiktok_live-search_agencies` — Search the TikTok LIVE agency catalog by agency name (at least 3 characters). Pages hold 25 agencies and start at 1; while has_more is true, ask for the next page.
- `tiktok_live-get_agency` — Retrieve one TikTok LIVE agency by its numeric catalog ID, the agency_id tiktok_live-search_agencies returns.
- `tiktok_live-get_anchor_agency` — Find the TikTok LIVE agency linked to a creator, by the creator's numeric TikTok user ID. Use tiktok_live-get_user_id to convert a @handle first.

---

## tiktok_live-get_room_id

`MCP Tool`

Fetch the Room ID for a TikTok user and check if they are currently live

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creator_id_type` | enum(unique_id, numeric_id) | No | What creator_id is: unique_id (a handle, the default) or numeric_id (a numeric TikTok user ID). A numeric ID skips the handle lookup and still finds the creator after a handle change. |
| `creator_id` | string | Yes | The creator: a TikTok handle (unique_id) by default, or a numeric TikTok user ID when creator_id_type is numeric_id. |

---

## tiktok-get_user_basic

`MCP Tool`

Fetch basic public TikTok profile info (nickname, region, avatar) for a user by their @unique_id (handle). Works for any TikTok user, live or not.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `unique_id` | string | Yes | The unique ID (handle) of the TikTok user. |

---

## tiktok_live-get_live_feed

`MCP Tool`

Browse a random sample of TikTok LIVE streams currently live in a region. Returns each room's ID, title, viewer count and creator — use it to discover who is live rather than to look up a known user.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | enum(US, GB, DE, ES, BE, FR, CA, JP, BR, MX, CO, AR, CL, AU, KR, PE, PL, SG, IT, ID, TH, SA, IL, NL, IE, PT, GR, AT, CH, HU, SK, DK, NO, SE, NZ, AM, AZ, BD, BY, BO, BG, KH, CR, HR, CY, CZ, DO, EC, EG, EE, FI, GE, GT, IS, IM, JM, KZ, KW, LV, LT, LU, MY, MD, MA, PK, PA, PH, RO, ZA, LK, TW, TR, UA, AE, VN, AL, DZ, AD, AO, BS, BH, BZ, BM, BT, BA, BN, CM, CV, KY, CU, CD, SV, FJ, GA, GH, GL, HT, HN, IQ, JE, KE, XK, LB, LI, MK, MV, MT, MH, MR, MU, MC, MN, ME, MZ, MM, NP, NG, OM, PY, PR, QA, RS, SL, SI, TG, TT, TN, UG, UY) | Yes | The region (country) with which to fetch a feed from. |

---

## tiktok_live-get_user_id

`MCP Tool`

Resolve a TikTok @unique_id (handle) to its numeric TikTok user ID. The rankings tools all key on the numeric ID, so start here when the user gives you a handle.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `unique_id` | string | Yes | The unique ID (handle) of the TikTok user. |

---

## tiktok-get_user_profile

`MCP Tool`

Fetch a TikTok user's full public profile by their @unique_id (handle): bio, verification, privacy, follower, following, like and video counts and, while they are live, their room ID. Works for any TikTok user, live or not.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `unique_id` | string | Yes | The unique ID (handle) of the TikTok user. |

---

## tiktok-get_user_videos

`MCP Tool`

List a TikTok user's videos and photo posts, newest first, by their @unique_id (handle). Omit cursor for the first page; while has_more is true, pass the returned cursor back for the next page, which needs a Business plan. Returns each post's ID, caption, counts and sound: pass an ID to tiktok-get_video or tiktok-get_video_comments.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | `cursor` from the previous page. Omit for the first page. Pages after the first require the Business plan. |
| `unique_id` | string | Yes | The unique ID (handle) of the TikTok user. |

---

## tiktok-get_video

`MCP Tool`

Fetch one TikTok video by its numeric video ID: caption, hashtags, sound, duration, when it was posted and play, like, comment and share counts, plus the author's handle.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_id` | string | Yes | The numeric TikTok video ID. |

---

## tiktok-get_video_comments

`MCP Tool`

List the comments on a TikTok video by its numeric video ID, with each commenter's handle and the comment's like and reply counts. page starts at 0; while has_more is true, ask for the next page.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | number | No | Zero-based page to fetch. Defaults to 0. Pages after the first require the Business plan. |
| `video_id` | string | Yes | The numeric TikTok video ID. |

---

## tiktok-get_tag_videos

`MCP Tool`

List the videos posted under a TikTok hashtag, given with or without its #. page starts at 0; while has_more is true, ask for the next page.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | number | No | Zero-based page to fetch. Defaults to 0. Pages after the first require the Business plan. |
| `hashtag` | string | Yes | The hashtag, with or without its #. |

---

## tiktok-search_users

`MCP Tool`

Search TikTok users by keyword. Returns each match's @handle, nickname, bio, verification and follower count. page starts at 0; while has_more is true, ask for the next page.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keyword` | string | Yes | What to search for. |
| `page` | number | No | Zero-based page to fetch. Defaults to 0. |

---

## tiktok-search_videos

`MCP Tool`

Search TikTok videos by keyword. Returns each video's ID, caption, author, counts and sound. page starts at 0; while has_more is true, ask for the next page.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keyword` | string | Yes | What to search for. |
| `page` | number | No | Zero-based page to fetch. Defaults to 0. |

---

## tiktok_live-bans-add

`MCP Tool`

Ban (kick) a user from a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tiktok_user_id` | string | Yes | The numeric user ID for the individual to kick |
| `comment_msg_id` | string | No | Optional comment message ID that triggered the kick |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-bans-remove

`MCP Tool`

Unban a previously kicked user from a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tiktok_user_id` | string | Yes | The numeric user ID of the person to unkick |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-bans-list

`MCP Tool`

Retrieve the list of banned users in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | number | No | Page number for pagination |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-mutes-add

`MCP Tool`

Mute a user in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The user ID to mute |
| `duration` | enum(-1, 5, 30, 60, 300) | No | Mute duration in seconds (-1 = permanent, 5, 30, 60, 300) |
| `comment_msg_id` | number | No | Optional comment message ID that triggered the mute |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-mutes-remove

`MCP Tool`

Unmute a user in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The user ID to unmute |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-mutes-list

`MCP Tool`

Retrieve the list of muted users in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | number | No | Page number for pagination |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |
| `x-image-source` | enum(ORIGIN, CDN, CDN_CNAME) | No | Where returned image URLs are served from (ORIGIN, CDN, CDN_CNAME). |

---

## tiktok_live-comments-toggle

`MCP Tool`

Toggle comments on or off in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enabled` | boolean | Yes | Whether comments should be enabled (true) or disabled (false) |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-moderators-list

`MCP Tool`

Retrieve the list of moderators in a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `numeric_id` | string | Yes | The streamer's numeric user ID |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |
| `x-image-source` | enum(ORIGIN, CDN, CDN_CNAME) | No | Where returned image URLs are served from (ORIGIN, CDN, CDN_CNAME). |

---

## tiktok_live-sensitive_words-add

`MCP Tool`

Add a sensitive word to a TikTok LIVE room's filter list

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `word` | string | Yes | The sensitive word to add |
| `sec_anchor_id` | string | Yes | The sec_anchor_id of the room owner |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-sensitive_words-remove

`MCP Tool`

Delete a sensitive word from a TikTok LIVE room's filter list

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `word_id` | string | Yes | The ID of the sensitive word to delete |
| `sec_anchor_id` | string | Yes | The sec_anchor_id of the room owner |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-sensitive_words-list

`MCP Tool`

Retrieve the list of sensitive words for a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sec_anchor_id` | string | Yes | The sec_anchor_id of the room owner |
| `room_id` | string | Yes | The room ID of the livestream |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-moderators-add

`MCP Tool`

Add a moderator to a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_user_id` | string | Yes | The user ID to add as moderator |
| `numeric_id` | string | Yes | The streamer's user ID |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-moderators-remove

`MCP Tool`

Remove a moderator from a TikTok LIVE room

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_user_id` | string | Yes | The user ID to remove as moderator |
| `numeric_id` | string | Yes | The streamer's user ID |
| `x-oauth-token` | string | No | OAuth access token for session resolution |
| `x-cookie-header` | string | No | Cookie header containing sessionid and tt-target-idc |

---

## tiktok_live-leaderboards-get_catalog

`MCP Tool`

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.

---

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

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

---

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

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

---

## tiktok_live-search_ranked_anchors

`MCP Tool`

Find TikTok LIVE creators in the rankings data by @handle or nickname (at least 3 characters). Returns each match's numeric user ID, which the leaderboard tools take. limit defaults to 1 and caps at 10.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The username or nickname substring to search for (minimum 3 characters). |
| `limit` | number | No | Maximum number of results to return (default 1, max 10). |

---

## tiktok_live-leaderboards-anchor_boards

`MCP Tool`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | Yes | Start of the UTC date range, inclusive (e.g. "2026-03-01"). |
| `to` | string | Yes | End of the UTC date range, inclusive (e.g. "2026-03-31"). |
| `numeric_id` | string | Yes | TikTok numeric user id of the creator. |

---

## tiktok_live-leaderboards-anchor_history

`MCP Tool`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | Yes | Start of the UTC date range, inclusive (e.g. "2026-03-01"). |
| `to` | string | Yes | End of the UTC date range, inclusive (e.g. "2026-03-31"). |
| `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(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 leaderboard region (e.g. "US"). |
| `numeric_id` | string | Yes | TikTok numeric user id of the creator. |

---

## tiktok_live-leaderboards-anchor_streams

`MCP Tool`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | Yes | Start of the UTC date range, inclusive (e.g. "2026-03-01"). |
| `to` | string | Yes | End of the UTC date range, inclusive (e.g. "2026-03-31"). |
| `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(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 leaderboard region (e.g. "US"). |
| `numeric_id` | string | Yes | TikTok numeric user id of the creator. |

---

## tiktok_live-search_agencies

`MCP Tool`

Search the TikTok LIVE agency catalog by agency name (at least 3 characters). Pages hold 25 agencies and start at 1; while has_more is true, ask for the next page.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The agency name substring to search for (minimum 3 characters). |
| `page` | number | No | 1-based page number. Defaults to 1. Pages hold 25 results. |

---

## tiktok_live-get_agency

`MCP Tool`

Retrieve one TikTok LIVE agency by its numeric catalog ID, the agency_id tiktok_live-search_agencies returns.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agency_id` | number | Yes | The numeric catalog id of the agency. |

---

## tiktok_live-get_anchor_agency

`MCP Tool`

Find the TikTok LIVE agency linked to a creator, by the creator's numeric TikTok user ID. Use tiktok_live-get_user_id to convert a @handle first.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `numeric_id` | string | Yes | The numeric TikTok user id of the agency's creator. |
