reel25-mcp
v1.0.5
Published
MCP server for Reel25 — video analytics API for TikTok, Instagram, and YouTube
Maintainers
Readme
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-mcpSet 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 claudeAvailable 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) |
