# Subtitle Shift — REST API endpoint `subtitle-shift`

Shift every cue in a SubRip (.srt) or WebVTT (.vtt) caption file by one fixed offset, so a track that runs early or late lines up with the audio again. A positive offset delays the captions (they appear later); a negative one advances them. The output keeps the input format, cue text, order and WebVTT cue settings. A cue whose start would go below zero is held at zero and counted; a cue that would end before zero is dropped and counted. Timing only: nothing is stretched, translated or edited.

- 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-shift/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/subtitle-shift/
- Same tool on the other surface: https://findutils.com/mcp/subtitle-shift/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/subtitle-shift/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "1\n00:00:10,000 --> 00:00:12,000\nTen seconds in.\n",
    "offset_ms": 1500
  }'

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

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `input` | string | yes | Caption file contents, either SubRip or WebVTT. |
| `offset_ms` | integer | yes | Milliseconds to add to every timestamp. Positive shows captions later, negative earlier. 1500 means one and a half seconds later. |

Example arguments (verified):

```json
{
  "input": "1\n00:00:10,000 --> 00:00:12,000\nTen seconds in.\n",
  "offset_ms": 1500
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

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

Then ask the client to call `findutils:subtitle_shift`. Full MCP reference: https://findutils.com/mcp/subtitle-shift/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt
