# SubtitlePop MCP — SRT & WebVTT Tools

> SubtitlePop MCP — SRT & WebVTT Tools is an open-source MCP server for design and media. Checks subtitle timing and converts or shifts SRT and WebVTT files in an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://subtitlepop.com
- **Repository:** https://github.com/j-river/subtitlepop-mcp
- **MCP Registry name:** io.github.j-river/subtitlepop
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Subtitle problems are often timing problems: overlaps, long lines and captions that flash by too fast to read. This local server inspects subtitle text and reports them cue by cue, so an agent can explain what is wrong before touching anything.

The README's synthetic example has three cues and three warnings, including a 61-character caption shown for 600 ms, about 101.7 characters per second. Moving the whole track later does not fix an overlap or lengthen display time, which is why inspection comes first. Other tools convert between SRT and VTT with loss warnings, shift timestamps by a millisecond offset and report which cues were clipped or dropped, and extract a plain transcript.

It works on text you give it over stdio, opens no paths, fetches no URLs and calls no backend. It needs Node.js 22 or newer and is the open-source companion to SubtitlePop's caption generator.

## Features

- **Timing inspection:** Reports overlaps, long lines and fast-reading cues.
- **SRT and VTT conversion:** Converts either way and warns about losses.
- **Timestamp shifting:** Offsets by milliseconds and lists clipped or dropped cues.
- **Transcript extraction:** Plain text in cue order.
- **Text-only processing:** No file access, network or accounts.

## Good for

- Audit captions before publishing a video
- Convert an SRT to WebVTT for a web player
- Re-sync a subtitle track that runs late
- Pull a clean transcript out of a caption file

## Install

### Claude Code (Terminal)

```sh
claude mcp add subtitlepop -- npx -y subtitlepop-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "subtitlepop": {
      "command": "npx",
      "args": [
        "-y",
        "subtitlepop-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "subtitlepop": {
      "command": "npx",
      "args": [
        "-y",
        "subtitlepop-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "subtitlepop": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "subtitlepop-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "subtitlepop": {
      "command": "npx",
      "args": [
        "-y",
        "subtitlepop-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "subtitlepop": {
      "command": "npx",
      "args": [
        "-y",
        "subtitlepop-mcp"
      ]
    }
  }
}
```

## Tools

- `inspect_subtitles`: Report issues, summary and per-cue metrics
- `convert_subtitles`: Convert between SRT and VTT with loss warnings
- `shift_subtitles`: Shift timestamps by a millisecond offset
- `extract_transcript`: Return plain text in cue order

## FAQ

### Does it generate subtitles from audio?

No. It processes existing subtitle text; generation is done by the SubtitlePop web app.

### Does it need an account or key?

No account, API key, model or credits are needed.

### Can it read files from disk?

No. It does not grant filesystem access; pass the text or let your client read the file.

### Is SubtitlePop MCP — SRT & WebVTT Tools free?

Yes. SubtitlePop MCP — SRT & WebVTT Tools is open source, so you can use and self-host it for free.

### How do I add SubtitlePop MCP — SRT & WebVTT Tools to Claude Code?

Run this command in your terminal: claude mcp add subtitlepop -- npx -y subtitlepop-mcp

### What are the best alternatives to SubtitlePop MCP — SRT & WebVTT Tools?

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

## 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.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt 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.
- [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/subtitlepop-mcp-srt-and-webvtt-tools
