Skip to main content
Glama
TikTok Video Stats MCP Server

TikTok Video Stats MCP Server

TikTok Video Stats MCP Server

npm version license

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

What's Inside

Related MCP server: tiktok-downloader-mcp

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

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.

Available Tools

1 tool
get_tiktok_video_statsGet TikTok video statsA
Read-onlyIdempotent

Read public stats for TikTok video or photo posts by URL or post ID. Returns one flat row per post with plays, likes, comments, shares, saves, caption, hashtags, post date, sound, and the author's follower and like totals. Costs 0.0004 USD per post read, 0.0004 USD per post TikTok reports as deleted, private, or missing, plus 0.006 USD per run start. Bot check pages are free rows.

Inputs: videos, max_videos, max_charge_usd.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusing it with another. Its purpose—reading public TikTok video or photo post stats by URL or post ID—is clearly stated.

    Naming Consistency5/5

    The single tool follows a clear snake_case verb_noun pattern: get_tiktok_video_stats. There are no competing conventions to create inconsistency.

    Tool Count3/5

    A single tool is defensible for a narrowly scoped stats-reader, but the surface feels thin because it only supports one operation. Users needing batch reads, profile data, or video discovery have no adjacent tools.

    Completeness3/5

    The tool covers reading stats for known posts and returns rich fields, but the surface lacks obvious companion operations such as listing a user's posts, resolving URLs to IDs, or batch retrieval. It is usable for its exact purpose but limited as an overall TikTok stats API.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables downloading TikTok videos and photos without watermarks, extracting metadata and analytics, and performing bulk downloads of user profiles via CLI or as an MCP server for AI assistants.
      5
      12 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to access public TikTok profiles, videos, comments, and keyword search as structured JSON over streamable HTTP, without a TikTok developer account or OAuth.
      4
      77 npm
      19 PyPI
      11
      MIT