MCP HubMCP Hub
Seym0n

tiktok-mcp

by: Seym0n

Model Context Protocol (MCP) with TikTok integration

28created 13/03/2025
Visit
TikTok
Protocol

📌Overview

Purpose: The TikTok MCP aims to seamlessly integrate TikTok access into Claude AI and other applications, enabling advanced video analysis and interaction.

Overview: TikTok MCP allows users to analyze videos for virality factors, retrieve content, and even chat with videos. Through a series of tools, users can access subtitles, detailed post information, and more, enhancing their engagement with TikTok content.

Key Features:

  • tiktok_available_subtitles: This tool looks up available subtitles for a TikTok video, providing content options in various languages and formats. It helps users quickly check accessibility of video subtitles.

  • tiktok_get_subtitle: This feature retrieves the actual subtitle content for a TikTok video, offering customization for language preferences. It ensures users can engage with content in their desired language.

  • tiktok_get_post_details: This tool provides detailed insights into a TikTok post, including descriptions, creator information, engagement metrics, and video duration. It allows for comprehensive analysis of TikTok content.


TikTok MCP

The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron. It allows you to:

  • Analyze TikTok videos to determine virality factors
  • Retrieve content from TikTok videos
  • Chat with TikTok videos

Available Tools

tiktok_available_subtitles

Description:
Looks up the available subtitle (content) for a TikTok video. Returns available subtitles in various languages and formats such as Automatic Speech Recognition, Machine Translation, or Creator Captions.

Input Parameters:

  • tiktok_url (required): TikTok video URL (e.g., https://www.tiktok.com/@username/video/1234567890).

tiktok_get_subtitle

Description:
Retrieves the subtitle (content) for a TikTok video. If no language code is provided, the tool will return the subtitle of automatic speech recognition.

Input Parameters:

  • tiktok_url (required): TikTok video URL (e.g., https://www.tiktok.com/@username/video/1234567890).
  • language_code (optional): Language code for the subtitle (e.g., en for English).

tiktok_get_post_details

Description:
Returns the details of a TikTok post, including:

  • Description
  • Creator username
  • Hashtags
  • Engagement metrics (likes, shares, comments, views, bookmarks)
  • Date of creation
  • Video duration

Input Parameters:

  • tiktok_url (required): TikTok video URL (e.g., https://www.tiktok.com/@username/video/1234567890).

Requirements

To use the TikTok MCP, you need:

  • NodeJS v18 or higher
  • Git
  • TikNeuron Account and MCP API Key

Setup

  1. Clone the repository:

    git clone https://github.com/Seym0n/tiktok-mcp.git
    
  2. Install dependencies:

    npm install
    
  3. Build the project:

    npm run build
    

    This creates the file build/index.js.

Using in Claude AI

Add the following entry to mcpServers:

"tiktok-mcp": {
    "command": "node",
    "args": [
      "path/build/index.js"
    ],
    "env": {
      "TIKNEURON_MCP_API_KEY": "YOUR_API_KEY_HERE"
    }
}

Replace path with the path to TikTok MCP and YOUR_API_KEY_HERE with your TikNeuron API Key. The updated mcpServers section will look like this:

{
  "mcpServers": {
    "tiktok-mcp": {
      "command": "node",
      "args": [
        "path/build/index.js"
      ],
      "env": {
        "TIKNEURON_MCP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}