TikTok LIVE, wired into your AI
One MCP server drops live TikTok data into Claude, Cursor, VSCode and any MCP client. Detect who is live, pull creator and room data, gifts, and leaderboards - straight from a prompt. Free tier, no credit card.
Add the MCP server
One click wires it straight into your client. Swap YOUR_KEY for your free key once it is added.
11 tools. Full list with the tier each one needs is below.
Set your API key
Every tool call is authenticated. With no key set, each call comes back with No API key configured, so do this before the first prompt.
- Get a free key at tik.tools/pricing. No credit card.
- Put it in the server's
envblock asTIKTOOLS_API_KEY. - Restart your client so it reloads the server.
{
"mcpServers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}VS Code uses servers instead of mcpServers - see the config tabs above. TIKTOOL_API_KEY and TIKTOK_LIVE_API_KEY also work if your setup already uses one of those names.
The 11 tools
Ask in plain language and the client picks the tool. The tier column is the lowest key that returns data for that tool.
| Tool | Minimum tier |
|---|---|
get_rate_limits | Any key |
get_live_status | Any key |
check_live | Basic |
get_room_info | Basic |
get_creator_profile | Pro |
get_gift_catalog | Any keyNo arguments needed. Optional username, search, limit. |
get_gift_gallery | Any key |
get_live_feed | Pro |
get_leaderboard | Any keyDaily board. type=league needs Ultra, type=weekly, gaming and shopping need Agency. |
get_popular_live | Any keyMasked below Agency. |
find_eligible_creators | Agency Global |
Every way to connect
Same data, whichever surface your stack lives on.
MCP server
npx tiktok-live-mcp in Claude, Cursor, VSCode and Windsurf.
View on npm Custom GPTOpenAI GPT Actions
Point a Custom GPT at the OpenAPI spec and query live data in chat.
Get the schema MarketplaceRapidAPI
The full REST API on the RapidAPI marketplace, free tier included.
Open listing AutomationApify Actor
Run live detection and leaderboards as an Apify Actor.
Open Actor SDKsNode and Python
@tiktool/live and tiktok-live-api - stream chat and gifts in 20 lines.
View docs RealtimeWebSocket
wss://api.tik.tools - chat, gifts, battles and captions as they happen.
Read the docsPremium data, direct
Free tier covers live detection, room data, gifts and rankings. Full unmasked leaderboards, league and gaming boards, creator and gifter earnings, the eligible-creator recruiting feed, and the real-time event WebSocket unlock at tik.tools.
See pricing