プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Cartesia

作者:cartesia-aiバージョン 1.0.0i★ 18iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.cartesia-ai/cartesia-mcp

インストール方法

できること

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

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー クラウド:接続時にサービスへログイン(OAuth) · ローカル:CARTESIA_API_KEY が必要
  • カテゴリ デザイン・画像・音声

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

impeccable

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

作者:pbakaus★ 113,0421 個の skill

Skill · 手順書

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.

作者:cathrynlavery★ 68,2961 個の skill

Skill · 手順書

frontend-slides

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

作者:zarazhangrui★ 32,5791 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気22/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア42/100

品質: 基本チェック 4/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Cartesia をインストールして。https://mcp.popnx.com/i/cartesia-ai-cartesia-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 4/5 合格 · 質問内容は提供元のサーバー(mcp.cartesia.ai)を通ります · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Cartesia
    Remote MCP server URL · アドレスhttps://mcp.cartesia.ai/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsCartesia

  4. 試してみる

    Cartesia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Cartesia を使っていると言うか、回答に Cartesia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Cartesia
    Connection · アドレスhttps://mcp.cartesia.ai/mcp
  3. チャットで Cartesia を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Cartesia を選びます

  4. 試してみる

    Cartesia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Cartesia を使っていると言うか、回答に Cartesia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user cartesia https://mcp.cartesia.ai/mcp
  3. Claude Code で /mcp と入力

    Cartesia が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Cartesia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Cartesia を使っていると言うか、回答に Cartesia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Cartesia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Cartesia を使っていると言うか、回答に Cartesia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Cartesia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Cartesia を使っていると言うか、回答に Cartesia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.cartesia.ai/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Cartesia を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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

パソコンにインストール

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

自分で入力する値

  • CARTESIA_API_KEY 秘密 必須 env
    https://play.cartesia.ai/keys から取得した Cartesia API キー
    英語の原文を見るCartesia API key from https://play.cartesia.ai/keys
  • CARTESIA_ADMIN_API_KEY 秘密 env
    クレジット使用量ツール用のオプションの管理者 API キー
    英語の原文を見るOptional admin API key for credit usage tools
  • OUTPUT_DIRECTORY env
    生成およびダウンロードされた音声ファイルを書き込むディレクトリ
    英語の原文を見るDirectory where generated and downloaded audio files are written

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
552/週
ライセンスi
ライセンスの記載なし
接続方法
パソコンでもクラウドでも
最新バージョンi
1.0.0
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
最終確認
2026年11月19日
作者
cartesia-ai
パッケージ
pypi: cartesia-mcp
ウェブサイト
docs.cartesia.ai
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント cartesia-ai で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✕ 不合格

    ライセンスがある

    リポジトリにライセンスファイルが見つかりません

  • ✓ 合格

    エンドポイントが応答する

    291ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

クラウドのアドレスは直近 5 回中 5 回応答 · 最新 291 ms · 確認日 2026年11月19日

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

デザイン・画像・音声のほかのサーバーとの比較i

  • このカテゴリのほかの3322件のうち94%よりスターが多い
  • このカテゴリのほかの3322件のうち96%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3322件のうち55%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Cartesiaは安全ですか?

当てはまる基本チェック5項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:CARTESIA_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.0.0)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

HyperFrames by HeyGen

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

作者:heygen-com広く使われている★ 8.7万 リポジトリ全体のスター一昨日更新

クラウドで動く✓ heygen.com

Pascal 3D Editor

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

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター一昨日更新

パソコンでもクラウドでも✓ 提供元 · pascal.app

draw.io

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

作者:jgraph広く使われている★ 58603 日前更新

クラウドで動く✓ 提供元 · draw.ioPopNx チームが実際に試用

Figma MCP Server

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

作者:figma広く使われている★ 221313 か月前更新

クラウドで動く✓ 提供元 · mcp.figma.com
似たものと比べる
これ
Cartesia
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえはいいいえ
基本チェック4/54/45/54/44/44/4
ライセンス–Apache-2.0MITApache-2.0–MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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.