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:

1. Environment variable LEANVOX_API_KEY (recommended)
2. 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.