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

A
Description quality
96%
Schema completeness
98%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,591Tokens (tool definitions)
~1011 BTypical response size
Significant attention impact (2.02% of 128k context)

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-http
https://mcp.shortvidapi.com/v1/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools
auth requiredversion not recorded—