Upload captions
Add a caption or subtitle track to a video from WebVTT or SRT text.
MCP tool vimeo_write → upload_captions
write Confirm
Uploads the file as a text track with the language and type you set, then switches it on. WebVTT must start with WEBVTT and SRT with the first cue number; both must be UTF-8. A file in another format is refused with the reason. Viewers see the track at once. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| video_id string required | string | Video ID from search_videos, the number in vimeo.com/{id}. |
| language string required | string | Language code, for example 'en' or 'es'. |
| type enum required | enum | caption or subtitle. |
| content string required | string | The full WebVTT or SRT text. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vimeo_write",
"arguments": {
"operation": "upload_captions",
"arguments": {
"video_id": "912345601",
"language": "en",
"type": "caption",
"content": "WEBVTT\n\n00:00:00.000 --> 00:00:03.500\nWelcome to the onboarding series.\n"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"video_id": "912345601",
"language": "en",
"type": "caption",
"format": "webvtt",
"active": true
},
"isError": false
}