delete_phone_number
Delete Phone Number
Delete a phone number from your Retell AI account. This action is irreversible.
Ask your agent in plain language. Each of these maps to a real tool on the server.
delete_phone_number
Delete a phone number from your Retell AI account. This action is irreversible.
get_agent
Retrieve detailed configuration of a specific voice agent by its ID, including voice settings, response engine, language, webhook configuration, and more. Optionally specify a version to retrieve a specific version of the agent.
create_batch_call
Create a batch outbound calling campaign to automate large-scale outreach. Specify a source number and a list of tasks (destination numbers) with optional per-call customizations. Campaigns can be scheduled or started immediately.
get_call
Retrieve detailed information about a specific call, including transcript, recording URL, call analysis, cost breakdown, latency metrics, and disconnection reason.
make_phone_call
Initiate an outbound phone call. Specify the source number (must be owned/imported in Retell) and destination number. Optionally override the agent, inject dynamic variables, or attach metadata.
delete_agent
Delete a voice agent and all of its versions. This action is irreversible.
create_web_call
Initiate a browser-based voice call via WebRTC. Returns an access token that can be used by the frontend to join the call room. No telephony infrastructure required.
get_concurrency
Check your current call concurrency usage, limits, and purchasing capacity. Useful for monitoring capacity before launching batch campaigns.
list_calls
List and filter calls in your Retell AI account. Filter by agent, status, type, direction, sentiment, date range, and more. Supports pagination and sorting.
list_phone_numbers
List all phone numbers in your Retell AI account, including their assigned agents, type, and configuration.
list_knowledge_bases
List all knowledge bases in your Retell AI account, including their status, sources, and configuration.
purchase_phone_number
Purchase a new phone number from Retell. Specify an area code and optionally assign inbound/outbound agents.
get_knowledge_base
Retrieve detailed information about a specific knowledge base, including its sources and processing status.
update_agent
Update the configuration of an existing voice agent. You can modify voice settings, language, webhooks, behavioral parameters, response engine, and more. Only provided fields will be updated.
create_agent
Create a new voice agent with a specified voice and response engine configuration. Agents can be configured with various voice settings, language, webhooks, and behavioral parameters.
list_voices
Browse available voices for Retell AI agents. Returns all voices with their provider, gender, accent, and preview audio. Use to find the right voice ID when creating or updating agents.
get_phone_number
Retrieve details of a specific phone number, including assigned agents, webhooks, and country restrictions.
delete_knowledge_base
Delete a knowledge base from your Retell AI account. This action is irreversible.
delete_call
Delete a call record from your Retell AI account. This action is irreversible.
list_agents
List voice agents in your Retell AI account. Returns unique voice agent IDs, names, and environment tags. Use get_agent for version configuration. Supports pagination for large collections.
update_phone_number
Update configuration of an existing phone number, including assigned agents, webhooks, and country restrictions.
delete_retell_llm
Delete an unused response engine. Delete or detach agents that reference it first; Retell rejects deletion while it is in use.
update_retell_llm
Update the latest draft or an explicitly selected response-engine version. Only supplied settings are changed.
list_retell_llms
Discover prompt-based response engines and their IDs for create_agent or update_agent. Supports cursor pagination.
create_retell_llm
Create a prompt-based Retell response engine. Pass its llmId to create_agent with responseEngine type retell-llm.
create_knowledge_base
Create a knowledge base from text and public URLs for an agent response engine. Indexing is asynchronous; use get_knowledge_base to check status.
get_retell_llm
Read a response engine and its prompt, model, and knowledge-base configuration.
download_call_recording
Prepare a downloadable WAV recording for a completed call. Choose the standard, multichannel, or PII-scrubbed recording when available.
publish_agent
Publish an existing draft version in place so it can serve production calls. Publishing does not create another draft version.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Build and manage Retell AI voice agents and prompt-based response engines. Create browser voice calls, initiate outbound phone calls and batch campaigns, configure phone numbers, create knowledge bases from text or URLs, browse voices, and inspect call transcripts, recordings, analysis, costs, and concurrency. Download completed call recordings.
Common questions about connecting Retell Ai to AI agents with Metorial.