The Cartesia MCP connector routes your AI agent's tool calls to Cartesia's own MCP server through Scalekit. Each user connects their own Cartesia access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 19 tools.
- Tools
- 19
- What they doRead · write · destructive
- 9 · 7 · 39 read7 write3 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Cartesia MCP connection
In AgentKit > Connections, create a Cartesia MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Console steps with screenshots
Register your Cartesia API key with Scalekit so it can authenticate requests to the Cartesia MCP server on behalf of your users. Cartesia MCP uses API key authentication: the key is sent as a Bearer token.
-
Create a Cartesia API key
- Sign in to the Cartesia Playground and open the API Keys page.
- Create a new key and give it a descriptive name, such as
Scalekit. - Copy the key.
-
Create a connection in Scalekit
- In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
- Search for Cartesia MCP and click Create.
- Note the Connection name — use this as
connection_namein your code (for example,cartesiamcp).
-
Add a connected account
Connected accounts link a specific user identifier in your system to a Cartesia API key. Add one in the dashboard to test. In production, each user adds their own through the authorization link: they enter their credentials on the page it opens.
In the dashboard, to test
- Open the connection and click the Connected Accounts tab → Add account.
- Fill in Your User’s ID and API Key, then click Save.
From your backend, if your app already has the credentials
For example, when users enter them on a settings page in your app:
import { ConnectorStatus } from '@scalekit-sdk/node'const authorizationDetails = {details: {case: 'staticAuth',value: { details: { token: process.env.USER_API_KEY } },},};let { connectedAccount } = await scalekit.actions.upsertConnectedAccount({connectionName: 'cartesiamcp',identifier: 'user_123',authorizationDetails,});// Make sure the account is ACTIVE before the first tool call.if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {({ connectedAccount } = await scalekit.actions.upsertConnectedAccount({connectionName: 'cartesiamcp',identifier: 'user_123',authorizationDetails,}));}authorization_details = {"static_auth": {"token": user_api_key}}response = scalekit_client.actions.upsert_connected_account(connection_name="cartesiamcp",identifier="user_123",authorization_details=authorization_details,)# Make sure the account is ACTIVE before the first tool call.if response.connected_account.status != "ACTIVE":response = scalekit_client.actions.upsert_connected_account(connection_name="cartesiamcp",identifier="user_123",authorization_details=authorization_details,)
-
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'cartesiamcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Cartesia MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'cartesiamcp_list_accents',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "cartesiamcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Cartesia MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="cartesiamcp_list_accents",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Cartesia MCP server credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcartesiamcp_download_fileFetch a Cartesia cloud-stored file by ID.Read-onlyDownload file
Fetch a Cartesia cloud-stored file by ID. Returns a 24-hour `download_url` for hosted and remote clients. Also writes a copy to `OUTPUT_DIRECTORY` on the MCP server host (for local `uvx` or server-side `speech_to_text` in the same session). On hosted MCP those local copies are under a temp directory and purged after a TTL. Use the `file_id` from a prior `text_to_speech` call (`save=true`, the default) or from playground TTS history. Parameters ---------- file_id : str Cloud file ID (e.g. from `text_to_speech`). format : typing.Optional[DownloadFormat] Pass `playback` to wrap raw PCM as WAV in the download link and local file.
Inputs
file_idstringrequired- Cloud file ID (e.g. from `text_to_speech`).
formatstring- Pass `playback` to wrap raw PCM as WAV in the download link and local file.one of
playback
cartesiamcp_get_pronunciation_dictParameters ---------- dict_id : str Pronunciation dictionary ID.Read-onlyGet pronunciation dictionary
Parameters ---------- dict_id : str Pronunciation dictionary ID.
Inputs
dict_idstringrequired- Pronunciation dictionary ID.
cartesiamcp_get_voiceParameters ---------- voice_id : str The ID of the voice to get.Read-onlyGet voice
Parameters ---------- voice_id : str The ID of the voice to get. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
voice_idstringrequired- The ID of the voice to get.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_list_accentsList the official accent catalog from GET /accents.Read-onlyList accents
List the official accent catalog from GET /accents. Each entry includes the canonical accent `id` plus display metadata (`name`, `language`, `locale`, `is_locale_default`, `is_localizable`). Pass `id` to `clone_voice`, `add_voice_accents`, `delete_voice_accent`, and `localize_voice`. Display names are rejected on this API version. Parameters ---------- request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_list_agent_modelsList LLMs available for Managed Agents from GET /v1/agents/models.Read-onlyList agent models
List LLMs available for Managed Agents from GET /v1/agents/models. Use these `id` values for an agent's `model.id` (and explicit fallback model ids). Do not invent model ids. Each row includes provider, display name, latency, and token pricing. Returns the full catalog (pagination is followed server-side). Parameters ---------- request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_list_modelsList callable Sonic (TTS) and Ink (STT) model ids from GET /models.Read-onlyList models
List callable Sonic (TTS) and Ink (STT) model ids from GET /models. Each row has `id` and `capability` (`tts` or `stt`). TTS rows include `supported_languages`, the sorted synthesis language codes that model accepts. STT rows include `modes` (`stream` and/or `batch`). Pass `id` to `text_to_speech` as `model_id` or to `speech_to_text` as `model`. Omit model on those tools when you want the API default. Preview ids (`sonic-preview`, `ink-preview`) are included when callable. Parameters ---------- capability : typing.Optional[Literal["tts", "stt"]] Filter to TTS or STT. Omit to return both. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
capabilitystring- Filter to TTS or STT. Omit to return both.one of
ttsstt request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_list_pronunciation_dictsList pronunciation dictionaries for the authenticated user.Read-onlyList pronunciation dictionaries
List pronunciation dictionaries for the authenticated user. Parameters ---------- limit : typing.Optional[int] Number of dictionaries per page (1–100). starting_after : typing.Optional[str] Cursor: dictionary ID to start after. ending_before : typing.Optional[str] Cursor: dictionary ID to end before.
Inputs
ending_beforestring- Cursor: dictionary ID to end before.
limitinteger- Number of dictionaries per page (1–100).default
10 starting_afterstring- Cursor: dictionary ID to start after.
cartesiamcp_list_voicesParameters ---------- limit : typing.Optional[int] The number of Voices to return per page, ranging between 1 and 100.Read-onlyList voices
Parameters ---------- limit : typing.Optional[int] The number of Voices to return per page, ranging between 1 and 100. starting_after : typing.Optional[str] A cursor to use in pagination. `starting_after` is a Voice ID that defines your place in the list. For example, if you make a /voices request and receive 100 objects, ending with `voice_abc123`, your subsequent call can include `starting_after=voice_abc123` to fetch the next page of the list. ending_before : typing.Optional[str] A cursor to use in pagination. `ending_before` is a Voice ID that defines your place in the list. For example, if you make a /voices request and receive 100 objects, starting with `voice_abc123`, your subsequent call can include `ending_before=voice_abc123` to fetch the previous page of the list. is_owner : typing.Optional[bool] Whether to only return voices owned by the current user. is_starred : typing.Optional[bool] Whether to only return starred voices. gender : typing.Optional[GenderPresentation] The gender presentation of the voices to return. language : typing.Optional[str] Filter voices by language or locale, such as `en`, `it`, or `en_GB`. A locale returns accents for that region; a language alone returns all accents for that language. Both `-` and `_` separators are accepted. q : typing.Optional[str] Search voices by name, description, or voice ID. expand : typing.Optional[typing.Sequence[str]] Additional fields to include in the response, such as `preview_file_url`. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
ending_beforestring- A cursor to use in pagination. `ending_before` is a Voice ID that defines your place in the list. For example, if you make a /voices request and receive 100 objects, starting with `voice_abc123`, your subsequent call can include `ending_before=voice_abc123` to fetch the previous page of the list.
expandarray- Additional fields to include in the response, such as `preview_file_url`.
genderstring- The gender presentation of the voices to return.one of
masculinefemininegender_neutral is_ownerboolean- Whether to only return voices owned by the current user.
is_starredboolean- Whether to only return starred voices.
languagestring- Filter voices by language or locale, such as `en`, `it`, or `en_GB`. A locale returns accents for that region; a language alone returns all accents for that language. Both `-` and `_` separators are accepted.
limitinteger- The number of Voices to return per page, ranging between 1 and 100.default
10 qstring- Search voices by name, description, or voice ID.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
starting_afterstring- A cursor to use in pagination. `starting_after` is a Voice ID that defines your place in the list. For example, if you make a /voices request and receive 100 objects, ending with `voice_abc123`, your subsequent call can include `starting_after=voice_abc123` to fetch the next page of the list.
cartesiamcp_speech_to_textTranscribe a pre-recorded audio file to text.Read-onlyTranscribe audio
Transcribe a pre-recorded audio file to text. **Default (`mode="batch"`):** upload the file via batch STT (`POST /stt`). Best for typical MCP file-on-disk tasks (mp3, flac, wav, and other containers). Default model: `ink-whisper`. **Streaming (`mode="stream"`):** send mono PCM over STT WebSocket (`/stt/websocket`). Use for mono PCM WAV (for example TTS output) or raw PCM with `encoding` and `sample_rate`. Default model: `ink-2`. **Pricing:** See [STT pricing](https://docs.cartesia.ai/pricing#speech-to-text). Pass `file_id` or `file_path`, not both. On hosted MCP, pass the `file_id` from `text_to_speech` or `download_file`. Do not pass a path from the agent machine — `file_path` is an absolute path on this MCP server and must exist. A missing path on hosted MCP returns a validation error telling you to use `file_id`. Parameters ---------- file_path : typing.Optional[str] Absolute path on this MCP server. Must exist; hosted MCP rejects client laptop paths. mode : str `batch` (default) or `stream`. model : typing.Optional[str] STT model ID. Defaults to `ink-whisper` for batch and `ink-2` for stream. Call `list_models` with `capability="stt"` for valid ids. language : typing.Optional[str] ISO-639-1 language code (defaults to `en` for stream; batch uses API default). encoding : typing.Optional[SttEncoding] Required for raw PCM without a container header (both modes). sample_rate : typing.Optional[int] Sample rate in Hz when `encoding` is set. timestamp_granularities : typing.Optional[typing.Sequence[TimestampGranularity]] Pass `["word"]` for word-level timestamps when supported. file_id : typing.Optional[str] Cartesia cloud file id. The server downloads it. Use this from hosted clients. request_options : typing.Optional[RequestOptions] Request-specific configuration for batch mode (timeout, headers, query params, extra body fields, max_retries). Ignored in stream mode.
Inputs
encodingstring- Required for raw PCM without a container header (both modes).one of
pcm_s16lepcm_s32lepcm_f16lepcm_f32lepcm_mulawpcm_alaw file_idstring- Cartesia cloud file id. The server downloads it. Use this from hosted clients.
file_pathstring- Absolute path on this MCP server. Must exist; hosted MCP rejects client laptop paths.
languagestring- ISO-639-1 language code (defaults to `en` for stream; batch uses API default).
modestring- `batch` (default) or `stream`.one of
batchstreamdefaultbatch modelstring- STT model ID. Defaults to `ink-whisper` for batch and `ink-2` for stream. Call `list_models` with `capability="stt"` for valid ids.
request_optionsobject- Request-specific configuration for batch mode (timeout, headers, query params, extra body fields, max_retries). Ignored in stream mode.
sample_rateinteger- Sample rate in Hz when `encoding` is set.
timestamp_granularitiesarray- Pass `["word"]` for word-level timestamps when supported.
cartesiamcp_add_voice_accentsAdd accents to an instant voice clone you own so a single voice_id can speak multiple accents natively.WriteAdd voice accents
Add accents to an instant voice clone you own so a single voice_id can speak multiple accents natively. A voice can support up to 10 accents in total, including native. Parameters ---------- voice_id : str The ID of the voice. accents : list[VoiceAccent] Catalog accent ids from GET /accents (for example `british` or `parisian`). Display names are rejected on this API version. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
accentsarrayrequired- Catalog accent ids from GET /accents (for example `british` or `parisian`). Display names are rejected on this API version.
voice_idstringrequired- The ID of the voice.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_clone_voiceClone a voice from an audio clip.WriteClone voice
Clone a voice from an audio clip. This endpoint has two modes, stability and similarity. Similarity mode clones are more similar to the source clip, but may reproduce background noise. For these, use an audio clip about 5 seconds long. Stability mode clones are more stable, but may not sound as similar to the source clip. For these, use an audio clip 10-20 seconds long. Pass `file_id` or `file_path`, not both. On hosted MCP, pass the `file_id` from `text_to_speech` or `download_file`. `file_path` is an absolute path on this MCP server (local `uvx`, or a path returned in this same session). A path on the agent machine is not visible to hosted MCP and returns a validation error — use `file_id` instead. Parameters ---------- name : str The name of the voice. language : SupportedLanguage The language of the voice. mode : CloneMode Tradeoff between similarity and stability. Similarity clones sound more like the source clip, but may reproduce background noise. Stability clones always sound like a studio recording, but may not sound as similar to the source clip. file_path : typing.Optional[str] Absolute path on this MCP server. Must exist; hosted MCP rejects client laptop paths. file_id : typing.Optional[str] Cartesia cloud file id. The server downloads it. description : typing.Optional[str] A description for the voice. accent : typing.Optional[VoiceAccent] Catalog accent id from GET /accents (for example `southern-us` or `parisian`). Display names are rejected on this API version. Omit to leave unset. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
languagestringrequired- The language of the voice.
modestringrequired- Tradeoff between similarity and stability. Similarity clones sound more like the source clip, but may reproduce background noise. Stability clones always sound like a studio recording, but may not sound as similar to the source clip.
namestringrequired- The name of the voice.
accentstring- Catalog accent id from GET /accents (for example `southern-us` or `parisian`). Display names are rejected on this API version. Omit to leave unset.one of
abruzzo-italianafrican-americanafrican-frencharabicarabic-englishaustralianbaghelibelgian-frenchbrazilian-portuguesebritishbudapestbulgariancaliforniacambacampaniacanadian-englishcanadian-frenchcastiliancentral-tamilcentral-thaicentral-vietnamesechileancolombianczechdanisheuropean-portuguesefinnishgeneral-americanhigh-germanhindiindian-englishindian-urduirishisraeliistanbulitalianjakartajapanesejessorekhaleejikonkanikoreankyivmalaymandarinmanilamexicanmiddle-eastern-arabicmidwestern-americanmodern-standard-arabicmoldovannew-yorknew-zealandnorth-keralaodiaosloparisianparsiperuvianpolishpowadhirandstadromanianrussiansingaporeanslovaksouth-africansouthern-ussouthern-karnatakasouthern-vietnamesestandard-japanesestockholmswiss-standardtaiwanese-mandarintbilisitelanganaurduthessalonikizagreb descriptionstring- A description for the voice.
file_idstring- Cartesia cloud file id. The server downloads it.
file_pathstring- Absolute path on this MCP server. Must exist; hosted MCP rejects client laptop paths.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_create_pronunciation_dictCreate a pronunciation dictionary.WriteCreate pronunciation dictionary
Create a pronunciation dictionary. Parameters ---------- name : str items : typing.Optional[typing.Sequence[PronunciationDictItemParams]] Mappings of `text` to `pronunciation` (IPA or sounds-like). Optional `case_sensitive` (default false): when false, match every capitalization of `text` on Sonic 3.6.
Inputs
namestringrequired- Name of the pronunciation dictionary.
itemsarray- Mappings of `text` to `pronunciation` (IPA or sounds-like). Optional `case_sensitive` (default false): when false, match every capitalization of `text` on Sonic 3.6.
cartesiamcp_localize_voiceCreate a new voice from an existing voice localized to a new language and dialect.WriteLocalize voice
Create a new voice from an existing voice localized to a new language and dialect. Parameters ---------- voice_id : str The ID of the voice to localize. name : str The name of the new localized voice. description : str The description of the new localized voice. accent : VoiceAccent Catalog accent id from GET /accents (for example `mexican` or `parisian`). Display names are rejected on this API version. language : LocalizeTargetLanguage Target language to localize the voice to. Distinct from TTS SupportedLanguage. original_speaker_gender : Gender dialect : typing.Optional[LocalizeDialect] Dialect allowlist for English, Spanish, Portuguese, and French. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
accentstringrequired- Catalog accent id from GET /accents (for example `mexican` or `parisian`). Display names are rejected on this API version.one of
abruzzo-italianafrican-americanafrican-frencharabicarabic-englishaustralianbaghelibelgian-frenchbrazilian-portuguesebritishbudapestbulgariancaliforniacambacampaniacanadian-englishcanadian-frenchcastiliancentral-tamilcentral-thaicentral-vietnamesechileancolombianczechdanisheuropean-portuguesefinnishgeneral-americanhigh-germanhindiindian-englishindian-urduirishisraeliistanbulitalianjakartajapanesejessorekhaleejikonkanikoreankyivmalaymandarinmanilamexicanmiddle-eastern-arabicmidwestern-americanmodern-standard-arabicmoldovannew-yorknew-zealandnorth-keralaodiaosloparisianparsiperuvianpolishpowadhirandstadromanianrussiansingaporeanslovaksouth-africansouthern-ussouthern-karnatakasouthern-vietnamesestandard-japanesestockholmswiss-standardtaiwanese-mandarintbilisitelanganaurduthessalonikizagreb descriptionstringrequired- The description of the new localized voice.
languagestringrequired- Target language to localize the voice to. Distinct from TTS SupportedLanguage.one of
endeesfrjaptzhhiitkonlplrusvtrarhetateth namestringrequired- The name of the new localized voice.
original_speaker_genderstringrequired- Original speaker gender.one of
malefemale voice_idstringrequired- The ID of the voice to localize.
dialectstring- Dialect allowlist for English, Spanish, Portuguese, and French.one of
auinsoukusmxpebreuca request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_text_to_speechGenerate speech audio from text.WriteConvert text to speech
Generate speech audio from text. By default (`save=true`) the audio is persisted in Cartesia cloud storage and the response includes `file_id` and `download_url` (24-hour public link). Pass that `file_id` to `speech_to_text` or `clone_voice` — including from a hosted client whose disk is not this server. `download_url` is a browser link. On the local server, `file_path` is a copy under `OUTPUT_DIRECTORY` (or `output_path`). On hosted MCP with `save=true` (the default), `file_path` is omitted — use `file_id` / `download_url` instead. Parameters ---------- transcript : str voice_id : str Cartesia voice ID (e.g. from `list_voices`). output_format : OutputFormatParams model_id : str The ID of the model to use for the generation. Call `list_models` with `capability="tts"` for valid ids. language : typing.Optional[SupportedLanguage] duration : typing.Optional[float] The maximum duration of the audio in seconds. You do not usually need to specify this. If the duration is not appropriate for the length of the transcript, the output audio may be truncated. speed : typing.Optional[float] Speech speed multiplier (0.6–1.5). Applies to Sonic 3+ via `generation_config`. volume : typing.Optional[float] Volume multiplier (0.5–2.0). Applies to Sonic 3+ via `generation_config`. emotion : typing.Optional[str] Emotional guidance for the generation (e.g. `neutral`, `excited`, `sad`). Applies to Sonic 3+. pronunciation_dict_id : typing.Optional[str] Pronunciation dictionary ID to apply for this generation only. output_path : typing.Optional[str] Local file path to write the audio (for example `src/assets/audio/click.wav`). Relative paths resolve against the MCP server working directory. Only supported with the local server (stdio / uvx); rejected on hosted MCP. save : bool When true (default), persist the generation to cloud storage and return `file_id` plus `download_url`. Pass `download_file` with that `file_id` to refresh the link or write another local copy. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
output_formatstringrequired- Output audio format. One of a raw PCM, WAV, or MP3 container, each with its own required settings (encoding/bit rate and sample rate).
transcriptstringrequired- The text to convert to speech.
voice_idstringrequired- Cartesia voice ID (e.g. from `list_voices`).
durationnumber- The maximum duration of the audio in seconds. You do not usually need to specify this. If the duration is not appropriate for the length of the transcript, the output audio may be truncated.
emotionstring- Emotional guidance for the generation (e.g. `neutral`, `excited`, `sad`). Applies to Sonic 3+.
languagestring- Language code.
model_idstring- The ID of the model to use for the generation. Call `list_models` with `capability="tts"` for valid ids.default
sonic-3.5 output_pathstring- Local file path to write the audio (for example `src/assets/audio/click.wav`). Relative paths resolve against the MCP server working directory. Only supported with the local server (stdio / uvx); rejected on hosted MCP.
pronunciation_dict_idstring- Pronunciation dictionary ID to apply for this generation only.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
saveboolean- When true (default), persist the generation to cloud storage and return `file_id` plus `download_url`. Pass `download_file` with that `file_id` to refresh the link or write another local copy.default
true speednumber- Speech speed multiplier (0.6–1.5). Applies to Sonic 3+ via `generation_config`.
volumenumber- Volume multiplier (0.5–2.0). Applies to Sonic 3+ via `generation_config`.
cartesiamcp_update_pronunciation_dictUpdate a pronunciation dictionary.WriteUpdate pronunciation dictionary
Update a pronunciation dictionary. Parameters ---------- dict_id : str name : typing.Optional[str] items : typing.Optional[typing.Sequence[PronunciationDictItemParams]] Optional `case_sensitive` (default false) on each item.
Inputs
dict_idstringrequired- ID of the pronunciation dictionary to update.
itemsarray- Pronunciation items (text to pronunciation mappings). Optional `case_sensitive` (default false) on each item.
namestring- New name for the pronunciation dictionary.
cartesiamcp_update_voiceParameters ---------- id : VoiceId name : str The name of the voice.WriteUpdate voice
Parameters ---------- id : VoiceId name : str The name of the voice. description : str The description of the voice. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
descriptionstringrequired- The description of the voice.
namestringrequired- The name of the voice.
voice_idstringrequired- The ID of the voice to update.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_delete_pronunciation_dictParameters ---------- dict_id : str Pronunciation dictionary ID to delete.DestructiveDelete pronunciation dictionary
Parameters ---------- dict_id : str Pronunciation dictionary ID to delete.
Inputs
dict_idstringrequired- Pronunciation dictionary ID to delete.
cartesiamcp_delete_voiceParameters ---------- voice_id : str The ID of the voice to delete.DestructiveDelete voice
Parameters ---------- voice_id : str The ID of the voice to delete. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
voice_idstringrequired- The ID of the voice to delete.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
cartesiamcp_delete_voice_accentRemove an accent an instant voice clone supports.DestructiveDelete voice accent
Remove an accent an instant voice clone supports. Parameters ---------- voice_id : str The ID of the voice. accent : VoiceAccent Catalog accent id from GET /accents (for example `british` or `parisian`). Display names are rejected on this API version. request_options : typing.Optional[RequestOptions] Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
Inputs
accentstringrequired- Catalog accent id from GET /accents (for example `british` or `parisian`). Display names are rejected on this API version.one of
abruzzo-italianafrican-americanafrican-frencharabicarabic-englishaustralianbaghelibelgian-frenchbrazilian-portuguesebritishbudapestbulgariancaliforniacambacampaniacanadian-englishcanadian-frenchcastiliancentral-tamilcentral-thaicentral-vietnamesechileancolombianczechdanisheuropean-portuguesefinnishgeneral-americanhigh-germanhindiindian-englishindian-urduirishisraeliistanbulitalianjakartajapanesejessorekhaleejikonkanikoreankyivmalaymandarinmanilamexicanmiddle-eastern-arabicmidwestern-americanmodern-standard-arabicmoldovannew-yorknew-zealandnorth-keralaodiaosloparisianparsiperuvianpolishpowadhirandstadromanianrussiansingaporeanslovaksouth-africansouthern-ussouthern-karnatakasouthern-vietnamesestandard-japanesestockholmswiss-standardtaiwanese-mandarintbilisitelanganaurduthessalonikizagreb voice_idstringrequired- The ID of the voice.
request_optionsobject- Request-specific configuration (timeout, headers, query params, extra body fields, max_retries).
No tools match.