check_balance
Check your Scriptivox API credit balance, available hours, and pricing. Requires a configured API key.
LABSCO SUMMARY
You can price the work and confirm the language is covered before the account exists.
The split is unusual and useful: the catalogue tools answer keyless, and only submission, status, export and balance need SCRIPTIVOX_API_KEY. The lifecycle is worked out rather than assumed — transcribe_cancel releases reserved balance and is idempotent, transcribe_delete returns 409 CONFLICT while a job is still in flight so you cancel first, and export_transcript requires the job to be in completed status. The aliases transcription_url and transcription_status are kept for @scriptivox/mcp-server@1.0.x and are marked for removal in 2.0.0, so a new integration should not build on them.
What it is
A client for the Scriptivox transcription API, covering job submission, job lifecycle, export, and the account questions that come before either.
What you get
- Transcription of a public URL, or of a local file up to 5 GB driven through the upload flow internally, across the 119 supported languages
- Per-job options: explicit language, speaker count, diarization, alignment, an idempotency key and a webhook URL
- Job control — status polling for long runs, cancellation that releases the reserved balance, and soft delete of the record
- A cursor-paginated list of past transcriptions filtered by status or date range, with the transcript body left out
- Export as SRT subtitles, WebVTT or plain text, with segmentation controlled by max_words, max_chars, max_duration, sentence_aware, include_speakers and strip_chars
- Credit balance and available hours, plus supported languages, plans and API documentation
Requirements
A Scriptivox account and its key in SCRIPTIVOX_API_KEY for anything that touches a job. get_supported_languages, get_pricing, get_product_info and get_api_docs answer without one, so the language list and the rates can be read before signing up.
Setup effort
One command — npx -y @scriptivox/mcp-server
USE CASES
01
Getting subtitles onto a video that is already published
Submit the public URL with the language set explicitly, poll until the job reports completed, then export SRT or WebVTT with the segmentation the player expects.
02
Transcribing a recording that is not on a public URL
Hand it the local path and let it drive the upload flow internally, up to the 5 GB file ceiling, with the same diarization and language options as a URL job.
03
Checking the language is covered and the credit will stretch
Read the supported language list and the plan rates without a key, then check the balance and available hours on the configured account before committing a long file.
04
Clearing out a batch of jobs that ran overnight
List what is there filtered by status or date, cancel anything still in flight to release its reserved balance, and soft-delete the records you no longer need.
14 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
export_transcript
Export a completed Scriptivox transcript as SRT subtitles, WebVTT subtitles, or plain text. Supports segmentation knobs (max_words, max_chars, max_duration, sentence_aware, include_speakers, strip_chars). Requires the transcription to be in completed status. Requires a configured API key.
get_api_docs
Get Scriptivox API documentation. Sections: quickstart, transcribe, result, list, cancel, delete, upload, balance, webhooks, errors. No API key required.
get_pricing
Get Scriptivox pricing information including subscription plans (Free, Pro, Team) and API pay-as-you-go rates. Includes signup URLs. No API key required.
get_product_info
Get information about Scriptivox capabilities: transcription, audio tools, video tools, subtitle tools, meeting bot, or API. No API key required.
get_supported_languages
List all languages supported by Scriptivox for audio/video transcription. Returns language names and ISO codes. No API key required.
list_transcriptions
List recent transcriptions for the configured API key, with optional status/date filters and cursor pagination. The full transcript body is omitted — fetch transcribe_status per id to read it. Requires a configured API key.
transcribe_cancel
Cancel an in-flight Scriptivox transcription and release any reserved balance. Idempotent. Returns 409 CONFLICT on already-terminal jobs. Requires a configured API key.
transcribe_delete
Soft-delete a Scriptivox transcription record. Idempotent. Returns 409 CONFLICT if the job is still in-flight — cancel first via transcribe_cancel. Requires a configured API key.
transcribe_status
Check the status of a Scriptivox transcription job. Use this for long-running transcriptions, after a timeout, or to verify completion. Requires a configured API key.
transcribe_upload
Transcribe a LOCAL file by uploading it to Scriptivox. Drives the 3-step upload flow internally. Same options as transcribe_url. Use when the file isn't on a public URL. Max file size 5 GB. Requires a configured API key.
transcribe_url
Transcribe audio or video from a public URL using Scriptivox AI. Supports 119 languages, speaker diarization, and word-level timestamps. RECOMMENDED: always pass the language parameter explicitly when you know the audio language — auto-detect has a small failure rate on short clips, code-switched audio, or files starting with music. Requires a configured API key.
transcription_status
[DEPRECATED — use transcribe_status instead] Alias kept for backward compatibility with @scriptivox/mcp-server@1.0.x. Will be removed in 2.0.0. Identical behavior to transcribe_status.
transcription_url
[DEPRECATED — use transcribe_url instead] Alias kept for backward compatibility with @scriptivox/mcp-server@1.0.x. Will be removed in 2.0.0. Identical behavior to transcribe_url.
BEFORE YOU INSTALL
What to know first
Tools you get
14 tools when we connected. transcription_status and transcription_url look like alternate names for transcribe_status and transcribe_url; use the transcribe_ forms. The four discovery tools work without an API key; transcribing needs a key and account credit.
Requires
npx on PATH
Optional
SCRIPTIVOX_API_KEY in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 14 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y @scriptivox/mcp-serverHosted endpoint
ENDPOINT URL
https://platform.scriptivox.com/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"scriptivox": {
"command": "npx",
"args": [
"-y",
"@scriptivox/mcp-server"
],
"env": {
"SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
}
}
}
}Claude Code
claude mcp add scriptivox -- npx -y @scriptivox/mcp-server, then set SCRIPTIVOX_API_KEY=<YOUR_SCRIPTIVOX_API_KEY> in the environment
