Submagic MCP Server

mcp-name: io.github.sidart10/submagic-mcp-server

Connect your AI assistant to Submagic's powerful video editing API. Create viral short-form content, add AI captions in 107 languages, and automate your video production workflow directly from Claude or any MCP-compliant client.

Table of Contents

• Features

• Getting Started

  • Prerequisites

  • Installation

  • Configuration

• Usage Examples

  • Create Video with AI Captions

  • Generate TikTok Clips from YouTube

  • Export for Social Media

• Available Tools

• Limitations

• Contributing

• License

Features

• Global Reach: Automatic AI captions with 98%+ accuracy in 107 languages.

• Dynamic Editing: Magic zooms and auto-inserted B-rolls with configurable coverage.

• Smart Cleanup: Automated silence removal (3 speeds) and filler word removal ("um", "uh").

• Content Repurposing: Convert YouTube videos into viral short-form clips (TikTok, Reels, Shorts).

• Professional Styling: Access 30+ trending templates (Hormozi, Beast, Sara).

• Optimized Exports: Ready-to-post formats for all major platforms (9:16, 1:1, 16:9, 4:5).

Getting Started

Prerequisites

• Python 3.10 or higher

• A Submagic API Key (Get one at Submagic.co)

Installation

Option 1: Install via PyPI (Recommended)

pip install submagic-mcp-server

Option 2: Install from Source

git clone https://github.com/sidart10/submagic-mcp-server.git
cd submagic-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Configuration

1. Get your API Key: Sign up at submagic.co to retrieve your API key.

2. Configure Claude Desktop: Add the server definition to your claude_desktop_config.json file.

   If installed via PyPI:

   {
     "mcpServers": {
       "submagic": {
         "command": "python",
         "args": ["-m", "submagic_mcp"],
         "env": {
           "SUBMAGIC_API_KEY": "sk-your-api-key-here"
         }
       }
     }
   }

   If installed from source (use absolute paths):

   {
     "mcpServers": {
       "submagic": {
         "command": "/absolute/path/to/venv/bin/python",
         "args": ["/absolute/path/to/submagic_mcp.py"],
         "env": {
           "SUBMAGIC_API_KEY": "sk-your-api-key-here"
         }
       }
     }
   }

3. Restart Claude Desktop: Relaunch the application to load the new server.

Usage Examples

Here are common workflows you can automate:

Create Video with AI Captions

Upload a raw video and apply professional styling with captions.

submagic_create_project(
    title="Product Demo Launch",
    language="en",
    video_url="https://example.com/raw-video.mp4",
    template_name="Hormozi 2",
    remove_silence_pace="fast",
    magic_zooms=True
)

Generate TikTok Clips from YouTube

Turn a long-form YouTube video into multiple engaging shorts.

submagic_create_magic_clips(
    title="Podcast Highlights",
    youtube_url="https://youtube.com/watch?v=your-video-id",
    language="en",
    min_clip_length=30,
    max_clip_length=60
)

Export for Social Media

Finalize and export your project in the perfect format for Instagram Reels.

submagic_export_project(
    project_id="your-project-uuid",
    width=1080,
    height=1920,
    fps=30
)

Available Tools

Limitations

• Input: Videos must be publicly accessible URLs.

• Size: Maximum file size is 2GB.

• Duration: Maximum video duration is 2 hours.

• Formats: Supports MP4 and MOV.

• Performance: remove_bad_takes adds 1-2 minutes to processing time.

• API Coverage: Some dashboard features are not yet available via API. See docs/API_LIMITATIONS_DISCOVERED.md for details.

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository.

2. Create a feature branch: git checkout -b feature/new-tool.

3. Install development dependencies: pip install -r requirements.txt.

4. Run tests to ensure everything works: python -m pytest tests/.

5. Submit a Pull Request describing your changes.

See docs/development-guide.md for more detailed instructions.

License

MIT License. See LICENSE for details.

Resources

• Submagic API Documentation

• Model Context Protocol (MCP)