Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

Cartesia

de cartesia-aiversión 1.0.0i★ 18iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.cartesia-ai/cartesia-mcp

Cómo instalar

Qué hace

Cartesia voice AI: text-to-speech, speech-to-text, voice cloning, and voice management.

Texto original del autor

  • Conexión Computadora o nube
  • Cuenta o clave Nube: Inicias sesión en el servicio al conectar (OAuth) · Local: Necesita CARTESIA_API_KEY
  • Categoría Diseño, imágenes y audio

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

de pbakaus★ 113.0421 skills

Skill · Guía de trabajo

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

de cathrynlavery★ 68.2961 skills

Skill · Guía de trabajo

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

de zarazhangrui★ 32.5791 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad22/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso42/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Cartesia. Sigue https://mcp.popnx.com/i/cartesia-ai-cartesia-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.cartesia.ai) · ✓ Comandos revisados el 19 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCartesia
    Remote MCP server URL · Direcciónhttps://mcp.cartesia.ai/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsCartesia

  4. Pruébalo

    Usa Cartesia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Cartesia o muestra una herramienta de Cartesia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreCartesia
    Connection · Direcciónhttps://mcp.cartesia.ai/mcp
  3. Elige Cartesia en un chat

    Abre un chat nuevo y elige Cartesia en tus plugins antes de escribir

  4. Pruébalo

    Usa Cartesia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Cartesia o muestra una herramienta de Cartesia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user cartesia https://mcp.cartesia.ai/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Cartesia en la lista como conectado

  4. Pruébalo

    Usa Cartesia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Cartesia o muestra una herramienta de Cartesia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Cartesia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Cartesia o muestra una herramienta de Cartesia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Cartesia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Cartesia o muestra una herramienta de Cartesia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.cartesia.ai/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Cartesia💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "cartesia": {
      "type": "http",
      "url": "https://mcp.cartesia.ai/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user cartesia --env CARTESIA_API_KEY=your-value -- uvx cartesia-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "cartesia": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cartesia-mcp"
      ],
      "env": {
        "CARTESIA_API_KEY": "your-value"
      }
    }
  }
}

Valores que debes completar

  • CARTESIA_API_KEY secreto obligatorio env
    Clave de API de Cartesia de https://play.cartesia.ai/keys
    Ver original en inglésCartesia API key from https://play.cartesia.ai/keys
  • CARTESIA_ADMIN_API_KEY secreto env
    Clave API de administrador opcional para las herramientas de uso de créditos
    Ver original en inglésOptional admin API key for credit usage tools
  • OUTPUT_DIRECTORY env
    Directorio donde se escriben los archivos de audio generados y descargados
    Ver original en inglésDirectory where generated and downloaded audio files are written

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
552/sem
Licenciai
Sin licencia indicada
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
1.0.0
Publicado en el registroi
19 nov 2026
Último cambio de códigoi
19 nov 2026
Última revisión
19 nov 2026
Creador
cartesia-ai
Paquetes
pypi: cartesia-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub cartesia-ai, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✕ No superada

    Tiene licencia

    No se encontró ningún archivo de licencia en el repo

  • ✓ Superada

    El endpoint responde

    Respondió en 291 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

