TikTok LIVE MCP
An MCP (Model Context Protocol) server that gives Claude, Cursor, VSCode and any MCP client live access to TikTok LIVE data: detect who is live, pull room and creator data, gifts, and regional leaderboards - straight from a chat prompt.
Powered by the tik.tools platform. Free tier included. Full unmasked leaderboards, league and gaming boards, creator and gifter earnings, the eligible-creator recruiting feed, and the real-time event WebSocket are available direct at tik.tools/pricing.
Quick install
Get a free API key at tik.tools/pricing, then add the server to your client.
Claude Desktop
Edit claude_desktop_config.json:
{
"mcpServers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
Cursor
Add to ~/.cursor/mcp.json (or the project .cursor/mcp.json):
{
"mcpServers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
VSCode
Add to .vscode/mcp.json:
{
"servers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
Tools
| Tool | What it does |
|---|---|
check_live |
Is one or more creators live now (status, room id, viewers) |
get_live_status |
Fast single-creator liveness check |
get_room_info |
Full room info: host, title, viewers, start time |
get_creator_profile |
Reverse-lookup a creator profile (Pro) |
get_creator_earnings |
Diamonds and coin earnings for a creator |
get_room_rankings |
In-room top gifters and audience ranking |
get_popular_live |
TikTok's real-time Popular LIVE board per region (Agency) |
find_eligible_creators |
Score-ranked creators to recruit per region (Agency) |
get_gift_catalog |
Global gift catalog: names, diamond cost, icons |
get_gift_gallery |
A creator's pre-live gift wishlist |
get_live_feed |
Discover live streams in a region (Pro) |
get_trending_hashtags |
Trending live hashtags with viewer counts |
get_rate_limits |
Your key's tier, limits and remaining quota |
Configuration
| Env var | Default | Notes |
|---|---|---|
TIKTOOLS_API_KEY |
- | Required. Free key at https://tik.tools/pricing |
TIKTOOLS_API_BASE |
https://api.tik.tools |
Override only for testing |
Real-time events
For live chat, gift, battle and caption streams, connect a WebSocket:
wss://api.tik.tools/?uniqueId=<username>&apiKey=YOUR_KEY
Full docs: tik.tools/docs
License
MIT
