Scriptivox

by SparkleOfficial

297 downloads

Not rated

GitHub

About

MCP server for Scriptivox AI transcription. Transcribe audio and video from URLs or local files in 119 languages, with speaker diarization, word-level timestamps, and SRT/VTT/text export. Bring transcription to Claude Desktop, Cursor, Cline, and any MCP-compatible client.

Details

Author: SparkleOfficial
Downloads: 297
Categories: Other, Media, AI

- 119 languages with automatic language detection
- Speaker diarization with word-level alignment
- Word-level timestamps and confidence scores
- Idempotency keys, webhooks, and pagination
- Multi-arch Docker image (linux/amd64 + linux/arm64)
- 14 tools covering transcription, job management, and discovery

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Scriptivox

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

From the repository

Obtain an API key from platform.scriptivox.com/keys, add credits (minimum $5, billed at $0.20 per hour of audio), and add the server configuration to your MCP client (e.g., Claude Desktop, Cursor). The server is available as an npm package (@scriptivox/mcp-server) and a multi-arch Docker image.

`get_supported_languages`

List all languages supported by Scriptivox for audio/video transcription. Returns language names and ISO codes. 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_api_docs`

Get Scriptivox API documentation. Sections: quickstart, transcribe, result, list, cancel, delete, upload, balance, webhooks, errors. No API key required.

`check_balance`

Check your Scriptivox API credit balance, available hours, and pricing. 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.

`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.

`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.

`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.

`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_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.

`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.

`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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "scriptivox": {
            "scriptivox": {
                "command": "npx",
                "args": [
                    "-y",
                    "@scriptivox/mcp-server"
                ],
                "env": {
                    "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "scriptivox": {
        "command": "npx",
        "args": [
            "-y",
            "@scriptivox/mcp-server"
        ],
        "env": {
            "SCRIPTIVOX_API_KEY": "<YOUR_SCRIPTIVOX_API_KEY>"
        }
    }
}

What it does

Scriptivox MCP exposes 14 tools so any MCP client can transcribe audio/video: - transcribe_url — transcribe from any public URL (mp3, mp4, etc.) - transcribe_upload — transcribe a local file (up to 5 GB) - transcribe_status, transcribe_cancel, transcribe_delete — manage jobs - list_transcriptions — browse history - export_transcript — export as SRT, VTT, or plain text - check_balance — view API credit balance - Discovery tools (no key needed): get_supported_languages, get_pricing, get_product_info, get_api_docs ## Features - 119 languages with auto-detect - Speaker diarization with word-level alignment - Word-level timestamps and confidence scores - Idempotency keys, webhooks, pagination - Multi-arch Docker image (linux/amd64 + linux/arm64) ## Setup 1. Get an API key at platform.scriptivox.com/keys 2. Add credits (min $5, billed at $0.20/hour of audio) 3. Add the config above to your MCP client (Claude Desktop, Cursor, etc.) ## Links - npm: @scriptivox/mcp-server - Docker: sparkleofficialmain/scriptivox-mcp-server - Source: github.com/SparkleOfficial/scriptivox-mcp-server - Dashboard: platform.scriptivox.com

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_supported_languages

get_pricing

get_product_info

get_api_docs

check_balance

transcribe_url

transcribe_status

transcription_url

transcription_status

transcribe_upload

transcribe_cancel

transcribe_delete

list_transcriptions

export_transcript

Claude Desktop / Cursor

McpServers

What it does

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Maps

Google Drive

Context 7

`get_supported_languages`

`get_pricing`

`get_product_info`

`get_api_docs`

`check_balance`

`transcribe_url`

`transcribe_status`

`transcription_url`

`transcription_status`

`transcribe_upload`

`transcribe_cancel`

`transcribe_delete`

`list_transcriptions`

`export_transcript`