# tikfly-mcp

MCP Server for Tikfly - Unofficial TikTok API at scale without the usual limitations

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tikflydotio/tikfly-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list tikflydotio/tikfly-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tikflydotio/tikfly-mcp get_user_info

# Call a tool
npx -y @smithery/cli@latest tool call tikflydotio/tikfly-mcp get_user_info '{}'
```

## Direct MCP Connection

Endpoint: `https://tikfly-mcp.run.tools`

**Required config:**
- `API-KEY` (header) — Subscribe to Tikfly and set your key: https://docs.tikfly.io/getting-started/quickstart

## Tools (12)

- `get_user_info` — Get TikTok user information by username (uniqueId)
- `get_user_videos` — Get list of videos posted by a TikTok user
- `get_user_follower` — Get list of followers for a TikTok user (by secUid)
- `get_user_following` — Get list of accounts a TikTok user is following (by secUid)
- `get_user_story` — Get active stories of a TikTok user (by userId)
- `get_video_detail` — Get detailed information of a TikTok video by video ID. Use this to fetch metadata like description, stats, creator, et…
- `get_video_comments` — Get list of top-level comments on a TikTok video by video ID. Supports pagination via cursor.
- `get_video_comment_replies` — Get reply comments for a specific comment on a TikTok video. Supports pagination via cursor.
- `search_videos` — Search TikTok videos by keyword. Supports pagination via cursor and search_id.
- `search_accounts` — Search TikTok accounts (users) by keyword. Supports pagination via cursor and search_id.
- `search_live` — Search TikTok live streams by keyword. Supports pagination via cursor and search_id
- `download_user_videos` — Get downloadable videos from a specific TikTok user by their secUid.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tikflydotio/tikfly-mcp <tool-name>
```