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