MCP server providing tools for uploading videos, creating processing tasks, and monitoring their progress through the ZapCap API for automated subtitle and B-roll generation.

Installation

UV Tool

uv tool install zapcap-mcp-server

Docker Hub

docker run --rm --init -i --net=host -v "/home/$USER:/host/home/$USER" -e "ZAPCAP_API_KEY=your_api_key_here" bogdan01m/zapcap-mcp-server:latest

Configuration

MCP Client (uvx)

{
  "mcpServers": {
    "zapcap": {
      "command": "uvx",
      "args": ["zapcap-mcp-server"],
      "env": {
        "ZAPCAP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker Configuration

{
  "mcpServers": {
    "zapcap": {
      "command": "docker",
      "args": [
        "run", 
        "--rm", 
        "--init",
        "-i",
        "--net=host",
        "-v", "/home/$USER:/host/home/$USER",
        "-e", "ZAPCAP_API_KEY=your_api_key_here",
        "bogdan01m/zapcap-mcp-server:latest"
      ],
      "env": {
        "DOCKER_CLI_HINTS": "false"
      }
    }
  }
}

Available Tools

Tool	Description
zapcap_mcp_upload_video	Upload a video file to ZapCap
zapcap_mcp_upload_video_by_url	Upload a video by URL to ZapCap
zapcap_mcp_get_templates	Get available processing templates from ZapCap
zapcap_mcp_create_task	Create a video processing task with full subtitle, styling, and B-roll customization capabilities
zapcap_mcp_monitor_task	Track video processing task progress

Features

• Video upload by file path or URL
• Video processing task creation with full customization
• Subtitle options including emojis, animations, and keyword highlighting
• Style customization for fonts, colors, shadows, and positioning
• B-roll generation with configurable percentage
• Task progress monitoring
• Template-based processing
• Natural language interface instead of complex API calls
• Automatic token management
• Type safety and validation with Pydantic integration

Environment Variables

Required

• ZAPCAP_API_KEY - API key for authentication on the ZapCap platform

Usage Examples

Add green highlighted subtitles with 40% B-roll using viral template

Notes

This is an unofficial MCP Server implementation for ZapCap. Requires a ZapCap API key from https://platform.zapcap.ai/dashboard/api-key. Provides advantages over direct API usage, including token management, natural language interface, and type-safe validation.