cartesia-ai/cartesia-mcp

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:
bash
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:
json
"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 getcreditusage. 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 'CARTESIAAPIKEY=${CARTESIAAPIKEY}'
Cursor — Install local Cartesia MCP, then set CARTESIAAPIKEY in Settings → MCP.
Claude Code — claude mcp add -e CARTESIAAPIKEY= cartesia -- uvx cartesia-mcp
json
"mcpServers": {
"cartesia": {
"command": "uvx",
"args": ["cartesia-mcp"],
"env": {
"CARTESIAAPIKEY": " "
## 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
Keep this table in sync with @mcp.tool registrations in cartesiamcp/server.py (tests/testreadmetools.py enforces that). Mirror the same tool names on Cartesia docs — MCP when you ship a change.
| Tool | Description |
| texttospeech | Convert text to audio; optional outputpath (local server), speed, volume, emotion, and pronunciation dict. Default save=true returns fileid and a 24h downloadurl. |
| speechtotext | Transcribe audio from fileid or a server filepath (mode=batch default, or mode=stream) |
| listvoices | List available voices (filter by language, search, gender, etc.) |
| getvoice | Fetch metadata for a voice by ID |
| clonevoice | Clone a voice from fileid or a server filepath |
| updatevoice | Update a cloned voice's name or description |
| deletevoice | Delete a cloned voice |
| localizevoice | Adapt a voice to another language or dialect |
| listaccents | List catalog accent IDs and metadata (british, standard-japanese, …) |
| listmodels | List callable Sonic (TTS) and Ink (STT) model ids (capability=tts|stt) |
| addvoiceaccents | Add catalog accents to an instant voice clone (british, parisian, …) |
| deletevoiceaccent | Remove a catalog accent from an instant voice clone |