Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Cartesia

von cartesia-aiVersion 1.0.0i★ 18iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.cartesia-ai/cartesia-mcp

So installierst du es

Was es kann

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

Originaltext des Herstellers

  • Verbindung Computer oder Cloud
  • Konto oder Schlüssel Cloud: Beim Verbinden beim Dienst anmelden (OAuth) · Lokal: Braucht CARTESIA_API_KEY
  • Kategorie Design, Bilder & Audio

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

impeccable

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

von pbakaus★ 113.0421 Skills

Skill · Anleitung

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.

von cathrynlavery★ 68.2961 Skills

Skill · Anleitung

frontend-slides

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

von zarazhangrui★ 32.5791 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit22/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert42/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Cartesia. Folge https://mcp.popnx.com/i/cartesia-ai-cartesia-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.cartesia.ai) · ✓ Befehle geprüft am 19. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameCartesia
    Remote MCP server URL · Adressehttps://mcp.cartesia.ai/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsCartesia

  4. Ausprobieren

    Nutze Cartesia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Cartesia nutzt, oder ein Werkzeug von Cartesia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameCartesia
    Connection · Adressehttps://mcp.cartesia.ai/mcp
  3. Cartesia im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Cartesia aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Cartesia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Cartesia nutzt, oder ein Werkzeug von Cartesia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

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

    Cartesia sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Cartesia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Cartesia nutzt, oder ein Werkzeug von Cartesia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Cartesia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Cartesia nutzt, oder ein Werkzeug von Cartesia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Cartesia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Cartesia nutzt, oder ein Werkzeug von Cartesia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.cartesia.ai/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Cartesia nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
    }
  }
}

Auf deinem Computer installiert

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"
      }
    }
  }
}

Werte, die du selbst einträgst

  • CARTESIA_API_KEY geheim erforderlich env
    Cartesia-API-Schlüssel von https://play.cartesia.ai/keys
    Englisches Original anzeigenCartesia API key from https://play.cartesia.ai/keys
  • CARTESIA_ADMIN_API_KEY geheim env
    Optionaler Admin-API-Schlüssel für Tools zur Kreditnutzung
    Englisches Original anzeigenOptional admin API key for credit usage tools
  • OUTPUT_DIRECTORY env
    Verzeichnis, in das generierte und heruntergeladene Audiodateien geschrieben werden
    Englisches Original anzeigenDirectory where generated and downloaded audio files are written

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
552/Wo.
Lizenzi
Keine Lizenz angegeben
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
19. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
cartesia-ai
Pakete
pypi: cartesia-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto cartesia-ai bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 291 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Die Cloud-Adresse hat bei 5 der letzten 5 Prüfungen geantwortet · zuletzt 291 ms · geprüft 19. Nov. 2026

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Design, Bilder & Audioi

  • Mehr Sterne als 94 % der anderen 3313 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 97 % der anderen 3313 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 55 % der anderen 3313 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Cartesia sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: CARTESIA_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (1.0.0) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

HyperFrames by HeyGen

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

von heygen-comWeit verbreitet★ 86.798 Sterne des ganzen ReposAktualisiert vorgestern

Läuft in der Cloud✓ heygen.com

Pascal 3D Editor

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

von pascalorgWeit verbreitet↓ 1037/Wo.★ 25.617 Sterne des ganzen ReposAktualisiert vorgestern

Computer oder Cloud✓ vom Dienst · pascal.app

draw.io

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

von jgraphWeit verbreitet★ 5860Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ vom Dienst · draw.ioVom PopNx-Team ausprobiert

Figma MCP Server

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

von figmaWeit verbreitet★ 2211Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.figma.com

Remocn: Remotion MCP server

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

von RemocnWachsend★ 1804Aktualisiert vor 10 Tagen

Läuft in der Cloud✓ vom Dienst · remocn.dev
Im Vergleich mit ähnlichen
Dieser
Cartesia
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinJaNein
Basisprüfungen4/54/45/54/44/44/4
Lizenz–Apache-2.0MITApache-2.0–MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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.