Content
Tool List
text_to_speech
Description: Convert text to speech with a given voice. Uploads file to server and returns accessible URL. Only one of voice_id or voice_name can be provided. If none are provided, the default voice will be used. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: text (str): The text to convert to speech. voice_name (str, optional): The name of the voice to use. model_id (str, optional): The model ID to use for speech synthesis. Options include: - eleven_multilingual_v2: High quality multilingual model (29 languages) - eleven_flash_v2_5: Fastest model with ultra-low latency (32 languages) - eleven_turbo_v2_5: Balanced quality and speed (32 languages) - eleven_flash_v2: Fast English-only model - eleven_turbo_v2: Balanced English-only model - eleven_monolingual_v1: Legacy English model Defaults to eleven_multilingual_v2 or environment variable ELEVENLABS_MODEL_ID. stability (float, optional): Stability of the generated audio. Determines how stable the voice is and the randomness between each generation. Lower values introduce broader emotional range for the voice. Higher values can result in a monotonous voice with limited emotion. Range is 0 to 1. similarity_boost (float, optional): Similarity boost of the generated audio. Determines how closely the AI should adhere to the original voice when attempting to replicate it. Range is 0 to 1. style (float, optional): Style of the generated audio. Determines the style exaggeration of the voice. This setting attempts to amplify the style of the original speaker. It does consume additional computational resources and might increase latency if set to anything other than 0. Range is 0 to 1. use_speaker_boost (bool, optional): Use speaker boost of the generated audio. This setting boosts the similarity to the original speaker. Using this setting requires a slightly higher computational load, which in turn increases latency. speed (float, optional): Speed of the generated audio. Controls the speed of the generated speech. Values range from 0.7 to 1.2, with 1.0 being the default speed. Lower values create slower, more deliberate speech while higher values produce faster-paced speech. Extreme values can impact the quality of the generated speech. Range is 0.7 to 1.2. output_directory (str, optional): Directory where files should be saved (only used when saving files). Defaults to $HOME/Desktop if not provided. language: ISO 639-1 language code for the voice. output_format (str, optional): Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs. Defaults to "mp3_44100_128". Must be one of: mp3_22050_32 mp3_44100_32 mp3_44100_64 mp3_44100_96 mp3_44100_128 mp3_44100_192 pcm_8000 pcm_16000 pcm_22050 pcm_24000 pcm_44100 ulaw_8000 alaw_8000 opus_48000_32 opus_48000_64 opus_48000_96 opus_48000_128 opus_48000_192 Returns: Text content with file path or MCP resource with audio data, depending on output mode.
Parameters
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
speech_to_text
Description: Transcribe speech from an audio file. By default, returns the transcription text directly. When save_transcript_to_file=True: Uploads file to server and returns accessible URL. When return_transcript_to_client_directly=True (default), always returns text directly regardless of output mode. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: input_file_url: URL of the audio file to transcribe. The file will be downloaded to a temporary location. language_code: ISO 639-3 language code for transcription. If not provided, the language will be detected automatically. diarize: Whether to diarize the audio file. If True, which speaker is currently speaking will be annotated in the transcription. save_transcript_to_file: Whether to save the transcript to a file. Defaults to False (only return text). return_transcript_to_client_directly: Whether to return the transcript to the client directly. Defaults to True. output_directory: Directory where files should be saved (only used when save_transcript_to_file=True). Defaults to $HOME/Desktop if not provided. Returns: TextContent containing the transcription text directly (default), or MCP resource with transcript file when save_transcript_to_file=True.
Parameters
No description
No description
No description
No description
No description
No description
text_to_sound_effects
Description: Convert text description of a sound effect to sound effect with a given duration. Uploads file to server and returns accessible URL. Duration must be between 0.5 and 5 seconds. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: text: Text description of the sound effect duration_seconds: Duration of the sound effect in seconds output_directory: Directory where files should be saved (only used when saving files). Defaults to $HOME/Desktop if not provided. loop: Whether to loop the sound effect. Defaults to False. output_format (str, optional): Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs. Defaults to "mp3_44100_128". Must be one of: mp3_22050_32 mp3_44100_32 mp3_44100_64 mp3_44100_96 mp3_44100_128 mp3_44100_192 pcm_8000 pcm_16000 pcm_22050 pcm_24000 pcm_44100 ulaw_8000 alaw_8000 opus_48000_32 opus_48000_64 opus_48000_96 opus_48000_128 opus_48000_192
Parameters
No description
No description
No description
No description
No description
search_voices
Description: Search for existing voices, a voice that has already been added to the user's ElevenLabs voice library. Searches in name, description, labels and category. Args: search: Search term to filter voices by. Searches in name, description, labels and category. sort: Which field to sort by. `created_at_unix` might not be available for older voices. sort_direction: Sort order, either ascending or descending. Returns: List of voices that match the search criteria.
Parameters
No description
No description
No description
list_models
Description: List all available models
get_voice
Description: Get details of a specific voice
Parameters
No description
voice_clone
Description: Create an instant voice clone of a voice using provided audio files from URLs. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: name: Name for the cloned voice. file_urls: List of URLs to audio files for voice cloning. The files will be downloaded to a temporary location. description: Optional description for the cloned voice.
Parameters
No description
No description
No description
isolate_audio
Description: Isolate audio from a file. Uploads file to server and returns accessible URL. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: input_file_url: URL of the audio file to isolate. The file will be downloaded to a temporary location. output_directory: Directory where files should be saved (only used when saving files). Defaults to $HOME/Desktop if not provided.
Parameters
No description
No description
check_subscription
Description: Check the current subscription status. Could be used to measure the usage of the API.
create_agent
Description: Create a conversational AI agent with custom configuration. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: name: Name of the agent first_message: First message the agent will say i.e. "Hi, how can I help you today?" system_prompt: System prompt for the agent voice_id: ID of the voice to use for the agent language: ISO 639-1 language code for the agent llm: LLM to use for the agent temperature: Temperature for the agent. The lower the temperature, the more deterministic the agent's responses will be. Range is 0 to 1. max_tokens: Maximum number of tokens to generate. asr_quality: Quality of the ASR. `high` or `low`. model_id: ID of the ElevenLabs model to use for the agent. optimize_streaming_latency: Optimize streaming latency. Range is 0 to 4. stability: Stability for the agent. Range is 0 to 1. similarity_boost: Similarity boost for the agent. Range is 0 to 1. turn_timeout: Timeout for the agent to respond in seconds. Defaults to 7 seconds. max_duration_seconds: Maximum duration of a conversation in seconds. Defaults to 600 seconds (10 minutes). record_voice: Whether to record the agent's voice. retention_days: Number of days to retain the agent's data.
Parameters
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
No description
add_knowledge_base_to_agent
Description: Add a knowledge base to ElevenLabs workspace. Allowed types are epub, pdf, docx, txt, html. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: agent_id: ID of the agent to add the knowledge base to. knowledge_base_name: Name of the knowledge base. url: URL of a web page to add to the knowledge base. input_file_url: URL of a document file (pdf, docx, txt, html, epub) to add to the knowledge base. The file will be downloaded to a temporary location. text: Text content to add to the knowledge base. Note: Must provide exactly one of: url, input_file_url, or text.
Parameters
No description
No description
No description
No description
No description
list_agents
Description: List all available conversational AI agents
get_agent
Description: Get details about a specific conversational AI agent
Parameters
No description
get_conversation
Description: Gets conversation with transcript. Returns: conversation details and full transcript. Use when: analyzing completed agent conversations. Args: conversation_id: The unique identifier of the conversation to retrieve, you can get the ids from the list_conversations tool.
Parameters
No description
list_conversations
Description: Lists agent conversations. Returns: conversation list with metadata. Use when: asked about conversation history. Args: agent_id (str, optional): Filter conversations by specific agent ID cursor (str, optional): Pagination cursor for retrieving next page of results call_start_before_unix (int, optional): Filter conversations that started before this Unix timestamp call_start_after_unix (int, optional): Filter conversations that started after this Unix timestamp page_size (int, optional): Number of conversations to return per page (1-100, defaults to 30) max_length (int, optional): Maximum character length of the response text (defaults to 10000)
Parameters
No description
No description
No description
No description
No description
No description
speech_to_speech
Description: Transform audio from one voice to another using provided audio files. Uploads file to server and returns accessible URL. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: input_file_url: URL of the audio file to transform. The file will be downloaded to a temporary location. voice_name: Name of the target voice to use for transformation. Defaults to "Adam". output_directory: Directory where files should be saved (only used when saving files). Defaults to $HOME/Desktop if not provided.
Parameters
No description
No description
No description
text_to_voice
Description: Create voice previews from a text prompt. Creates three previews with slight variations. Uploads file to server and returns accessible URL. If no text is provided, the tool will auto-generate text. Voice preview files are saved as: voice_design_(generated_voice_id)_(timestamp).mp3 Example file name: voice_design_Ya2J5uIa5Pq14DNPsbC1_20250403_164949.mp3 ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
Parameters
No description
No description
No description
create_voice_from_preview
Description: Add a generated voice to the voice library. Uses the voice ID from the `text_to_voice` tool. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
Parameters
No description
No description
No description
make_outbound_call
Description: Make an outbound call using an ElevenLabs agent. Automatically detects provider type (Twilio or SIP trunk) and uses the appropriate API. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: agent_id: The ID of the agent that will handle the call agent_phone_number_id: The ID of the phone number to use for the call to_number: The phone number to call (E.164 format: +1xxxxxxxxxx) Returns: TextContent containing information about the call
Parameters
No description
No description
No description
search_voice_library
Description: Search for a voice across the entire ElevenLabs voice library. Args: page: Page number to return (0-indexed) page_size: Number of voices to return per page (1-100) search: Search term to filter voices by Returns: TextContent containing information about the shared voices
Parameters
No description
No description
No description
list_phone_numbers
Description: List all phone numbers associated with the ElevenLabs account
compose_music
Description: Convert a prompt to music and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Args: prompt: Prompt to convert to music. Must provide either prompt or composition_plan. output_directory: Directory to save the output audio file composition_plan: Composition plan to use for the music. Must provide either prompt or composition_plan. music_length_ms: Length of the generated music in milliseconds. Cannot be used if composition_plan is provided. ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
Parameters
No description
No description
No description
No description
create_composition_plan
Description: Create a composition plan for music generation. Usage of this endpoint does not cost any credits but is subject to rate limiting depending on your tier. Composition plans can be used when generating music with the compose_music tool. Args: prompt: Prompt to create a composition plan for music_length_ms: The length of the composition plan to generate in milliseconds. Must be between 10000ms and 300000ms. Optional - if not provided, the model will choose a length based on the prompt. source_composition_plan: An optional composition plan to use as a source for the new composition plan
Parameters
No description
No description
No description