# Subtitle Overlap Fix — MCP tool `findutils:subtitle_overlap_fix`

Fix overlapping cues in a SubRip (.srt) or WebVTT (.vtt) caption file, the kind a merge, shift or frame-rate change leaves behind and that makes players skip or flash lines. Cues are sorted by start time, then every cue that starts before the previous one ends is moved to start exactly when the previous one ends; if that leaves it shorter than min_duration_ms (default 300), its end is extended to reach that length. Cue text is never changed and no cue is dropped. Returns the fixed file, counts, and the first adjustments so the change can be checked.

- Category: media
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/subtitle-overlap-fix/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/subtitle-overlap-fix/
- Same tool on the other surface: https://findutils.com/api/subtitle-overlap-fix/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "subtitle_overlap_fix",
      "arguments": {
        "input": "1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `input` | string | yes | Caption file contents, either SubRip or WebVTT. |
| `min_duration_ms` | integer | no | The shortest a moved cue may last, in milliseconds. Default 300, between 100 and 1000. Default: `300`. |
| `sort` | boolean | no | Sort cues by start time before fixing. Default: true. Default: `true`. |

Example arguments (verified):

```json
{
  "input": "1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/subtitle-overlap-fix/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/subtitle-overlap-fix
```

Full REST reference: https://findutils.com/api/subtitle-overlap-fix/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt