@scriptivox/mcp-server
You can use this MCP server to transcribe audio/video, manage transcription jobs, and access Scriptivox API information.
Discover supported languages (119), pricing, product features, and API docs without an API key.
Transcribe audio/video from public URLs or local files (up to 5 GB) with options for language, diarization, speaker count, word-level timestamps, webhooks, idempotency, and async polling.
Check transcription status, cancel in-flight jobs, soft-delete records, and list recent transcriptions with status/date filters and pagination.
Export completed transcripts as SRT, WebVTT, or plain text with segmentation controls (max words, chars, duration, sentence awareness, speaker tags, strip chars).
Check API credit balance and estimated hours.
Read MCP resources for pricing, languages, and API docs.
Use built-in prompts for URL transcription and meeting notes.
Use deprecated aliases transcription_url and transcription_status for backward compatibility.
Allows transcription of audio and video files hosted on Dropbox by providing a public URL.
Allows transcription of audio and video files hosted on Google Drive by providing a public URL.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@scriptivox/mcp-server Transcribe this meeting recording with speaker identification: https://example.com/meeting.mp3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
This local package is retired (12 October 2026). Use the hosted Scriptivox MCP server instead: add
https://platform.scriptivox.com/mcp to your AI app and sign in. It has every tool (this package lacks 23 of them),
nothing to install, and for files on your computer its upload_link tool returns a one-time upload command.
Setup: https://platform.scriptivox.com/docs/mcp. Clients that only run local servers can bridge with
npx mcp-remote https://platform.scriptivox.com/mcp. Existing installs keep working with an API key, but get no new tools.
@scriptivox/mcp-server
MCP (Model Context Protocol) server for Scriptivox — AI-powered audio and video transcription.
Turn any AI assistant into a transcription powerhouse. Transcribe audio and video from URLs or local files with 99% accuracy, speaker diarization, 119 languages, and word-level timestamps. Plus full CRUD on transcriptions (cancel, delete, list) and caption export in SRT / WebVTT / plain text.
Hosted server — no install, no key to copy
Scriptivox also runs this server for you at https://platform.scriptivox.com/mcp. Add the URL and sign in in your browser; the connection shows up as a key on platform.scriptivox.com/keys, where you can disconnect it.
claude mcp add --transport http scriptivox https://platform.scriptivox.com/mcpIn Claude (web/desktop) use Settings → Connectors → Add custom connector; in Codex, codex mcp add scriptivox --url https://platform.scriptivox.com/mcp. Use the local package below when you need transcribe_upload on local files.
Related MCP server: AssemblyAI MCP Server
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"scriptivox": {
"command": "npx",
"args": ["-y", "@scriptivox/mcp-server"],
"env": {
"SCRIPTIVOX_API_KEY": "sk_live_YOUR_KEY"
}
}
}
}Claude Code
claude mcp add scriptivox -- npx -y @scriptivox/mcp-serverThen set the environment variable SCRIPTIVOX_API_KEY=sk_live_YOUR_KEY.
Other MCP Clients
Any MCP-compatible client can use this server via stdio transport:
SCRIPTIVOX_API_KEY=sk_live_YOUR_KEY npx -y @scriptivox/mcp-serverGetting an API Key
Sign up at platform.scriptivox.com
Go to Keys in the dashboard
Create an API key (starts with
sk_live_...)Add credits at Billing ($5 minimum — API pricing is $0.20/hour of audio)
Tools
Discovery tools (no API key required)
Tool | Description |
| List all 119 supported transcription languages with ISO codes |
| View plans, API pricing, and per-file limits |
| Learn about Scriptivox features ( |
| API documentation sections ( |
Transcription tools (API key required)
Tool | Description |
| Transcribe audio/video from a public URL (Google Drive, Dropbox, OneDrive, or direct file URLs). Supports |
| Transcribe a LOCAL file. Drives the 3-step upload flow internally. Up to 5 GB. |
| Check the status of a transcription by ID. Returns the full transcript when completed. |
| Cancel a transcription before it starts transcribing. Refunds reserved balance. Idempotent. A job already transcribing finishes and is billed (409). |
| Soft-delete a transcription record. Idempotent. Refuses to delete in-flight jobs. |
| List recent transcriptions with |
| Export a completed transcript as SRT subtitles, WebVTT subtitles, or plain text. Segmentation knobs: |
| View your API credit balance and estimated hours available. |
Tip: always pass language when you know it
Auto-detection works in most cases but has a small failure rate on short clips, code-switched audio, or files starting with music. Passing the ISO code is both faster and more accurate.
Usage examples
Once connected, ask your AI assistant:
"Transcribe this podcast: https://example.com/episode.mp3 — it's in English"
"Transcribe ~/Downloads/meeting.m4a with speaker identification"
"Show me my last 5 transcriptions"
"Cancel transcription abc123-…"
"Export transcription abc123-… as SRT subtitles, 2 words per caption"
"What languages does Scriptivox support?"
"Check my Scriptivox balance"
Resources
The server exposes these MCP resources for AI assistants to read:
scriptivox://pricing— Plans and ratesscriptivox://languages— Supported languagesscriptivox://api-docs— API reference
Prompts
transcribe-audio— Pre-built prompt for URL transcriptionmeeting-notes— Transcribe a meeting and generate structured notes
Configuration
Environment Variable | Description | Required |
| Your API key ( | For transcription tools |
| Custom API base URL | No (defaults to production) |
Pricing
Free plan: 3 transcriptions/day, 30 min max
Pro plan: $20/month — unlimited transcriptions
API: $0.20/hour of audio (pay-as-you-go)
Links
Scriptivox — Main website
API Documentation — Full API reference
Dashboard — Manage your account
Smithery — MCP server registry
License
MIT
Available Tools
14 toolscheck_balanceAInspect
Check your Scriptivox API credit balance, available hours, and pricing. Requires a configured API key.
Inputs: no named parameters.
export_transcriptAInspect
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.
Inputs: format (required), transcription_id (required), max_chars, max_words, +4 more.
get_api_docsAInspect
Get Scriptivox API documentation. Sections: quickstart, transcribe, result, list, cancel, delete, upload, balance, webhooks, errors. No API key required.
Inputs: section.
get_pricingAInspect
Get Scriptivox pricing information including subscription plans (Free, Pro, Team) and API pay-as-you-go rates. Includes signup URLs. No API key required.
Inputs: no named parameters.
get_product_infoAInspect
Get information about Scriptivox capabilities: transcription, audio tools, video tools, subtitle tools, meeting bot, or API. No API key required.
Inputs: topic.
get_supported_languagesAInspect
List all languages supported by Scriptivox for audio/video transcription. Returns language names and ISO codes. No API key required.
Inputs: no named parameters.
list_transcriptionsAInspect
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.
Inputs: to, from, limit, order, +2 more.
transcribe_cancelAInspect
Cancel an in-flight Scriptivox transcription and release any reserved balance. Idempotent. Returns 409 CONFLICT on already-terminal jobs. Requires a configured API key.
Inputs: transcription_id (required).
transcribe_deleteAInspect
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.
Inputs: transcription_id (required).
transcribe_statusAInspect
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.
Inputs: transcription_id (required).
transcribe_uploadAInspect
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.
Inputs: file_path (required), align, diarize, language, +4 more.
transcribe_urlAInspect
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.
Inputs: url (required), align, diarize, language, +4 more.
transcription_statusAInspect
[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.
Inputs: transcription_id (required).
transcription_urlAInspect
[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.
Inputs: url (required), align, diarize, language, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Core transcription operations (transcribe, cancel, status, delete, export, list) are clearly distinct and easy to select between. The main source of ambiguity is the two deprecated aliases (transcription_url/transcription_status) that duplicate existing tools, and get_product_info/get_pricing have slight overlap.
Tool names generally follow a consistent verb_noun pattern: get_* for informational methods and transcribe_* for job operations. The deprecated transcription_url and transcription_status break the otherwise consistent transcribe_* naming convention, and list_transcriptions/export_transcript use slightly different verb placement.
14 tools is reasonable for a transcription API server covering metadata, job lifecycle, and export capabilities. The count is slightly padded by two redundant deprecated aliases, but they are clearly labeled and do not harm the overall scope significantly.
The server covers the transcription lifecycle well: create via URL or upload, check status, cancel, list, soft-delete, and export finished transcripts. Supporting operations for languages, pricing, balance, and API docs make the tool surface feel complete for real-world usage without obvious dead ends.
Maintenance
Related MCP Connectors
Transcribe audio & video to text for AI agents: 100+ languages, speaker labels, webhooks.
AI transcription API: turn voice memos, meetings and audio URLs into text and SRT subtitles.
Transcribe public audio/video URLs and retrieve transcripts, SRT, and VTT subtitles.
Transcribe audio and video files to text with timestamps and SRT or WebVTT subtitles
Related MCP Servers
- AlicenseAqualityCmaintenanceTranscribes videos from 1000+ platforms (YouTube, TikTok, Vimeo, etc.) and local video files using OpenAI's Whisper model, with support for 90+ languages and multiple output formats.844 npm8MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to transcribe audio files from URLs or local paths using AssemblyAI's services, with support for speaker diarization, language detection, and asynchronous job management through a standardized MCP interface.4207 npm2MIT
- AlicenseAqualityCmaintenanceEnables AI agents to transcribe audio and video with speaker labels, timestamps, and captions via Pepys API.948 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables transcription and speaker diarization of audio files, interviews, and YouTube URLs, producing speaker-attributed transcripts with timestamps. Supports multiple backends (local Whisper, OpenAI API) and output formats (txt, vtt, srt, json).Apache 2.0