impeccable
impeccable เป็นชุดคำสั่งด้านการออกแบบสำหรับ coding agent ใช้กำกับงานให้ดูประณีตหรือโดดเด่นขึ้น ตรวจทานและวิจารณ์งานออกแบบ และช่วยจับงานที่ดูเป็น AI ชั้นต่ำก่อนนำไปใช้จริง
Cartesia เป็นบริการ voice AI ที่ช่วยแปลงข้อความเป็นเสียงพูด (text-to-speech) แปลงเสียงเป็นข้อความ (speech-to-text) โคลนเสียง และจัดการเสียงต่าง ๆ
แปลอัตโนมัติจากคำอธิบายของผู้ทำ · ทีมยังไม่ได้ตรวจ
Cartesia voice AI: text-to-speech, speech-to-text, voice cloning, and voice management.Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
impeccable เป็นชุดคำสั่งด้านการออกแบบสำหรับ coding agent ใช้กำกับงานให้ดูประณีตหรือโดดเด่นขึ้น ตรวจทานและวิจารณ์งานออกแบบ และช่วยจับงานที่ดูเป็น AI ชั้นต่ำก่อนนำไปใช้จริง
เครื่องมือสำหรับออกแบบไดอะแกรมแบบ editorial ใช้กับ Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder และ Pi มี 45 ประเภทไดอะแกรม สร้างผลลัพธ์เป็น HTML กับ SVG ที่ใช้งานได้ในไฟล์เดียว
เครื่องมือเสริมชื่อ frontend-slides ใช้สร้างสไลด์สวยงามบนเว็บ โดยอาศัยทักษะด้าน frontend ของ coding agent
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 22/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 42/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 4/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง Cartesia ให้หน่อย ทำตาม https://mcp.popnx.com/i/cartesia-ai-cartesia-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 4/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (mcp.cartesia.ai) · ✓ ตรวจคำสั่งแล้ว 19 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
CustomizeConnectors
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Cartesiahttps://mcp.cartesia.ai/mcpกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
+ConnectorsCartesia
ใช้ Cartesia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ Cartesia หรือมีชื่อเครื่องมือของ Cartesia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
Plugins+Add custom MCP server
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
Cartesiahttps://mcp.cartesia.ai/mcpเปิดแชตใหม่แล้วเลือก Cartesia จากรายการปลั๊กอินก่อนพิมพ์
ใช้ Cartesia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ Cartesia หรือมีชื่อเครื่องมือของ Cartesia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --transport http --scope user cartesia https://mcp.cartesia.ai/mcpต้องเห็น Cartesia ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ Cartesia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ Cartesia หรือมีชื่อเครื่องมือของ Cartesia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ Cartesia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ Cartesia หรือมีชื่อเครื่องมือของ Cartesia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ Cartesia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ Cartesia หรือมีชื่อเครื่องมือของ Cartesia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://mcp.cartesia.ai/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
Claude Code
claude mcp add --transport http --scope user cartesia https://mcp.cartesia.ai/mcpCursor (~/.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='ใส่ค่าของคุณ' -- uvx cartesia-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"cartesia": {
"command": "uvx",
"args": [
"cartesia-mcp"
],
"env": {
"CARTESIA_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"cartesia": {
"command": "uvx",
"args": [
"cartesia-mcp"
],
"env": {
"CARTESIA_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"cartesia": {
"type": "stdio",
"command": "uvx",
"args": [
"cartesia-mcp"
],
"env": {
"CARTESIA_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}CARTESIA_API_KEY ความลับ จำเป็น envCARTESIA_ADMIN_API_KEY ความลับ envOUTPUT_DIRECTORY envคำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
pypi: cartesia-mcpดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
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
server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub cartesia-ai ซึ่งเป็นเจ้าของ repo
มีการแก้โค้ดล่าสุด เมื่อวาน
ไม่พบไฟล์ license ใน repo
ตอบกลับใน 291 ms (HTTP 401)
ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
ที่อยู่บนคลาวด์ตอบได้ 5 จาก 5 ครั้งล่าสุด · ล่าสุด 291 ms · ตรวจเมื่อ 19 พ.ย. 2569
ยังไม่ได้ตรวจ
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/cartesia-ai-cartesia-mcp)ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 4 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: CARTESIA_API_KEY
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวาน และส่งรุ่นล่าสุด (1.0.0) เข้า registry เมื่อวาน
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
ในหมวดเดียวกันมี HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
สร้าง ตรวจ และบันทึกฉากอาคาร 3 มิติที่แก้ไขได้ ด้วย Pascal
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
server ทางการของ Figma ส่งข้อมูลงานออกแบบให้ AI อ่าน เพื่อเปลี่ยนแบบเป็นโค้ดหรืออธิบายแบบได้ตรงขึ้น ต่อผ่านคลาวด์ของ Figma
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| ตัวนี้ Cartesia | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ใช่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 4/5 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| สัญญาอนุญาต | – | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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
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" } } }
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": " " } } } }
Ask your agent things like:
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.
| Tool | Description | |
|---|---|---|
text_to_speech | Convert 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_text | Transcribe audio from file_id or a server file_path (mode=batch default, or mode=stream) | |
list_voices | List available voices (filter by language, search, gender, etc.) | |
get_voice | Fetch metadata for a voice by ID | |
clone_voice | Clone a voice from file_id or a server file_path | |
update_voice | Update a cloned voice's name or description | |
delete_voice | Delete a cloned voice | |
localize_voice | Adapt a voice to another language or dialect | |
list_accents | List catalog accent IDs and metadata (british, standard-japanese, …) | |
list_models | List callable Sonic (TTS) and Ink (STT) model ids (`capability=tts | stt`) |
list_agent_models | List Managed Agents LLM ids from GET /v1/agents/models (full catalog) | |
add_voice_accents | Add catalog accents to an instant voice clone (british, parisian, …) | |
delete_voice_accent | Remove a catalog accent from an instant voice clone | |
list_pronunciation_dicts | List pronunciation dictionaries | |
create_pronunciation_dict | Create a pronunciation dictionary | |
get_pronunciation_dict | Get a pronunciation dictionary by ID | |
update_pronunciation_dict | Update a pronunciation dictionary | |
delete_pronunciation_dict | Delete a pronunciation dictionary | |
download_file | Fetch a cloud file by ID (download_url + local copy) | |
get_credit_usage | Credit usage over time (CARTESIA_ADMIN_API_KEY) |
See cartesia_mcp/server.py for parameters and return types.
| Prompt | Description |
|---|---|
generate_and_transcribe | Synthesize text with a voice, then transcribe it back to verify |
clone_and_localize | Clone a voice from a file_id, then localize it to another language |
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.
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.
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.
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).
file_id or file_path)speech_to_text and clone_voice take one of:
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.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.
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 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 MCP (mcp.cartesia.ai) accepts Dynamic Client Registration with a restricted redirect-URI policy:
cursor://…, vscode://…http://localhost|127.0.0.1|::1 (any port/path)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.
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.