mcp-tiktok-video-stats

TikTok Video Stats MCP Server

An MCP server for the Mamba Labs TikTok Video Stats actor on Apify. Read public stats for TikTok posts by URL.

What's Inside

• What it does
• Quick start
• Prerequisites
• Example prompts
• Tool
• Inputs
• Pricing
• Full actor documentation
• License

What it does

Give TikTok video or photo post URLs or post IDs. You get one flat row per post with plays, likes, comments, shares, saves, caption, hashtags, post date, sound, and the author's public follower and like totals.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-tiktok-video-stats": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-tiktok-video-stats"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The get_tiktok_video_stats tool appears.

Prerequisites

• Node.js 18 or newer.
• An Apify API token from console.apify.com/account/integrations, set as APIFY_TOKEN. The server lists its tool without a token; a call needs one.

Example prompts

• "How many plays, likes, and shares does this TikTok video have?"
• "Compare the engagement on these 5 TikTok posts."
• "When was this TikTok posted, and what hashtags does it use?"

Tool

get_tiktok_video_stats. One tool. Example arguments:

{
  "videos": [
    "https://www.tiktok.com/@washingtonpost/video/7198260520103841070"
  ]
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

Input	Type	Required	Description
videos	array	no	TikTok video or photo post URLs (https://www.tiktok.com/@handle/video/ID) or numeric post IDs, up to 1,000 per run. Duplicates are read once.
max_videos	number	no	The most posts to read in this run, from 1 to 1,000. Default 100. Text or a number.
max_charge_usd	string	no	Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event	Free plan	Bronze	Silver	Gold
video-row, one post read	$0.0004	$0.00038	$0.00036	$0.00034
missing-post, one post TikTok reports as deleted, private, or missing	$0.0004	$0.00038	$0.00036	$0.00034
apify-actor-start, per run start	$0.006	$0.006	$0.006	$0.006

TikTok bot check pages, values that are not TikTok posts, and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/tiktok-video-stats

License

MIT. See LICENSE.