Transcription
transcribe_url and transcribe_base64: text, language and timed segments.
Give your agent a link to a recording or video and get back the text with timestamps, an English translation, or an SRT/VTT subtitle file.
The same Whisper Large model that Handy uses, up to two hours per file.
Runs on whisper.cpp on the server; long files are tracked with a job id.
transcribe_url and transcribe_base64: text, language and timed segments.
translate_to_english translates speech directly into English.
subtitles returns a ready SRT or VTT file.
Use the service URL and your key.
“Transcribe this episode in Arabic”
Long files return a job id you track with get_job.
Streamable HTTPhttps://whisper-mcp.marsaplatform.com/mcpBearer YOUR_API_KEYEvery request needs Authorization: Bearer YOUR_API_KEY.
https://whisper-mcp.marsaplatform.com/mcpclaude mcp add --transport http whisper https://whisper-mcp.marsaplatform.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"~/.cursor/mcp.json{
"mcpServers": {
"whisper": {
"url": "https://whisper-mcp.marsaplatform.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}.vscode/mcp.json{
"servers": {
"whisper": {
"type": "http",
"url": "https://whisper-mcp.marsaplatform.com/mcp",
"headers": {
"Authorization": "Bearer ${input:whisper-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "whisper-key",
"description": "Whisper MCP API key",
"password": true
}
]
}VS Code asks for the key once and stores it securely.
claude_desktop_config.json{
"mcpServers": {
"whisper": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://whisper-mcp.marsaplatform.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_API_KEY"
}
}
}
}Claude Desktop reaches remote servers through mcp-remote, which needs Node.js. Restart the app after editing.
curl -s -X POST https://whisper-mcp.marsaplatform.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'With a valid key you get the initialize result. Without a key you get 401.
The original page states: “7 MCP tools”. The full list is generated from tools/list once a read key is configured for this site; until then any MCP client shows it after you connect.
read covers status and jobs only; write adds transcription and translation.
Up to two hours or 200 MB for a link, and 25 MB for an uploaded file.
Request an access key from the key request page (Arabic form).
The real response for a request without a key:
WWW-Authenticate: Bearer
{"error": "unauthorized"}Send the header exactly as Authorization: Bearer YOUR_API_KEY.