Skip to main content
Glama
tiktooldev

tiktok-live-mcp

by tiktooldev

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

-
license - not tested
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tiktooldev/tiktok-live-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server