Skip to main content
Glama
IMPORTANT

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/mcp

In 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-server

Then 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-server

Getting an API Key

  1. Sign up at platform.scriptivox.com

  2. Go to Keys in the dashboard

  3. Create an API key (starts with sk_live_...)

  4. Add credits at Billing ($5 minimum — API pricing is $0.20/hour of audio)

Tools

Discovery tools (no API key required)

Tool

Description

get_supported_languages

List all 119 supported transcription languages with ISO codes

get_pricing

View plans, API pricing, and per-file limits

get_product_info

Learn about Scriptivox features (transcription, audio-tools, video-tools, subtitle-tools, meeting-bot, api, all)

get_api_docs

API documentation sections (quickstart, transcribe, result, list, cancel, delete, upload, balance, webhooks, errors, all)

Transcription tools (API key required)

Tool

Description

transcribe_url

Transcribe audio/video from a public URL (Google Drive, Dropbox, OneDrive, or direct file URLs). Supports language, diarize, speaker_count, align, webhook_url, idempotency_key, await_completed.

transcribe_upload

Transcribe a LOCAL file. Drives the 3-step upload flow internally. Up to 5 GB.

transcribe_status

Check the status of a transcription by ID. Returns the full transcript when completed.

transcribe_cancel

Cancel a transcription before it starts transcribing. Refunds reserved balance. Idempotent. A job already transcribing finishes and is billed (409).

transcribe_delete

Soft-delete a transcription record. Idempotent. Refuses to delete in-flight jobs.

list_transcriptions

List recent transcriptions with status, from, to, limit, cursor, order filters.

export_transcript

Export a completed transcript as SRT subtitles, WebVTT subtitles, or plain text. Segmentation knobs: max_words, max_chars, max_duration, sentence_aware, include_speakers, strip_chars.

check_balance

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 rates

  • scriptivox://languages — Supported languages

  • scriptivox://api-docs — API reference

Prompts

  • transcribe-audio — Pre-built prompt for URL transcription

  • meeting-notes — Transcribe a meeting and generate structured notes

Configuration

Environment Variable

Description

Required

SCRIPTIVOX_API_KEY

Your API key (sk_live_...)

For transcription tools

SCRIPTIVOX_API_URL

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)

License

MIT

Available Tools

14 tools
check_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

    A4.1/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers