← Back to all apps

Overview

Tools Available28
DeveloperRetell AI, Inc
CategoryBusiness

Build and deploy voice agents

Available Tools

Retell AI provides 28 tools that can be used to interact with its services.

Check agent deployment status

check_agent_deployment_status
Full Description

Check if an agent is deployed to any phone numbers. Returns the agent's inbound and outbound phone number assignments, and whether the agent is currently active for receiving or making calls

Parameters

Required
agentIdstring

The ID of the agent

Check Bearer Token

check_bearer_token
Full Description

Check if the current user session has a valid authentication token stored.

Check Selected Workspace

check_selected_workspace
Full Description

Check if a workspace has been selected by the user

Create Agent

create_agent
Full Description

Create a Retell AI agent with configuration

Parameters

Required
agentNamestring

Name of the agent

promptstring

Agent prompt

voiceIdstring

Voice ID for the agent

Optional
calComboolean

Enable Cal.com integration

calComApiKeystring

Cal.com API key

calComDescriptionstring

Cal.com appointment description

calComEventTypeIdstring

Cal.com event type ID

calComTimezonestring

Cal.com timezone

endCallboolean

Enable end call

endCallMaxDurationnumber

Max call duration in seconds

endCallSilenceTimeoutnumber

Silence timeout in seconds

endCallWhenToEndstring

When to end the call

transferCallboolean

Enable transfer call

transferCallHoldMusicstring

Hold music URL

transferCallHumanDetectionboolean

Enable human detection

transferCallNumberstring

Transfer destination number

transferCallTypestring

Transfer type

Options:cold_transferwarm_transfer
transferCallWhenToTransferstring

When to transfer the call

transferCallWhisperMessagestring

Whisper message for transfer

voicemailActionstring

Voicemail action

Options:hangupleaveMessage
voicemailMessagestring

Voicemail message

Deploy Agent

deploy_agent
Full Description

Deploy a voice agent

Parameters

Required
agentIdstring
Optional
inboundPhoneNumberstring
outboundPhoneNumberstring
phoneNumberstring

Edit Agent's Basic Information

edit_agent_basic_info
Full Description

Edit an agent's name and/or language. Ask the user which agent they want to edit and what changes they'd like to make. Gather the agent ID and at least one of: new name or new language. Invoke this tool whenever the user wants to change the agent's language and/or name.

Parameters

Required
agentIdstring

The agent's record id.

Optional
agentLanguagestring

The agent's new language code (e.g., 'en-US' for English, 'multi' for multilingual). Use 'multi' when the user requests multilingual or multiple language support.

agentNamestring

The agent's new name.

Edit Cal.com's Integration

edit_agent_calcom_function
Full Description

Edit an agent's Cal.com integration which allows the user to book calendar events. Ask the user which agent they want to edit and what changes they'd like to make. Gather the agent ID, the Cal.com API Key, the event type ID, the timezone, and the description (optional).

Parameters

Required
agentIdstring

The agent's record id.

calComApiKeystring

Stored securely, never shared. Get this from Cal.com Settings → Developer → API Keys

calComEventTypeIdstring

Find this in your Cal.com event URL (e.g., https://app.cal.com/you/event/1427703 → ID is 1427703)

calComTimezonestring

Timezone for availability and booking

Optional
calComDescriptionstring

Additional information or instructions for booking.

shouldEnableboolean

Determines whether the user specifically wants to enable/disable this integration. This should be inferred from the user's instructions. Eg. if they want to update or edit this integration then they surely want it enabled. Eg. If they say they want to disable or turn it off, then shouldEnable should be false.

Default: True

Edit Agent's End Call Function

edit_agent_end_call_function
Full Description

Edit an agent's end_call function. Ask the user which agent they want to edit and what changes they'd like to make. Gather the agent ID and the description/condition for when to end the call.

Parameters

Required
agentIdstring

The agent's record id.

descriptionstring

The description for conditions on when to end the call.

Edit Agent's Transfer Call Function

edit_agent_transfer_call_function
Full Description

Edit an agent's transfer_call function. Ask the user which agent they want to edit and what changes they'd like to make. Gather the agent ID, the condition for transferring the call, the phone number to transfer the call to, and the transfer type cold/warm.

Parameters

Required
agentIdstring

The agent's record id.

destinationstring

The number you own in E.164 format. Eg. +14157774444

whenToTransferstring

The condition that should trigger the call transfer.

Optional
shouldEnableboolean

Determines whether the user specifically wants to enable/disable this function. This should be inferred from the user's instructions. Eg. if they want to update or edit this function then they surely want it enabled. Eg. If they say they want to disable or turn it off, then shouldEnable should be false.

Default: True
typestring

The type of the transfer. Possible values: warm_transfer, cold_transfer

Options:cold_transferwarm_transfer
Default: cold_transfer
warmTransferHumanDetectionboolean

Determine whether to wait for human to answer before connecting

Default: False
warmTransferMessagestring

Private message spoken only to the human agent before connecting

Edit Agent's Voice

edit_agent_voice
Full Description

Update the agent's voice.

Parameters

Required
agentIdstring

The agent's record id

voiceIdstring

Generate Prompt

generate_prompt
Full Description

Generate agent prompt from configuration

Parameters

Required
agentNamestring

Name of the agent

descriptionstring

Description of the agent

languagestring

Language of the agent

stylestring

Style of the agent

targetAudiencestring

Target audience for the agent

tonestring

Tone of the agent

useCasesstring

Use cases for the agent

Chat Completion

get_chat_completion
Full Description

Send a message to the agent in the playground for testing

Parameters

Required
agentIdstring

The agent ID to chat with

Optional
transcriptarray

The conversation transcript

Get Phone Numbers

get_phone_numbers
Full Description

Get available phone numbers for the session

Get user's Retell workspaces

get_workspaces
Full Description

List the user's workspaces from Retell

Initiate Phone Call

initiate_call
Full Description

Start a phone call with the agent for testing

Parameters

Required
agentIdstring

The agent ID

fromPhoneNumberstring

The phone number to call from

toPhoneNumberstring

The phone number to call to

List Agents

list_agents
Full Description

Get list of all agents in the workspace

List Available Agent Voices

list_available_agent_voices
Full Description

Show all available voices for the agent. User can browse and preview voices before selecting one. After showing this, tell the user: 'Here are the available voices. Feel free to preview and listen to them, then let me know which voice you'd like to use for your agent.'

Parameters

Required
agentIdstring

The agent's record id

Preview Prompt Edit

preview_agent_prompt_edit
Full Description

Generate a preview of modified prompt based on user's change description. Shows diff between original and modified prompt. User can then review and decide to apply or refine further.

Parameters

Required
agentIdstring

The agent's record id

changeDescriptionstring

Description of how to modify the prompt (e.g., 'make it more formal', 'add handling for complaints')

Refine Prompt

refine_prompt
Full Description

Refine agent prompt based on change description (internal widget use)

Parameters

Required
agentIdstring

The agent's record id

changeDescriptionstring

Description of the change to make

currentPromptstring

The current prompt text

Save Bearer Token

save_bearer_token
Full Description

Save bearer token for agent testing

Parameters

Required
bearerTokenstring

The bearer token

Save Selected Workspace

save_selected_workspace
Full Description

Save selected workspace

Parameters

Required
selectedWorkspaceobject

The selected workspace

Send Dashboard Link

send_dashboard_link
Full Description

Returns an email containing a link to the Retell AI dashboard phone numbers page.

Parameters

Required
emailstring

Open Agent Creation Widget

show_agent_creation_widget
Full Description

Use this widget when the user asks to create or build an agent. Before calling this tool, ask the user for all required fields (name, description, use cases, audience, tone, style, language), using sensible defaults for optional fields.

When calling or re-calling this tool, ALWAYS include all previously collected values along with any newly updated field. Treat prior widget state as the source of truth and re-emit it in the tool input.

If the user asks to edit a specific field, show this widget again with the updated value merged into the previous inputs.

Parameters

Required
agentNamestring

The name of the agent

descriptionstring

The description of the agent

languagestring

The language code for the agent (e.g., 'en-US' for English, 'multi' for multilingual support). Use 'multi' when the user requests multilingual or multiple language support.

stylestring

The style of the agent

Options:conversationalconcisedetailedtechnicalsimple
targetAudiencestring

The target audience of the agent

tonestring

The tone of the agent

Options:professionalfriendlycasualformalempatheticenthusiastic
useCasesstring

The use cases of the agent

Optional
calComobject

Cal.com configuration. Set shouldEnable=false to disable. Leave entire object null to let user configure in widget.

endCallobject

End call configuration. Leave null to let user configure in widget.

navigateTostring

Navigate to a specific step. Default to 'summary' for first-time agent creation. Use 'summary' for agent name/description/tone/style. Use 'voice' for voice selection. Use 'additional-functions' to enable/disable features. Use 'transfer-call-config' for transfer call settings. Use 'end-call-config' for end call/voicemail settings. Use 'calcom-config' for Cal.com booking settings. Use 'prompt-generation' for prompt editing. Use 'create-agent' for final creation.

Options:summaryvoiceadditional-functionstransfer-call-configend-call-configcalcom-configprompt-generationcreate-agent
Default: summary
promptstring

The agent's system prompt. Leave null to generate in widget.

transferCallobject

Transfer call configuration. Set shouldEnable=false to disable. Leave entire object null to let user configure in widget.

voiceIdstring

The voice for the agent. This can be left null to let user select in widget.

Deploy Agent

show_deploy_agent
Full Description

Invoke this tool to deploy an agent to a phone number. The agent must already be created. This tool will show a widget where the user can select a phone number and deploy their agent.

Parameters

Required
agentIdstring

The ID of the agent to deploy

Optional
agentNamestring

The display name of the agent

List Agents

show_list_agents
Full Description

Display all agents in the current workspace. Shows agent details including names, IDs, voices, and languages.

Test Agent

show_test_agent
Full Description

Use this tool to interactively test and evaluate a Retell AI voice agent. It provides a built-in chat interface for real-time text conversations with the agent, as well as the ability to initiate test phone calls to validate voice behavior, conversation flow, and agent responses. This tool is intended for debugging, quality assurance, and behavior validation of Retell AI agents. The user would usually want to test an agent after they have created or deployed one.

Parameters

Optional
agentIdstring

The agent ID to test

Modify selected workspace

show_workspaces_select
Full Description

Display a select input of the user's RetellAI workspaces to allow for modification of selected workspace. Only show when user asked to modify the selected workspace.

Update Agent Prompt

update_agent_prompt
Full Description

Update agent prompt in Retell and database (internal widget use)

Parameters

Required
agentIdstring

The agent's record id

promptstring

The new prompt text