La dirección en la nube respondió 5 de las últimas 5 comprobaciones · última 291 ms · revisado 19 nov 2026

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cartesia-ai-cartesia-mcp.svg)](https://mcp.popnx.com/en/servers/cartesia-ai-cartesia-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Diseño, imágenes y audioi

  • Más estrellas que el 94% de los otros 3322 servidores de esta categoría
  • Publicado en el registro más recientemente que el 96% de los otros 3322 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 55% de los otros 3322 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Cartesia?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: CARTESIA_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (1.0.0) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

de heygen-comMuy usado★ 86,8 mil Estrellas de todo el repositorioActualizado anteayer

Se ejecuta en la nube✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

de pascalorgMuy usado↓ 1 mil/sem★ 25,6 mil Estrellas de todo el repositorioActualizado anteayer

Computadora o nube✓ del servicio · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

de jgraphMuy usado★ 5,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · draw.ioProbado por el equipo de PopNx

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

de figmaMuy usado★ 2,2 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · mcp.figma.com

Remocn: Remotion MCP server

Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.

de RemocnEn crecimiento★ 1,8 milActualizado hace 10 días

Se ejecuta en la nube✓ del servicio · remocn.dev
Comparado con otros parecidos
Este
Cartesia
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoSíNo
Revisiones básicas4/54/45/54/44/44/4
Licencia–Apache-2.0MITApache-2.0–MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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](https://docs.astral.sh/uv/) (Python 3.13+ is installed by uvx) and a [Cartesia API key](https://play.cartesia.ai/keys). Optionally set an [admin API key](https://play.cartesia.ai/keys) (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

Keep this table in sync with @mcp.tool registrations in cartesia_mcp/server.py (tests/test_readme_tools.py enforces that). Mirror the same tool names on Cartesia docs — MCP when you ship a change.

ToolDescription
text_to_speechConvert text to audio; optional output_path (local server), speed, volume, emotion, and pronunciation dict. Default save=true returns file_id and a 24h download_url.
speech_to_textTranscribe audio from file_id or a server file_path (mode=batch default, or mode=stream)
list_voicesList available voices (filter by language, search, gender, etc.)
get_voiceFetch metadata for a voice by ID
clone_voiceClone a voice from file_id or a server file_path
update_voiceUpdate a cloned voice's name or description
delete_voiceDelete a cloned voice
localize_voiceAdapt a voice to another language or dialect
list_accentsList catalog accent IDs and metadata (british, standard-japanese, …)
list_modelsList callable Sonic (TTS) and Ink (STT) model ids (`capability=ttsstt`)
list_agent_modelsList Managed Agents LLM ids from GET /v1/agents/models (full catalog)
add_voice_accentsAdd catalog accents to an instant voice clone (british, parisian, …)
delete_voice_accentRemove a catalog accent from an instant voice clone
list_pronunciation_dictsList pronunciation dictionaries
create_pronunciation_dictCreate a pronunciation dictionary
get_pronunciation_dictGet a pronunciation dictionary by ID
update_pronunciation_dictUpdate a pronunciation dictionary
delete_pronunciation_dictDelete a pronunciation dictionary
download_fileFetch a cloud file by ID (download_url + local copy)
get_credit_usageCredit usage over time (CARTESIA_ADMIN_API_KEY)

See cartesia_mcp/server.py for parameters and return types.

Prompts

PromptDescription
generate_and_transcribeSynthesize text with a voice, then transcribe it back to verify
clone_and_localizeClone a voice from a file_id, then localize it to another language

Releases

Versions and PyPI publishes are driven by Conventional Commits on main via release-please. Use PR titles like feat: … or fix: … (especially when squash merging). See CONTRIBUTING.md.

Local development

Run your checkout in an MCP client instead of the published uvx cartesia-mcp package:

git clone https://github.com/cartesia-ai/cartesia-mcp.git

cd cartesia-mcp uv sync --dev

Set CARTESIA_API_KEY (and optionally CARTESIA_ADMIN_API_KEY). Replace /path/to/cartesia-mcp below with your checkout path.

Cursor — add to .cursor/mcp.json:

{

"mcpServers": { "cartesia": { "command": "uv", "args": ["--directory", "/path/to/cartesia-mcp", "run", "cartesia-mcp"], "env": { "CARTESIA_API_KEY": " " } } } }

Restart Cursor or reload MCP servers, then confirm cartesia appears under Settings → MCP.

Claude Code:

claude mcp add -e CARTESIA_API_KEY=<your-api-key> cartesia -- uv --directory /path/to/cartesia-mcp run cartesia-mcp

In a Claude Code session, run /mcp, select cartesia, and verify tools load.

Testing

Unit tests (no API keys):

uv sync --dev

uv run pytest

Smoke-test all tools (requires CARTESIA_API_KEY):

uv run python scripts/test_all_tools.py

The script creates temporary cloned/localized voices and pronunciation dictionaries, then deletes only those. It does not delete catalog or other existing resources.

Advanced

Output directory

On the local server, generated audio is written to the working directory by default. To choose a fixed folder, add OUTPUT_DIRECTORY to env:

"env": {

"CARTESIA_API_KEY": " ", "OUTPUT_DIRECTORY": "~/cartesia-output" }

With the local server (uvx / stdio), text_to_speech also accepts output_path to write a specific file (for example an absolute path under your project). Relative paths resolve against the MCP process working directory (often not your project root), so prefer absolute paths. Hosted MCP (mcp.cartesia.ai) rejects output_path — use file_id / download_url there. Hosted text_to_speech with save=true (the default) does not keep a local file_path; temporary copies used for download_file / same-session inputs live under the system temp directory and are deleted after about an hour (OUTPUT_FILE_TTL_SECONDS). Hosted cleanup emits JSON logs (mcp_output_cleanup / mcp_output_disk_warn) and DogStatsD gauges (mcp.output.bytes, mcp.output.files); warn when the dir exceeds OUTPUT_DIRECTORY_WARN_BYTES (default 2GiB).

Audio inputs (file_id or file_path)

speech_to_text and clone_voice take one of:

  • `file_id` — a Cartesia cloud file from text_to_speech (save=true) or download_file. Use this on hosted MCP (mcp.cartesia.ai). The server downloads the bytes. A path on the agent machine will not be found.
  • `file_path` — an absolute path on the machine running MCP that must exist. Use this with local uvx, or pass a file_path from download_file / save=false TTS in the same hosted session. On hosted MCP, only files the server wrote under its output directory are accepted; any other path (missing, client-local like /Users/..., or elsewhere on the server) returns a validation error telling you to use file_id.

download_url is a 24-hour browser link. It is not an input to those tools.

For speech_to_text, use the default batch mode for common containers (mp3, flac, wav, etc.). Use mode="stream" for mono PCM WAV or raw PCM with encoding and sample_rate.

Admin API key

Some tools call management endpoints that accept admin API keys only (sk_car_admin_...). Set CARTESIA_ADMIN_API_KEY in env alongside CARTESIA_API_KEY:

  • CARTESIA_API_KEY — TTS, STT, voices, pronunciation dictionaries, etc.
  • CARTESIA_ADMIN_API_KEY — optional; required for get_credit_usage today. Admin keys do not work on generation routes, and standard keys do not work on admin routes.

Mint admin keys in the Playground under Keys → Admin (org admins only).

Hosted sessions and rate limits

Hosted MCP keeps one live session per client on handshake-era protocol versions. After initialize, reuse the mcp-session-id response header on later requests. A POST /mcp without that header starts a new session and replaces the previous one for that client.

Requests with MCP-Protocol-Version: 2026-07-28 do not open a session. They are not counted against the new-session limit below.

A session with no requests for 30 minutes is closed. Call initialize again to open a new one.

New sessions are limited to 5 per minute per access token and 15 per minute per client IP. Over the limit, the server returns HTTP 429:

{

"error": "too_many_requests", "error_description": "MCP session creation rate limit exceeded" }

Retry-After is the window in seconds (60 for session creation). Wait and retry with the same session id when you still have one. A 429 is not an expired login — do not mark the connector failed or start a new OAuth flow.

Hosted OAuth redirect URIs

Hosted MCP (mcp.cartesia.ai) accepts Dynamic Client Registration with a restricted redirect-URI policy:

  • Custom schemes (desktop apps) — e.g. cursor://…, vscode://…
  • Loopback HTTP — http://localhost|127.0.0.1|::1 (any port/path)
  • Allowlisted HTTPS — first-party callbacks for Claude, ChatGPT, Cursor web/Agents, VS Code Web, and Devin

To temporarily allow another exact HTTPS callback without a code change, set:

MCP_OAUTH_EXTRA_HTTPS_REDIRECTS=partner.example|/mcp/oauth/callback

(comma-separated host|/path pairs). Prefer adding durable hosts in code for known products.

API version

All tools send Cartesia-Version (default 2026-08-14, the latest in Cartesia docs). Override with CARTESIA_VERSION in env if you pin an older integration date.