HeyGen Voice MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
HeyGen Voice MCP
An MCP stdio server for the heygen/heygen-voice-1-turbo:free speech model on OpenRouter. It checks the live speech catalog before each request, refuses nonzero pricing or missing model, and never falls back to a paid route. The provider currently returns 44.1 kHz, 16-bit mono PCM; the server wraps it in WAV.
Chinese input is converted to Simplified Chinese by default before synthesis. The original input is not rewritten on disk. Keep user-facing Traditional Chinese or bilingual subtitles as separate text. This conversion is a practical pronunciation measure, not a guarantee of voice quality.
Install and configure
Python 3.11+ is required. From a trusted checkout:
python -m venv .venv
# Windows: .venv\Scripts\python -m pip install .
# macOS / Linux: .venv/bin/python -m pip install .Set OPENROUTER_API_KEY securely in the server process environment. Never commit keys or supply them in arguments. Example Codex registration (use your actual absolute paths):
codex mcp add heygen-voice -- /absolute/path/to/.venv/bin/heygen-voice-mcpOn Windows, point to .venv\Scripts\heygen-voice-mcp.exe. Restart the MCP host if needed. Environment inheritance depends on the host. Do not expose the key in a client config.
Related MCP server: realtime-tts-mcp
Tools
heygen_voice_status: read the current speech catalog; returns the exact model, pricing, available voices, and expiration.heygen_synthesize: providetext, absoluteoutput_pathending in.wav, optionalvoice(defaultnadine), andsimplify_chinese(default true). The parent directory must exist. Existing files are not overwritten. The tool returns duration, SHA-256 and generation ID, not credentials or audio bytes.
The service receives the input text. Do not transmit private content without authorization. The free endpoint has rate limits and may be retired or unavailable; requests fail closed when the model disappears or pricing is not zero. Never silently substitute a paid model. The live catalog and a :free route are not a provider-enforced spending cap; use OpenRouter account/key limits too.
The tool checks the returned content type and PCM length, not speech accuracy, language, pronunciation, or artistic quality. Verify the actual audio and any transcription separately. gpt-transcribe-mcp is optional and can incur OpenAI API charges; obtain the payer's consent first.
Development
python -m pip install -e .
python -m unittest discover -s tests -vTests mock provider calls and do not incur API charges. Live API/model availability, speech intelligibility, and listening are distinct checks; do not claim them from mocked tests.
Sources
MIT licensed. Independent community project, not affiliated with HeyGen or OpenRouter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate English and Chinese speech, split long text, track batch jobs, and download audio.
Speech-to-text, text-to-speech, OCR and typed decision-making APIs. Official site: https://suanlinfang.cn. New accounts get ¥10 free trial credit — create your API key: https://suanlinfang.cn/consume-web/api-keys.html
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
Text to speech, voice listing and phrase library search for AI assistants. API key header.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables speech-to-text and text-to-speech conversion using OpenAI-compatible APIs. Supports customizable models, voices, and output directories.GPL 3.0
- AlicenseAqualityCmaintenanceEnables text-to-speech synthesis through a streaming, GPU-accelerated gateway, exposing a single tool that returns playable WAV audio with configurable voice and speed.133 npmMIT
- AlicenseAqualityBmaintenanceText to speech in 149 languages: MP3 links from any assistant. Free without an account. 2,253 voices; PRO adds HD voices, WAV, dialogue with a voice per speaker, Script mode timing and transcription.750 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to synthesize Chinese speech with Edge-TTS or offline Piper and generate engine-level timestamp SRT subtitles, including batch parallel synthesis and voice presets.MIT