MCP Server

The VocalLab MCP server lets AI tools — Claude Desktop, Claude Code, Cursor, VS Code and others — generate speech with your account through the Model Context Protocol.

Requires a Pro plan or higher. No API key needed up front — the setup creates one for you.

Quickest setup (one click)

On the Developer page, open Use in AI tools (MCP). Pick your client, then press the single button — it generates an API key for you and wires it up in one step. There's nothing to copy or paste.

Client	Button	What happens
Cursor	Add to Cursor	Opens Cursor and installs the VocalLab server directly.
VS Code	Add to VS Code	Opens VS Code and installs the server directly.
Claude Code	Copy install command	Copies a `claude mcp add …` command — paste it into your terminal or a Claude Code chat.
Claude Desktop	Download config file	Saves a ready-to-use `claude_desktop_config.json` to drop into your Claude config folder.

Your new key is shown once in the banner at the top of the section. Copy it somewhere safe before you leave the page — for security we can't show it again.

Prefer to set it up by hand? Every client also has Copy and Download buttons on the config preview, so you can paste the snippet wherever you like.

Using VocalLab Studio

Inside the VocalLab Studio workspace, use its own MCP page — same idea: generate a key, pick your client, then connect. It also supports Windsurf and any other MCP-compatible client via a generic config.

Tools

get_balance — your points balance
list_voices — voices you can use
list_models — the speech models (VocalLab Studio / Pro / Lite)
generate_speech — text → speech, returns an audio URL. Accepts an optional model (v-studio, v-pro, or v-lite)

Once connected, ask your assistant to "list VocalLab voices", "generate speech with VocalLab", or "generate that with the VocalLab Studio model." See Voice Models for what each model does.

Hosted server

Every one-click option points at the hosted server — there's nothing to install or run:

URL: https://mcp.vocallab.ai/mcp
Header: Authorization: Bearer vl_live_...

Manual config (Claude Desktop & others)

This is exactly what the Download config file button produces. Add it to your client's MCP config:

{
  "mcpServers": {
    "vocallab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vocallab.ai/mcp", "--header", "Authorization: Bearer vl_live_..."]
    }
  }
}

Claude Desktop's config file lives at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file already exists, merge the vocallab entry under mcpServers instead of replacing it, then restart Claude Desktop.

Quickest setup (one click)

Client	Button	What happens
Cursor	Add to Cursor	Opens Cursor and installs the VocalLab server directly.
VS Code	Add to VS Code	Opens VS Code and installs the server directly.
Claude Code	Copy install command	Copies a `claude mcp add …` command — paste it into your terminal or a Claude Code chat.
Claude Desktop	Download config file	Saves a ready-to-use `claude_desktop_config.json` to drop into your Claude config folder.

Your new key is shown once in the banner at the top of the section. Copy it somewhere safe before you leave the page — for security we can't show it again.

Prefer to set it up by hand? Every client also has Copy and Download buttons on the config preview, so you can paste the snippet wherever you like.

Tools

get_balance — your points balance

list_voices — voices you can use

list_models — the speech models (VocalLab Studio / Pro / Lite)

generate_speech — text → speech, returns an audio URL. Accepts an optional model (v-studio, v-pro, or v-lite)

Once connected, ask your assistant to "list VocalLab voices", "generate speech with VocalLab", or "generate that with the VocalLab Studio model." See Voice Models for what each model does.

Manual config (Claude Desktop & others)

This is exactly what the Download config file button produces. Add it to your client's MCP config:

{ "mcpServers": { "vocallab": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.vocallab.ai/mcp", "--header", "Authorization: Bearer vl_live_..."] } } }

Claude Desktop's config file lives at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file already exists, merge the vocallab entry under mcpServers instead of replacing it, then restart Claude Desktop.