Cartesia MCP tool for ADK

Supported in ADKPythonTypeScript

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

=== "Python"

=== "Local MCP Server"

    ```python
    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-flash-latest",
        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,
                ),
            )
        ],
    )
    ```

=== "TypeScript"

=== "Local MCP Server"

    ```typescript
    import { LlmAgent, MCPToolset } from "@google/adk";

    const CARTESIA_API_KEY = "YOUR_CARTESIA_API_KEY";

    const rootAgent = new LlmAgent({
        model: "gemini-flash-latest",
        name: "cartesia_agent",
        instruction: "Help users generate speech and work with audio content",
        tools: [
            new MCPToolset({
                type: "StdioConnectionParams",
                serverParams: {
                    command: "uvx",
                    args: ["cartesia-mcp"],
                    env: {
                        CARTESIA_API_KEY: CARTESIA_API_KEY,
                        // OUTPUT_DIRECTORY: "/path/to/output",  // Optional
                    },
                },
            }),
        ],
    });

    export { rootAgent };
    ```

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

4.5 KiB Raw Permalink Blame History