LogoEuler Stream

TikTok LIVE

MCP tools for tiktok live operations on the Euler Stream API.

Tools(7)
MCPGet Room IDMCPGet live feedMCPGet user IDMCPSearch ranked anchorsMCPSearch agenciesMCPGet agencyMCPGet anchor agency

Get Room Id

MCPtiktok_live-get_room_id

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

Parameters

creator_id_typeenum

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

The creator: a TikTok handle (unique_id) by default, or a numeric TikTok user ID when creator_id_type is numeric_id.

Playground
creator_id_typeenum
creator_id*string

Get Live Feed

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

Parameters

region*enum

The region (country) with which to fetch a feed from.

Playground
region*enum

Get User Id

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

Parameters

unique_id*string

The unique ID (handle) of the TikTok user.

Playground
unique_id*string

Search Ranked Anchors

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

Parameters

query*string

The username or nickname substring to search for (minimum 3 characters).

limitnumber= 1

Maximum number of results to return (default 1, max 10).

Playground
query*string
limitnumber

Search Agencies

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

Parameters

query*string

The agency name substring to search for (minimum 3 characters).

pagenumber= 1

1-based page number. Defaults to 1. Pages hold 25 results.

Playground
query*string
pagenumber

Get Agency

MCPtiktok_live-get_agency

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

Parameters

agency_id*number

The numeric catalog id of the agency.

Playground
agency_id*number

Get Anchor Agency

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

Parameters

numeric_id*string

The numeric TikTok user id of the agency's creator.

Playground
numeric_id*string