# Submagic

> Submagic is a paid MCP server for design and media. MCP server that lets AI assistants caption videos, cut YouTube clips and publish to social. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web, Chrome extension
- **Website:** https://docs.submagic.co/mcp-server
- **MCP Registry name:** co.submagic/submagic
- **Categories:** design and media
- **Listing updated:** 2026-11-18

## About

The Submagic MCP server connects assistants such as Claude, ChatGPT and Cursor to a Submagic account, so captioning and short-form video work can be requested in a chat. Videos can be uploaded through a link the assistant provides, shared as a direct file or Drive/Dropbox link, or turned into several clips from a YouTube URL. The server also covers the Iris editing assistant, where changes are sent in plain language and each one saves a new version.

Beyond creating videos, the server can list caption styles, languages, brand kits and saved presets, check project status and transcripts, and post exported videos to connected YouTube, TikTok, Instagram, X, Facebook and LinkedIn accounts. Publishing happens only when a user asks for it. Usage is charged in Submagic credits, and the account balance can be checked from the assistant.

The server suits creators and marketing teams who already work in an AI assistant and produce many short videos. Setup uses a sign-in page or an API key in the client configuration.

## Features

- **Video captioning:** Adds styled captions to uploaded videos or videos shared as links, with chosen language and options.
- **YouTube to clips:** Turns a YouTube video into several short clips through Magic Clips.
- **Iris editing:** Sends editing requests in plain language to the Iris assistant, saving each change as a new version.
- **Project management:** Lists projects, checks their status and retrieves transcripts and download links.
- **Social publishing:** Schedules or posts exported videos to connected social accounts on request.
- **Performance stats:** Reports views, engagement and follower figures for published posts over a chosen period.
- **Brand kit and presets:** Reads brand colours, fonts and logos and applies saved presets to new projects.

## Good for

- Caption a video uploaded from a laptop inside an AI chat
- Turn a long YouTube interview into short clips for social platforms
- Schedule a finished clip to TikTok and Instagram at a set time
- Review how recent published videos performed over the last 30 days
- Adjust caption position or hook titles on an existing project and re-export it

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http submagic https://api.submagic.co/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.submagic.co/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "submagic": {
      "url": "https://api.submagic.co/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "submagic": {
      "type": "http",
      "url": "https://api.submagic.co/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "submagic": {
      "serverUrl": "https://api.submagic.co/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "submagic": {
      "type": "http",
      "url": "https://api.submagic.co/mcp"
    }
  }
}
```

## Tools

- `list_languages`: The languages Submagic can transcribe, with their codes.
- `list_templates`: The caption styles you can use.
- `list_hook_title_templates`: The styles for a hook title at the start of a video.
- `get_account`: Your plan and how many credits you have left.
- `create_upload_link`: Gives you a link to choose a video from your own device and send it to Submagic.
- `wait_for_upload`: Waits for an uploaded video, then captions it with the chosen options.
- `create_project_from_url`: Captions a video shared as a link with the chosen style, language and options.
- `create_magic_clips`: Turns a YouTube video into several short clips.
- `wait_for_project`: Waits for a project to finish.
- `export_project`: Renders a project again after a change.
- `update_project`: Changes an existing project such as hook title, music, B-roll or caption position.
- `list_iris_templates`: Iris styles available to pick, with preview clips.
- `start_iris_edit`: Has Iris edit a video from a link in the chosen style.
- `ask_iris`: Sends Iris one change in plain words, saving a new version.
- `wait_for_iris`: Waits for Iris's answer when it takes longer.
- `list_projects`: Your projects, newest first, with their status.
- `get_project`: One project in full, with status, download links and clips.
- `get_transcript`: A project's transcript, with times.
- `list_user_media`: Your media library.
- `create_user_media_from_url`: Adds a file from a link to your media library.
- `get_brand_kit`: Your brand kit with colours, font families and logo links.
- `list_presets`: Your saved presets.
- `get_preset`: One saved preset.
- `update_preset`: Changes a preset's settings for future projects.
- `publish_project`: Posts an exported video to connected social accounts, now or at a chosen time.
- `list_published_projects`: Your published posts with views and engagement.
- `get_publication`: Details for one published post.
- `get_publishing_stats`: Views, engagement and followers over a period, compared with the previous one.
- `get_profile_stats`: Profile stats over a period for all accounts or one brand.

## FAQ

### Which AI clients can connect to the Submagic MCP server?

The documentation names Claude, ChatGPT, Cursor, VS Code, Windsurf and Claude Code, and says any MCP client can be used.

### What is the maximum video length?

A video can be up to 10 minutes long when credits pay for it. Plan limits otherwise apply, with 30 minutes as the default.

### Do YouTube links work for captioning?

No. YouTube videos are sent to Magic Clips to create short clips instead of captions.

### Does the server work without credits?

Reading, editing, exporting and publishing still work with no credits left. Creating a new video needs credits.

### Is Submagic free?

No. Submagic is a paid product.

### How do I add Submagic to Claude Code?

Run this command in your terminal: claude mcp add --transport http submagic https://api.submagic.co/mcp

### What are the best alternatives to Submagic?

The closest alternatives to Submagic are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, VfxSmith and ChartAnt.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/submagic
