reel25-mcp

Reel25 MCP Server

MCP (Model Context Protocol) server for Reel25 — video analytics API for TikTok, Instagram, and YouTube.

Lets AI agents (Claude, Cursor, VS Code Copilot, Windsurf) interact with your Reel25 workspace: track videos, search for content, run AI analysis, manage folders, and monitor performance.

Quick Setup

1. Get your API key

Go to Settings → API Keys and create a new key.

2. Configure your AI client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "reel25": {
      "command": "npx",
      "args": ["-y", "reel25-mcp"],
      "env": {
        "REEL25_API_KEY": "reel25_sk_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add reel25 -- npx -y reel25-mcp

Set the env var: REEL25_API_KEY=reel25_sk_your_key_here

Cursor

Settings → MCP → Add Server:

• Command: npx -y reel25-mcp
• Env: REEL25_API_KEY=reel25_sk_your_key_here

Or add to .cursor/mcp.json:

{
  "mcpServers": {
    "reel25": {
      "command": "npx",
      "args": ["-y", "reel25-mcp"],
      "env": {
        "REEL25_API_KEY": "reel25_sk_your_key_here"
      }
    }
  }
}

VS Code

Add to User Settings (JSON) or .vscode/mcp.json:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "reel25ApiKey",
        "description": "Reel25 API Key",
        "password": true
      }
    ],
    "servers": {
      "reel25": {
        "command": "npx",
        "args": ["-y", "reel25-mcp"],
        "env": {
          "REEL25_API_KEY": "${input:reel25ApiKey}"
        }
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "reel25": {
      "command": "npx",
      "args": ["-y", "reel25-mcp"],
      "env": {
        "REEL25_API_KEY": "reel25_sk_your_key_here"
      }
    }
  }
}

Smithery

npx -y @smithery/cli install reel25-mcp --client claude

Available Tools (26)

Videos (Free)

Tool	Description
list_videos	List all tracked videos. Supports pagination, filtering by platform, date range, and folder
get_video	Get full video details: current metrics, music info, metadata
get_video_history	Historical performance snapshots over time
track_video	Start tracking a video by TikTok, Reels, or Shorts URL
bulk_track_videos	Track up to 25 videos in a single call
untrack_video	Stop tracking a video and remove it from your workspace

Accounts (Free)

Tool	Description
list_accounts	List all tracked creator accounts with latest metrics
get_account	Detailed profile info — bio, follower count, total videos, engagement rate
track_account	Start tracking a creator account by URL across TikTok, Instagram, and YouTube
get_account_videos	List all tracked videos belonging to a specific creator
get_account_metrics	Detailed performance metrics — follower growth, avg engagement, posting frequency
remove_account	Stop tracking a creator account

Content Radar (100 credits)

Tool	Description
search_content	AI-powered content discovery (handles async polling internally, 30-60s)
get_radar_results	Retrieve results from a previous search by ID
radar_history	List all past searches with status and result counts

AI Video Analysis (5 credits)

Tool	Description
analyze_video	Full AI analysis: hooks, structure, CTA, UGC, demographics (handles async polling, 15-30s)
get_analysis	Retrieve an existing analysis for a previously analyzed video

Folders (Free)

Tool	Description
list_folders	List all folders in your workspace
create_folder	Create a new folder
add_videos_to_folder	Add tracked videos to a folder
add_accounts_to_folder	Add tracked accounts to a folder
folder_analytics	Aggregated analytics for all content in a folder

Analytics & Workspace (Free)

Tool	Description
top_videos	Top performing tracked videos ranked by views, engagement, or growth velocity
growth_trends	Follower and video count growth trends over time
get_credits	Current credit balance and usage
get_workspace	Workspace info: plan, credit limits, tracked counts, team members

Example Prompts

• "Search for UGC skincare product review videos on TikTok, analyze the top 3 performers, and create a folder with the findings"
• "What are the top performing videos in my workspace this week? Show me growth trends for the last 30 days"
• "Find AI productivity tool demos on YouTube, track the top 10, and tell me what hooks and formats work best"

Environment Variables

Variable	Required	Description
REEL25_API_KEY	Yes	Your Reel25 API key (reel25_sk_...)
REEL25_API_URL	No	Custom API URL (default: https://api.reel25.com/api/v1)

Links

• Reel25 Dashboard
• API Documentation
• Get API Key