About Leanvox
Leanvox is an MCP server in the AI category: model Context Protocol (MCP) server for the Leanvox TTS API.
Install
claude mcp add leanvox -- npx -y leanvox-mcpnpx -y leanvox-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
leanvox_check_balanceCheck account balance
Parameters not published.
leanvox_clone_voiceClone a voice from audio
Parameters not published.
leanvox_design_voiceDesign a voice from a description
Parameters not published.
leanvox_dialogueCreate multi-speaker dialogue
Parameters not published.
leanvox_generateGenerate speech from text
Parameters not published.
leanvox_get_jobGet async TTS/STT job status
Parameters not published.
leanvox_list_jobsList async TTS/STT jobs
Parameters not published.
leanvox_list_voicesBrowse available voices
Parameters not published.
leanvox_streamStream audio to a file
Parameters not published.
leanvox_transcribeTranscribe audio or schedule async STT jobs
Parameters not published.
Ask AI
Ask AI about Leanvox
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
leanvox-mcp
Use Leanvox TTS directly from Claude, ChatGPT, Cursor, and any MCP-compatible AI assistant.
Zero code. One config line. Instant text-to-speech in your AI tools.
Quick Setup
Claude Desktop
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"leanvox": {
"command": "npx",
"args": ["-y", "leanvox-mcp"],
"env": {
"LEANVOX_API_KEY": "lv_live_your_key_here"
}
}
}
}
Restart Claude Desktop. Done. ✨
Cursor
Settings → MCP → Add Server:
{
"leanvox": {
"command": "npx",
"args": ["-y", "leanvox-mcp"],
"env": {
"LEANVOX_API_KEY": "lv_live_your_key_here"
}
}
}
VS Code (Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"leanvox": {
"command": "npx",
"args": ["-y", "leanvox-mcp"],
"env": {
"LEANVOX_API_KEY": "lv_live_your_key_here"
}
}
}
}
Claude Code (CLI)
claude mcp add leanvox -- npx -y leanvox-mcp
Set your API key:
export LEANVOX_API_KEY="lv_live_your_key_here"
What You Can Do
Once connected, just ask your AI assistant in natural language:
"Read this paragraph aloud using the podcast_conversational_female voice"
"Create a podcast dialogue between two speakers about AI"
"Clone my voice from this audio file"
"What voices are available?"
"Check my Leanvox balance"
The AI assistant handles everything — no code needed.
Available Tools
| Tool | Description |
|---|---|
leanvox_generate |
Generate speech from text |
leanvox_stream |
Stream audio to a file |
leanvox_dialogue |
Create multi-speaker dialogue |
leanvox_list_voices |
Browse available voices |
leanvox_clone_voice |
Clone a voice from audio |
leanvox_design_voice |
Design a voice from a description |
leanvox_check_balance |
Check account balance |
Resources
| Resource | URI | Description |
|---|---|---|
| Voices | leanvox://voices |
All available voices |
| Curated | leanvox://voices/curated |
14 curated Pro voices |
| History | leanvox://generations |
Past generations |
| Account | leanvox://account |
Balance & usage |
Prompts
| Prompt | Description |
|---|---|
narrate |
Convert text to natural speech |
podcast |
Create a multi-speaker podcast |
voice-clone |
Clone a voice from reference audio |
Authentication
Get your API key at leanvox.com/dashboard.
Pass it via:
- Environment variable
LEANVOX_API_KEY(recommended) - Config file
~/.lvox/config.toml
Requirements
- Node.js 18+
- Leanvox API key (get one free)
Standalone Usage
# Run directly
npx leanvox-mcp
# Or install globally
npm install -g leanvox-mcp
leanvox-mcp
Troubleshooting
"Tool not found" — Restart your AI app after adding the config.
"Authentication error" — Check your LEANVOX_API_KEY is set correctly.
"Connection refused" — Make sure Node.js 18+ is installed: node --version
Links
- Leanvox — Main site
- API Docs — Full API reference
- Python SDK —
pip install leanvox - Node.js SDK —
npm install leanvox - GitHub — Source & issues
License
MIT
leanvox-mcp — Text-to-speech for the AI era.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.