MCP Server for Tikfly - Unofficial TikTok API at scale without the usual limitations
12 tools with consistent verb-noun naming (get_, search_, download_). All have descriptions and input schemas with Zod validation. However, descriptions are generic (avg ~100 chars, below 194-char baseline) and lack LLM-optimized guidance. Parameter descriptions are present but often verbose and repetitive (pagination docs repeated across 6+ tools). No output schemas documented. Missing error handling guidance, recovery hints, and dependency chains. Tool descriptions state WHAT but not WHEN or WHY to use them. No tool annotations (readOnlyHint, etc.). Pagination parameters lack clear defaults and constraints.
Get downloadable videos from a specific TikTok user by their secUid. This tool returns a list of the user's videos along with direct download information. It also supports cursor-based pagination to retrieve large video lists in multiple requests.
Get list of followers for a TikTok user (by secUid) IMPORTANT: This endpoint requires secUid. If you only have a username, you MUST first call "get_user_info" to obtain secUid from the user profile.
Get list of accounts a TikTok user is following (by secUid) IMPORTANT: This endpoint requires secUid. If you only have a username, you MUST first call "get_user_info" to obtain secUid from the user profile.
Get TikTok user information by username (uniqueId)
Get active stories of a TikTok user (by userId) IMPORTANT: This endpoint requires a numeric userId. If you only have a username (uniqueId), you MUST first call "get_user_info" to retrieve userId from the profile response before calling this tool.
get_video_detail has no description or visible schema in source code. Cannot verify tool definition.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., secUid, userId, videoId) from responses.
Pagination parameter descriptions are verbose and repetitive (cursor/search_id/maxCursor/minCursor docs repeated identically across 6+ tools). No clear defaults, constraints, or guidance on when pagination is needed.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Get list of videos posted by a TikTok user. IMPORTANT: This endpoint requires secUid. If you only have a username, you MUST first call "get_user_info" to obtain secUid from the user profile.
Get reply comments for a specific comment on a TikTok video. Supports pagination via cursor.
Get list of top-level comments on a TikTok video by video ID. Supports pagination via cursor.
Search TikTok accounts (users) by keyword. Supports pagination via cursor and search_id.
Search TikTok live streams by keyword. Supports pagination via cursor and search_id
Search TikTok videos by keyword. Supports pagination via cursor and search_id.
No error handling guidance. Tools call external API (tikflyFetch) but do not document failure modes, recovery steps, or what LLM should do on 404/429/500 errors.
Tool descriptions lack LLM-optimized guidance. Missing WHEN/WHY context, dependency hints (e.g., 'Call get_user_info first to get secUid'), and chaining information. Descriptions are generic and do not guide multi-step planning.