Cartesia MCP Server

The Cartesia MCP server exposes Cartesia APIs over the Model Context Protocol (MCP) so clients such as Cursor, Claude Desktop, and OpenAI Agents can list voices, run TTS and STT, manage pronunciation dictionaries, clone voices, and more—without one-off scripts.

Documentation: Cartesia docs — MCP

Setup

Hosted (recommended) — connect to https://mcp.cartesia.ai/mcp and sign in when prompted. A Cartesia MCP API key is created for your organization if one does not exist yet. You can also connect from API Keys in the Playground.

Cursor — Install Cartesia MCP, then sign in to the Playground when your browser opens.

Claude Code:

claude mcp add --transport http --scope user cartesia-mcp https://mcp.cartesia.ai/mcp

Run /mcp, select cartesia-mcp, and sign in when prompted.

Or add to .cursor/mcp.json / your client’s MCP config:

{
  "mcpServers": {
    "cartesia-mcp": {
      "url": "https://mcp.cartesia.ai/mcp"
    }
  }
}

Local (uvx)

Run the published package on your machine with an API key. Requires uv (Python 3.13+ is installed by uvx) and a Cartesia API key. Optionally set an admin API key (Keys → Admin) for get_credit_usage. Admin keys and standard keys are separate credentials; each only works on its own route class.

CLI — npx add-mcp "uvx cartesia-mcp" --name cartesia --env 'CARTESIA_API_KEY=${CARTESIA_API_KEY}'

Cursor — Install local Cartesia MCP, then set CARTESIA_API_KEY in Settings → MCP.

Claude Code — claude mcp add -e CARTESIA_API_KEY= cartesia -- uvx cartesia-mcp

{
  "mcpServers": {
    "cartesia": {
      "command": "uvx",
      "args": ["cartesia-mcp"],
      "env": {
        "CARTESIA_API_KEY": ""
      }
    }
  }
}

Try it

Ask your agent things like:

• List all available Cartesia voices
• Convert text to audio with a chosen voice (speed, volume, emotion)
• Transcribe an audio file to text
• Create a pronunciation dictionary and use it in TTS
• Check credit usage for your account
• Localize an existing voice into another language
• List catalog accent IDs, then add British English to a cloned voice

Tools