API and MCP server

Convert video, audio, images, PDFs, documents, e-books, subtitles, data and archives (67 formats) from your own programs and from AI assistants such as Claude Code, Codex, Cursor and VS Code.

01

Get an API key

Sign in and create a key on your account page. Keys start with cvs_live_; keep them secret. Every conversion uses your account's credits, the same as on the website: free accounts get 13 credits a day, Pro and Premium their monthly credits (pricing). Most files cost 1 credit; video about 1 credit per 3 minutes at 1080p.

Results are kept for 6 hours, then deleted. Uploaded files are deleted as soon as they are converted.

02

MCP server for AI assistants

The server lives at https://converter.studio/api/mcp (Streamable HTTP). Send your key as Authorization: Bearer cvs_live_…. Without a key it only lists the formats. Its tools: list_formats, convert (from a link, an upload or a small file sent inline), create_upload (for local files over 8 MB), get_conversion, confirm_conversion and get_account. A conversion that costs more than maxCredits (default 20) waits for a go-ahead.

Claude Code

claude mcp add --transport http converter-studio https://converter.studio/api/mcp \
  --header "Authorization: Bearer cvs_live_YOUR_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.converter-studio]
url = "https://converter.studio/api/mcp"
bearer_token_env_var = "CONVERTER_STUDIO_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "converter-studio": {
      "url": "https://converter.studio/api/mcp",
      "headers": { "Authorization": "Bearer cvs_live_YOUR_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "inputs": [
    { "type": "promptString", "id": "converter-key", "description": "Converter Studio API key", "password": true }
  ],
  "servers": {
    "converter-studio": {
      "type": "http",
      "url": "https://converter.studio/api/mcp",
      "headers": { "Authorization": "Bearer ${input:converter-key}" }
    }
  }
}

Other MCP clients (Gemini CLI, Windsurf, Zed…) take the same URL with the same header. Signing in from claude.ai and ChatGPT without a key is coming.

03

REST API

Base URL https://converter.studio/api/v1, JSON in and out, the key in Authorization: Bearer (or X-API-Key).

Convert a file from a link

curl -X POST https://converter.studio/api/v1/conversions \
  -H "Authorization: Bearer $CONVERTER_STUDIO_API_KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.heic", "to": "jpg"}'

# then, until "status" is "done" (waits up to 60 seconds per call):
curl "https://converter.studio/api/v1/conversions/ID?wait=60" -H "Authorization: Bearer $CONVERTER_STUDIO_API_KEY"

Links can be direct file links or share links of Google Drive, Dropbox and OneDrive. A finished conversion has a downloadUrl anyone with the link can use until expiresAt.

Convert a file from your computer

# 1. an upload slot (the answer has the upload URL and a ready curl command)
curl -X POST https://converter.studio/api/v1/uploads \
  -H "Authorization: Bearer $CONVERTER_STUDIO_API_KEY" -H "Content-Type: application/json" \
  -d '{"fileName": "talk.mov"}'

# 2. the file itself (no key needed: the URL carries a one-time token)
curl -X PUT -H "Content-Type: application/octet-stream" -T talk.mov "UPLOAD_URL"

# 3. convert it
curl -X POST https://converter.studio/api/v1/conversions \
  -H "Authorization: Bearer $CONVERTER_STUDIO_API_KEY" -H "Content-Type: application/json" \
  -d '{"uploadId": "ID", "to": "mp4", "maxCredits": 30}'

One request carries up to 95 MB. Bigger files go in parts: give size when making the slot and send each part with an Upload-Offset header (its first byte).

Endpoints

GET  /v1/formats[?from=heic]          formats and what they convert to (no key)
GET  /v1/account                       plan, credits left, largest file
POST /v1/uploads                       {fileName, size?}  →  upload slot
PUT  /v1/uploads/{id}?token=…          the file (whole, or a part with Upload-Offset)
POST /v1/conversions                   {to, url | uploadId, options?, maxCredits?}
GET  /v1/conversions/{id}[?wait=60]    status, price, downloadUrl
POST /v1/conversions/{id}/confirm      go ahead with a conversion above maxCredits

maxCredits is the most a conversion may cost to start on its own (default 20; 0 only prices it). Errors come as {"error": {"code", "message", "params"}} with the matching HTTP status.

04

Privacy and help

Files are used only to convert them and are deleted after 6 hours (see the privacy policy). An assistant sees only what you give it and the result link. Questions: [email protected].