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, gift catalogs and regional leaderboards across 44 regions, straight from a chat prompt.

Powered by the tik.tools platform. Sandbox is a 7-day evaluation, no credit card; after 7 days requests return "Evaluation period ended" until you pick a plan. Full unmasked leaderboards, league and gaming boards, the eligible-creator recruiting feed, and the real-time event WebSocket are available at tik.tools/pricing.

Quick install

Get an 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" }
    }
  }
}

Related MCP server: TikTok Complete MCP Server

Configuration

Set any one of the three key variables. They are read in the order listed above.

Tools

Eleven tools. Tier requirements are stated on every tool that is gated; when your key is below the required tier the tool returns a clear upgrade message instead of failing.

Worked examples

Ask your MCP client in plain language; it selects the tool and arguments. The arguments each tool receives are shown below.

get_live_status - "Is creator_username live right now?"

{ "username": "creator_username" }

{ "username": "creator_username", "unique_id": "creator_username", "is_live": true, "room_id": "7000000000000000001", "cached": true }

check_live - "Which of these creators are live: creator_username, another_creator?"

{ "usernames": ["creator_username", "another_creator"] }

{
  "checked": 2,
  "live_now": ["creator_username"],
  "results": [
    { "username": "creator_username", "is_live": true, "room_id": "7000000000000000001", "viewers": null },
    { "username": "another_creator", "is_live": false, "room_id": "7000000000000000002", "viewers": null }
  ]
}

get_room_info - "What is creator_username streaming and how many viewers?"

{ "username": "creator_username" }

{
  "username": "creator_username",
  "is_live": true,
  "room_id": "7000000000000000001",
  "title": "Lets Go LIVE!",
  "viewers": 47,
  "started_at": "2026-08-02T08:42:28.000Z",
  "live_duration_seconds": 14041,
  "owner": { "id_str": "1234567890123456789", "nickname": "Creator Name", "display_id": "creator_username" }
}

get_creator_profile - "Show me the TikTok profile for creator_username." (Pro)

{ "username": "creator_username" }

Returns nickname, bio, verification flag, avatar, follower and video counts.

get_gift_catalog - "What TikTok gifts cost the most diamonds?" Callable with no arguments.

{}

{
  "scope": "global catalog",
  "total_matching": 646,
  "returned": 100,
  "gifts": [{ "id": 5655, "name": "Rose", "diamond_count": 1, "icon": "https://..." }]
}

Filter and scope it: { "search": "rose", "limit": 3 } returns only matching gifts. Passing { "username": "creator_username" } scopes the catalog to that creator's live room.

get_gift_gallery - "What gift goals has creator_username set for this stream?"

{ "username": "creator_username" }

Returns the wishlist with per-gift progress. If the creator is offline the tool answers with is_live: false and an explanatory note rather than an error.

get_live_feed - "Show me 3 TikTok streams live in the US right now." (Pro)

{ "region": "US", "count": 3 }

{
  "region": "US",
  "returned": 3,
  "daily_feed_remaining": 91,
  "streams": [
    { "username": "third_creator", "nickname": "Third Creator", "title": "Live now", "viewers": 1, "room_id": "7000000000000000003", "followers": 812 }
  ]
}

get_leaderboard - "Who are the top TikTok LIVE creators in Korea today?"

{ "region": "KR", "type": "daily" }

{ "type": "daily", "region": "KR", "region_label": "South Korea", "tier": "pro", "count": 99,
  "entries": [{ "rank": 1, "unique_id": "top_creator", "nickname": "Top Creator", "score": 1667836, "is_live": false }] }

type accepts daily, weekly, league, gaming and shopping. Requesting a board above your tier returns the requirement:

{ "gated": true, "httpStatus": 403, "message": "The league leaderboard is a Ultra-tier feature.", "required_tier": "ultra", "current_tier": "pro", "upgrade": "https://tik.tools/pricing" }

get_popular_live - "What is TikTok featuring on the Popular LIVE board in Korea?"

{ "region": "KR" }

Returns the ranked board. Below Global Agency the creator identifiers come back masked, with _upgrade_required on each masked row.

find_eligible_creators - "Find creators worth recruiting in the US." (Global Agency)

{ "region": "US", "min_score": 1000, "limit": 10 }

get_rate_limits - "How much API quota do I have left?"

{}

{ "status_code": 0, "data": { "tier": "pro", "api": { "limit": 120, "remaining": 112 }, "websocket": { "limit": 50, "current": 0 },
  "daily": { "limit": 75000, "used": 8, "remaining": 74992 }, "bulk_check_limit": 50 } }

api.limit is requests per minute, daily.limit requests per day, websocket.limit concurrent streams.

Plan limits

Current prices: tik.tools/pricing. Live service status: tik.tools/status.

Real-time events

The REST tools above answer point-in-time questions. For live chat, gift, like and battle streams (90+ event types), connect a WebSocket:

wss://api.tik.tools/?uniqueId=<username>&apiKey=YOUR_KEY

Full docs: tik.tools/docs

Changes in 0.2.4

• Registry metadata: mcpName for the official MCP Registry, glama.json, a Dockerfile for container hosts, and an MCPB manifest.json for one-click local installs.

• Sandbox wording: a 7-day evaluation, no credit card.

Changes in 0.2.0

• get_gift_catalog now works when called with no arguments and returns the parsed catalog, with optional search and limit.

• get_live_status, get_room_info and check_live now return a real live answer. Previously they returned an instruction to go fetch tiktok.com, which an MCP client cannot do.

• get_live_feed now returns parsed stream listings instead of a signed URL, and honours count.

• Added get_leaderboard with a type parameter so daily, weekly, league, gaming and shopping boards are reachable.

• TIKTOOL_API_KEY and TIKTOK_LIVE_API_KEY are accepted alongside TIKTOOLS_API_KEY.

• Every gated tool now states its minimum tier in its description.

• Removed get_creator_earnings, get_room_rankings and get_trending_hashtags. The first two need an authenticated TikTok session that an MCP client cannot supply, and the third had no working data source. They are gone rather than shipped broken.

License

MIT