viral.app

Connect your AI tools to live TikTok analytics with viral.app's MCP server. This bridge lets your AI assistants query profiles, analyze video performance, retrieve transcripts, and list recent videos from TikTok—delivering instant insights inside Cursor, Claude Desktop, Raycast, and more.

How to use

You will connect your MCP client to viral.app and authenticate using OAuth. Once set up, you can ask your AI to look up profiles, fetch video details, and list a profile’s recent posts. Use natural language prompts to request profile stats, video metrics, or transcripts, and let the MCP server translate those requests into TikTok analytics data for you.

How to install

Prerequisites: Node.js must be installed on your machine. Ensure you have a modern Node.js runtime available in your environment.

1. Create a free account on viral.app to obtain MCP access and enable OAuth authentication.

2. Add the viral.app MCP server to your preferred MCP client using the following configuration.

{
  "mcpServers": {
    "viral_app": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://viral.app/api/mcp"]
    }
  }
}

3. Authenticate in your MCP client when prompted. Complete the OAuth flow to grant access to TikTok analytics.

Configuration and usage notes

The MCP server exposes several tools you can invoke via your MCP client. You can retrieve profile data, analyze individual videos, and list recent videos from a profile. Use your client’s standard workflow to call these endpoints, and the server will return structured analytics data and metadata.

Authentication is OAuth-based. After you add the viral.app MCP server, you will be prompted to sign in and authorize the connection. This grants your AI tools access to the TikTok analytics data via the MCP server.

Daily credits and limits

Your usage is governed by a daily credit system to balance demand and access. Free, Pro, Ultra, and Enterprise plans determine how many tool calls you can make each day. Start analyzing TikTok data immediately within your plan’s limits.

Troubleshooting

Authentication issues: If you encounter problems authenticating, retry the OAuth flow and ensure your account permissions are correctly granted.

Node.js not detected: The MCP server requires Node.js. Install it on macOS with brew install node or download from nodejs.org, or install via the appropriate method for Windows.

If you run into issues with cached credentials, you can clear the MCP client cache and re-authenticate.

Notes

The viral.app MCP server connects to TikTok analytics through a remote endpoint, enabling real-time data access inside your AI tools. Use the provided MCP configuration to add the server to your environment and begin querying TikTok profiles, videos, and transcripts.

Available tools

get-tiktok-profile

Fetches comprehensive TikTok profile data including follower counts, engagement metrics, and profile metadata.

get-tiktok-video

Analyzes a TikTok video URL to return video metadata, performance metrics, author details, and optional transcripts.

list-profile-videos

Retrieves up to 30 recent videos from a TikTok profile with detailed performance metrics.