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