For AI agents and developers

TikTok LIVE, wired into your AI

One MCP server drops live TikTok data into Claude, Cursor, VSCode and any MCP client. Detect who is live, pull creator and room data, gifts, and leaderboards - straight from a prompt. Free tier, no credit card.

Add the MCP server

One click wires it straight into your client. Swap YOUR_KEY for your free key once it is added.

11 tools. Full list with the tier each one needs is below.

Set your API key

Every tool call is authenticated. With no key set, each call comes back with No API key configured, so do this before the first prompt.

  1. Get a free key at tik.tools/pricing. No credit card.
  2. Put it in the server's env block as TIKTOOLS_API_KEY.
  3. Restart your client so it reloads the server.
claude_desktop_config.json / ~/.cursor/mcp.json
{
  "mcpServers": {
    "tiktok-live": {
      "command": "npx",
      "args": ["-y", "tiktok-live-mcp"],
      "env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
    }
  }
}

VS Code uses servers instead of mcpServers - see the config tabs above. TIKTOOL_API_KEY and TIKTOK_LIVE_API_KEY also work if your setup already uses one of those names.

The 11 tools

Ask in plain language and the client picks the tool. The tier column is the lowest key that returns data for that tool.

ToolMinimum tier
get_rate_limitsAny key
get_live_statusAny key
check_liveBasic
get_room_infoBasic
get_creator_profilePro
get_gift_catalogAny keyNo arguments needed. Optional username, search, limit.
get_gift_galleryAny key
get_live_feedPro
get_leaderboardAny keyDaily board. type=league needs Ultra, type=weekly, gaming and shopping need Agency.
get_popular_liveAny keyMasked below Agency.
find_eligible_creatorsAgency Global

Every way to connect

Same data, whichever surface your stack lives on.

Premium data, direct

Free tier covers live detection, room data, gifts and rankings. Full unmasked leaderboards, league and gaming boards, creator and gifter earnings, the eligible-creator recruiting feed, and the real-time event WebSocket unlock at tik.tools.

See pricing