ShortVidAPI — Short-Form Video, Creators & Ads Data MCP Server
Real-time short-form video, creator profiles, comments, trends & ad data MCP. OAuth or API key.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp-server": {
"url": "https://api.shortvidapi.com/mcp"
}
}
}Remote endpoints
https://api.shortvidapi.com/mcpstreamable-httphttps://mcp.shortvidapi.com/v1/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢tiktok_video_detail(url, hd)
Fetch full metadata, engagement metrics, creator info, music track, and 1080p HD no-watermark MP4 stream URLs (hdplay) for a TikTok video URL or ID (10 credits).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "TikTok video URL or 19-digit numeric video ID (aliases: video_id, aweme_id)"
},
"hd": {
"type": "number",
"description": "Set to 1 to include 1080p HD no-watermark stream URL",
"default": 1
}
},
"required": [
"url"
]
}🟢tiktok_video_search(keywords, count, cursor, region, sort_type, ...)
Search public TikTok videos by keyword with region, sort order, and publish window filters. Costs 2 credits per video ($0.20 / 1,000 videos).
Input Schema
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"description": "Search query keywords (aliases: keyword, query, q)"
},
"count": {
"type": "number",
"description": "Videos per page (1-30)",
"default": 15
},
"cursor": {
"type": "number",
"description": "Pagination offset cursor (0 for first page)",
"default": 0
},
"region": {
"type": "string",
"description": "ISO country code (e.g. US, GB, JP, DE)",
"default": "US"
},
"sort_type": {
"type": "number",
"description": "0 = Relevance, 1 = Most Liked, 3 = Newest",
"default": 0
},
"publish_time": {
"type": "number",
"description": "0 = All, 1 = 24h, 7 = 7d, 30 = 30d, 90 = 90d, 180 = 180d",
"default": 0
}
},
"required": [
"keywords"
]
}🟢tiktok_trending_feed(region, count)
Get currently trending public TikTok videos for a target two-letter country code (2 credits per video).
Input Schema
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Two-letter ISO country code (US, GB, DE, BR, JP)",
"default": "US"
},
"count": {
"type": "number",
"description": "Number of videos to return (1-30)",
"default": 15
}
}
}🟢tiktok_user_info(unique_id, user_id)
Retrieve a TikTok creator profile (numeric user_id, secUid, bio, verification, business category) and real-time follower/heart/video counts (10 credits).
Input Schema
{
"type": "object",
"properties": {
"unique_id": {
"type": "string",
"description": "TikTok username handle without @ (e.g. tiktok, khaby.lame)"
},
"user_id": {
"type": "string",
"description": "Optional numeric TikTok user_id if unique_id is omitted"
}
}
}🟢tiktok_user_posts(unique_id, user_id, count, cursor)
Fetch public videos posted by a TikTok creator with no-watermark MP4 streams and engagement stats (2 credits per video).
Input Schema
{
"type": "object",
"properties": {
"unique_id": {
"type": "string",
"description": "TikTok username handle without @"
},
"user_id": {
"type": "string",
"description": "Optional numeric TikTok user_id"
},
"count": {
"type": "number",
"description": "Videos per page (max 35)",
"default": 15
},
"cursor": {
"type": "string",
"description": "Pagination cursor (\"0\" for first page)",
"default": "0"
}
}
}🟢tiktok_user_followers(user_id, sec_uid, count, time)
Get paginated follower accounts of a TikTok creator (up to 200 per call, 1 credit per follower).
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "Numeric TikTok user_id (resolve via tiktok_user_info first)"
},
"sec_uid": {
"type": "string",
"description": "Optional creator secUid"
},
"count": {
"type": "number",
"description": "Followers per page (max 200)",
"default": 50
},
"time": {
"type": "string",
"description": "Pagination timestamp cursor (\"0\" for first page)",
"default": "0"
}
},
"required": [
"user_id"
]
}🟢tiktok_user_following(user_id, sec_uid, count, time)
Get paginated accounts followed by a TikTok creator (up to 200 per call, 1 credit per user).
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "Numeric TikTok user_id"
},
"sec_uid": {
"type": "string",
"description": "Optional creator secUid"
},
"count": {
"type": "number",
"description": "Users per page (max 200)",
"default": 50
},
"time": {
"type": "string",
"description": "Pagination timestamp cursor (\"0\" for first page)",
"default": "0"
}
},
"required": [
"user_id"
]
}🟢tiktok_user_search(keywords, count, cursor, follower_count, profile_type)
Search TikTok creators by niche keyword with follower-tier and verified badge filters (1 credit per creator).
Input Schema
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"description": "Creator or niche search query (aliases: keyword, query, q)"
},
"count": {
"type": "number",
"description": "Creators per page (max 30)",
"default": 20
},
"cursor": {
"type": "number",
"description": "Pagination cursor",
"default": 0
},
"follower_count": {
"type": "number",
"description": "Follower tier filter: 0=All, 1=0-1K, 2=1K-10K, 3=10K-100K, 4=100K+",
"default": 0
},
"profile_type": {
"type": "number",
"description": "0=All, 1=Verified accounts only",
"default": 0
}
},
"required": [
"keywords"
]
}🟢tiktok_comment_list(url, count, cursor)
Fetch top-level comments on a TikTok video (up to 50 comments per call, 1 credit per comment).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "TikTok video URL or numeric video ID / aweme_id"
},
"count": {
"type": "number",
"description": "Comments per page (max 50)",
"default": 20
},
"cursor": {
"type": "number",
"description": "Pagination offset cursor",
"default": 0
}
},
"required": [
"url"
]
}🟢tiktok_comment_replies(video_id, comment_id, count, cursor)
Fetch nested reply threads for a specific comment on a TikTok video (1 credit per reply).
Input Schema
{
"type": "object",
"properties": {
"video_id": {
"type": "string",
"description": "Numeric TikTok video ID or video URL"
},
"comment_id": {
"type": "string",
"description": "Numeric parent comment_id"
},
"count": {
"type": "number",
"description": "Replies per page (max 50)",
"default": 20
},
"cursor": {
"type": "number",
"description": "Pagination cursor",
"default": 0
}
},
"required": [
"video_id",
"comment_id"
]
}🟢tiktok_challenge_info(challenge_name)
Get TikTok hashtag challenge metadata, numeric challenge_id, and total view/video counts (10 credits).
Input Schema
{
"type": "object",
"properties": {
"challenge_name": {
"type": "string",
"description": "Hashtag name without # (e.g. fyp, skincare, aitools)"
}
},
"required": [
"challenge_name"
]
}🟢tiktok_challenge_posts(cid, count, cursor)
Fetch public videos tagged with a TikTok hashtag challenge_id (2 credits per video).
Input Schema
{
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "Numeric TikTok challenge_id (resolve via tiktok_challenge_info first)"
},
"count": {
"type": "number",
"description": "Videos per page (max 30)",
"default": 20
},
"cursor": {
"type": "number",
"description": "Pagination cursor",
"default": 0
}
},
"required": [
"cid"
]
}🟢tiktok_music_info(url)
Get TikTok sound/music metadata, MP3 playback URL, author, duration, and usage count. Accepts a music ID, music URL, or video URL (10 credits).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "TikTok sound ID, sound URL, or TikTok video URL to extract audio from"
}
},
"required": [
"url"
]
}🟢tiktok_music_posts(music_id, count, cursor)
Fetch public TikTok videos using a specific numeric music_id (2 credits per video).
Input Schema
{
"type": "object",
"properties": {
"music_id": {
"type": "string",
"description": "Numeric TikTok music_id"
},
"count": {
"type": "number",
"description": "Videos per page (max 30)",
"default": 20
},
"cursor": {
"type": "number",
"description": "Pagination cursor",
"default": 0
}
},
"required": [
"music_id"
]
}🟢tiktok_top_ads(keyword, country_code, period, order_by, page, ...)
Search top-performing commercial ads from TikTok Creative Center by keyword, country, period, and CTR/impression rank.
Input Schema
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "Optional product, brand, or niche keyword (aliases: keywords, query, q)"
},
"country_code": {
"type": "string",
"description": "Country code (US, GB, DE, JP)",
"default": "US"
},
"period": {
"type": "number",
"description": "Window in days: 7, 30, or 180",
"default": 7
},
"order_by": {
"type": "string",
"description": "Sort metric: impression, ctr, or like",
"default": "impression"
},
"page": {
"type": "number",
"description": "Page number",
"default": 1
},
"limit": {
"type": "number",
"description": "Ads per page (max 20)",
"default": 10
}
}
}🟢tiktok_ad_detail(ads_id)
Get full creative telemetry, 1080p ad video URL, CTR curve, and landing page URL for a TikTok Creative Center ad ID (10 credits).
Input Schema
{
"type": "object",
"properties": {
"ads_id": {
"type": "string",
"description": "Numeric TikTok Creative Center ad / material ID"
}
},
"required": [
"ads_id"
]
}Community
Evidence