{
  "markdown": "# @scriptivox/mcp-server\n\n[![smithery badge](https://smithery.ai/badge/sparkleofficialmain/scriptivox)](https://smithery.ai/servers/sparkleofficialmain/scriptivox)\n\nMCP (Model Context Protocol) server for [Scriptivox](https://scriptivox.com) — AI-powered audio and video transcription.\n\nTurn 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.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"scriptivox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@scriptivox/mcp-server\"],\n      \"env\": {\n        \"SCRIPTIVOX_API_KEY\": \"sk_live_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add scriptivox -- npx -y @scriptivox/mcp-server\n```\n\nThen set the environment variable `SCRIPTIVOX_API_KEY=sk_live_YOUR_KEY`.\n\n### Other MCP Clients\n\nAny MCP-compatible client can use this server via stdio transport:\n\n```bash\nSCRIPTIVOX_API_KEY=sk_live_YOUR_KEY npx -y @scriptivox/mcp-server\n```\n\n## Getting an API Key\n\n1. Sign up at [platform.scriptivox.com](https://platform.scriptivox.com)\n2. Go to **[Keys](https://platform.scriptivox.com/keys)** in the dashboard\n3. Create an API key (starts with `sk_live_...`)\n4. Add credits at **[Billing](https://platform.scriptivox.com/billing)** ($5 minimum — API pricing is $0.20/hour of audio)\n\n## Tools\n\n### Discovery tools (no API key required)\n\n| Tool | Description |\n|------|-------------|\n| `get_supported_languages` | List all 119 supported transcription languages with ISO codes |\n| `get_pricing` | View plans, API pricing, and per-file limits |\n| `get_product_info` | Learn about Scriptivox features (`transcription`, `audio-tools`, `video-tools`, `subtitle-tools`, `meeting-bot`, `api`, `all`) |\n| `get_api_docs` | API documentation sections (`quickstart`, `transcribe`, `result`, `list`, `cancel`, `delete`, `upload`, `balance`, `webhooks`, `errors`, `all`) |\n\n### Transcription tools (API key required)\n\n| Tool | Description |\n|------|-------------|\n| `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`. |\n| `transcribe_upload` | Transcribe a LOCAL file. Drives the 3-step upload flow internally. Up to 5 GB. |\n| `transcribe_status` | Check the status of a transcription by ID. Returns the full transcript when completed. |\n| `transcribe_cancel` | Cancel an in-flight transcription. Refunds reserved balance. Idempotent. |\n| `transcribe_delete` | Soft-delete a transcription record. Idempotent. Refuses to delete in-flight jobs. |\n| `list_transcriptions` | List recent transcriptions with `status`, `from`, `to`, `limit`, `cursor`, `order` filters. |\n| `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`. |\n| `check_balance` | View your API credit balance and estimated hours available. |\n\n### Tip: always pass `language` when you know it\n\nAuto-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.\n\n## Usage examples\n\nOnce connected, ask your AI assistant:\n\n- *\"Transcribe this podcast: https://example.com/episode.mp3 — it's in English\"*\n- *\"Transcribe ~/Downloads/meeting.m4a with speaker identification\"*\n- *\"Show me my last 5 transcriptions\"*\n- *\"Cancel transcription abc123-…\"*\n- *\"Export transcription abc123-… as SRT subtitles, 2 words per caption\"*\n- *\"What languages does Scriptivox support?\"*\n- *\"Check my Scriptivox balance\"*\n\n## Resources\n\nThe server exposes these MCP resources for AI assistants to read:\n\n- `scriptivox://pricing` — Plans and rates\n- `scriptivox://languages` — Supported languages\n- `scriptivox://api-docs` — API reference\n\n## Prompts\n\n- `transcribe-audio` — Pre-built prompt for URL transcription\n- `meeting-notes` — Transcribe a meeting and generate structured notes\n\n## Configuration\n\n| Environment Variable | Description | Required |\n|---------------------|-------------|----------|\n| `SCRIPTIVOX_API_KEY` | Your API key (`sk_live_...`) | For transcription tools |\n| `SCRIPTIVOX_API_URL` | Custom API base URL | No (defaults to production) |\n\n## Pricing\n\n- **Free plan**: 3 transcriptions/day, 30 min max\n- **Pro plan**: $20/month — unlimited transcriptions\n- **API**: $0.20/hour of audio (pay-as-you-go)\n\n## Links\n\n- [Scriptivox](https://scriptivox.com) — Main website\n- [API Documentation](https://scriptivox.com/docs/api-reference) — Full API reference\n- [Dashboard](https://platform.scriptivox.com) — Manage your account\n- [Smithery](https://smithery.ai) — MCP server registry\n\n## License\n\nMIT\n",
  "bytes": 5068,
  "sha": "84c0b490880789b6a7eb1f2655be10a9ab77fddb8fdadb7a476cefdb6069f9f4",
  "repo_slug": "sparkleofficial/scriptivox-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_scriptivox_www_transcription_3c0aa657/readme"
}