Cartesia¶

The Cartesia MCP Server connects your ADK agent to the Cartesia AI audio platform. This integration gives your agent the ability to generate speech, localize voices across languages, and create audio content using natural language.

Use cases¶

Text-to-Speech Generation: Convert text into natural-sounding speech using Cartesia's diverse voice library, with control over voice selection and output format.
Voice Localization: Transform existing voices into different languages while preserving the original speaker's characteristics—ideal for multilingual content creation.
Audio Infill: Fill gaps between audio segments to create smooth transitions, useful for podcast editing or audiobook production.
Voice Transformation: Convert audio clips to sound like different voices from Cartesia's library.

Prerequisites¶

Sign up for a Cartesia account
Generate an API key from the Cartesia playground

Use with agent¶

Local MCP Server

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

CARTESIA_API_KEY = "YOUR_CARTESIA_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="cartesia_agent",
    instruction="Help users generate speech and work with audio content",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="uvx",
                    args=["cartesia-mcp"],
                    env={
                        "CARTESIA_API_KEY": CARTESIA_API_KEY,
                        # "OUTPUT_DIRECTORY": "/path/to/output",  # Optional
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

Available tools¶

Tool	Description
`text_to_speech`	Convert text to audio using a specified voice
`list_voices`	List all available Cartesia voices
`get_voice`	Get details about a specific voice
`clone_voice`	Clone a voice from audio samples
`update_voice`	Update an existing voice
`delete_voice`	Delete a voice from your library
`localize_voice`	Transform a voice into a different language
`voice_change`	Convert an audio file to use a different voice
`infill`	Fill gaps between audio segments

Configuration¶

The Cartesia MCP server can be configured using environment variables:

Variable	Description	Required
`CARTESIA_API_KEY`	Your Cartesia API key	Yes
`OUTPUT_DIRECTORY`	Directory to store generated audio files	No