ZapCap MCP Server

PyPI version MCP Server

NOTE: This is an unofficial implementation of MCP Server for ZapCap.

An MCP (Model Context Protocol) server that provides tools for uploading videos, creating processing tasks, and monitoring their progress through the ZapCap API.

Requirements

  • uv
  • ZapCap API key

You can install uv from here: https://docs.astral.sh/uv/

You can get api key from ZapCap API after registation at https://zapcap.ai/ in their platform here: https://platform.zapcap.ai/dashboard/api-key

Installation in MCP-client

Add to your MCP client mcp.json configuration (e.g., Claude Desktop, Cursor and etc.):

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

Alternative Installation 

uv tool install zapcap-mcp-server

Configuration

Set your ZapCap API key as an environment variable:

export ZAPCAP_API_KEY="your_api_key_here"

Usage

Demo Videos

How to use:

Results:

Available Tools

The server provides the following tools:

zapcap_mcp_upload_video

Upload a video file to ZapCap.

Parameters:

  • file_path: Path to the video file

zapcap_mcp_upload_video_by_url

Upload a video by URL to ZapCap.

Parameters:

  • url: URL to the video file

zapcap_mcp_get_templates

Get available processing templates from ZapCap.

zapcap_mcp_create_task

Create a video processing task with full customization options.

Parameters:

  • video_id: Video ID from upload
  • template_id: Template ID
  • auto_approve: Auto approve the task (default: true)
  • language: Language code (default: “en”)
  • enable_broll: Enable B-roll (default: false)
  • broll_percent: B-roll percentage 0-100 (default: 30)

Subtitle options:

  • emoji: Enable emoji in subtitles (default: true)
  • emoji_animation: Enable emoji animation (default: true)
  • emphasize_keywords: Emphasize keywords (default: true)
  • animation: Enable subtitle animation (default: true)
  • punctuation: Include punctuation (default: true)
  • display_words: Number of words to display (default: 1)

Style options:

  • position_top: Subtitle position from top (default: 60)
  • font_uppercase: Use uppercase font (default: true)
  • font_size: Font size (default: 30)
  • font_weight: Font weight (default: 900)
  • font_color: Font color (default: “#ffffff”)
  • font_shadow: Font shadow s/m/l (default: “l”)
  • stroke: Stroke style (default: “s”)
  • stroke_color: Stroke color (default: “#000000”)
  • highlight_color_1: First highlight color (default: “#2bf82a”)
  • highlight_color_2: Second highlight color (default: “#fdfa14”)
  • highlight_color_3: Third highlight color (default: “#f01916”)

zapcap_mcp_monitor_task

Monitor task progress.

Parameters:

  • video_id: Video ID
  • task_id: Task ID

License

MIT licence