Retell AI
RetellAI captures calls and transcripts, enabling businesses to analyze conversations, extract insights, and enhance customer interactions in one centralized platform
Verdict
Common use cases
- Launch outbound sales calls from CRM data
- Pull call transcripts for QA review
- Provision new numbers for campaign tracking
- Retrieve call analytics after support shifts
- Start web calls for demo sessions
Integration
- Vendor
- Retell AI
- Category
- other
- Auth
- API_KEY
- Tools
- 10
- Composio slug
retellai
Tools
- Buy a new phone number bind agents
This endpoint allows purchasing a new phone number with a specified area code and binding it to designated agents for inbound and outbound calls. it requires json with agent ids and area code. responses indicate the creation status or error
- Create a new outbound phone call
Initiate an outbound call by post to '/v2/create-phone-call'. requires 'from number' and 'to number' in e.164 format. optional overrides and metadata supported. on success, returns call details including type, status, and ids.
- Create a new web call
The /v2/create-web-call endpoint creates a web call with a unique agent id, returning call details like type, token, call id, and status in json format, with a 201 response. optional metadata and variables can be included.
- Delete phone numberdestructive
Deletes an existing phone number identified by its e.164 format.
- List all phone numbers
Retrieves a list of all phone numbers associated with the account.
- Retrieve call details
The /v2/list-calls endpoint retrieves call records with filters (agent id, timestamps), offers sorting, pagination, and handles different responses (success, bad request, unauthorized, server error) in json format.
- Retrieve call details by id
Retrieve call details by id for web/phone calls, including type, agent id, status, timestamps, and web access token; covering responses from success to server errors.
- Retrieve details of a specific phone number
Fetches the details of a given phone number in e.164 format.
- Retrieve details of a specific voice
"access specific voice details including its name, provider, accent, gender, and a preview audio url using the unique voice id. parameters required."
- Update phone number
Updates the agent bound to a purchased phone number.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to the Integrations page. 2. Find Retell AI in the directory and click Connect. 3. Log into your Retell AI dashboard, go to API Keys, and generate a new key. 4. Paste the key into Switchy's auth prompt and click Authorize. 5. Switchy confirms the connection and shows which tools are available. 6. Open any Space and type '@Retell list all phone numbers' to verify the integration works. 7. If you see your phone inventory, you're ready to create calls and pull records. 8. To start a web call, @mention Retell with the agent ID you want to use. 9. For outbound phone calls, provide from and to numbers in E.164 format (e.g. +14155551234).
What teammates see: by default, memories from Retell AI are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Phone Numbers
@Retell list all phone numbers in my account and show which agents they're currently bound to.Open in a Space →
Start Outbound Call
@Retell create a new outbound phone call from +14155551000 to +14155552000 using agent ID abc123. Include metadata for campaign 'Q1 Outreach'.Open in a Space →
Create Web Call
@Retell create a new web call with agent ID xyz789 and return the access token so I can embed it in our demo page.Open in a Space →
Retrieve Call Details
@Retell retrieve call details for agent ID abc123 from the last 7 days, sorted by start time, and show call duration and status.Open in a Space →
Buy New Number
@Retell buy a new phone number with area code 415 and bind it to agent IDs abc123 and def456 for inbound and outbound calls.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@retell-ai list all phone numbers we have provisioned and show which agents are bound to each one
Here are your provisioned phone numbers: +1 (415) 555-0123 — Bound to agents: sales-agent-prod, fallback-agent +1 (646) 555-0198 — Bound to agents: support-agent-v2 +1 (512) 555-0147 — No agents bound (inactive) All numbers are in active status. The third number could be reassigned or released if no longer needed. This is an illustrative example based on typical account configurations.
This example demonstrates the MCP's ability to inventory telephony resources. Requires a valid API key with read permissions. Useful for auditing which agents handle inbound calls on which numbers, especially when managing multiple voice workflows across teams.
@retell-ai purchase a new phone number with area code 212 and bind it to our customer-onboarding-agent for inbound calls
Phone number purchased: +1 (212) 555-0291 Successfully bound to agent: customer-onboarding-agent (agent_abc123xyz) This number is now live for inbound calls. Outbound calling is enabled by default. You can update bindings or release the number anytime through the Retell dashboard or this MCP. This is an illustrative example; actual number availability depends on carrier inventory.
This example shows the MCP executing a write operation that provisions telephony infrastructure. Requires API key with write permissions. Be aware this action incurs billing charges from Retell AI. The area code must have available inventory, and the agent ID must exist in your account before binding.
@retell-ai retrieve call details from the last 24 hours for our support-agent-v2 and summarize any calls that lasted under 30 seconds
Found 47 calls for support-agent-v2 in the last 24 hours. 8 calls lasted under 30 seconds: - 6 calls ended with 'user-hangup' status within 10 seconds (likely wrong numbers or accidental dials) - 2 calls ended with 'agent-error' status at 22 and 28 seconds (possible configuration issues) The short-duration calls with agent errors may indicate a problem with the agent's prompt or webhook configuration. Consider reviewing logs for those call IDs. This is an illustrative summary based on typical call patterns.
This example pairs the MCP's data retrieval with AI reasoning to surface operational insights. Requires read permissions and filters by agent ID and timestamp. The MCP returns raw call records; the AI synthesizes patterns. Useful for troubleshooting voice workflows or identifying user experience issues in production agents.
Use-case deep-dives
When Retell AI makes sense for high-volume cold calling
A 6-person sales team running 200+ cold calls per week needs call transcripts and outcome tracking without manual CRM entry. Retell AI's create-outbound-call and retrieve-call-details tools let you spin up calls programmatically and pull structured metadata afterward. The MCP works if your reps already use a shared workspace for call prep—Switchy can trigger calls and log outcomes in one flow. The threshold: if your team needs real-time coaching or live call transfers, Retell's API alone won't cut it; you'll need their full platform. For post-call analysis and automated logging, this MCP closes the loop between dialing and data entry.
Retell AI for asynchronous support callbacks at scale
A 3-person support team handles 40 callback requests daily from a ticket system. Retell AI's phone-number management and outbound-call tools let you provision numbers, bind them to agents, and initiate callbacks from a shared queue. The MCP fits if callbacks are scheduled (not instant) and your team wants one workspace to see the queue, trigger calls, and retrieve transcripts. The trade-off: Retell requires E.164 phone formatting and agent IDs upfront, so you'll need a lookup step if your ticket system stores numbers differently. If your callback volume is under 10 per day, the setup overhead isn't worth it. Above 30, this MCP turns callback chaos into a repeatable workflow.
When Retell's web-call tool beats traditional conferencing
A 2-person product team runs 15 live demos per week and wants call recordings without Zoom fatigue. Retell AI's create-web-call tool generates a unique token and call ID for each session, returning structured metadata you can log immediately. The MCP works if your demos are one-on-one and you need programmatic call creation—Switchy can spin up a call link from a calendar event or CRM trigger. The boundary: Retell's web calls are agent-driven (you bind a specific agent ID), so this isn't a drop-in replacement for multi-participant meetings. If your demos are scripted and you want transcripts tied to a CRM record, this MCP delivers. For ad-hoc group calls, stick with Zoom.
Frequently asked
What does the Retell AI MCP do in Switchy?
It lets your team make and manage AI-powered phone calls directly from Switchy. You can buy phone numbers, bind them to Retell agents, start outbound calls, create web calls, and pull call logs without leaving the workspace. Useful if you're running voice AI campaigns or support lines and want call data in the same place as your other tools.
Do I need a Retell AI account to use this MCP?
Yes. You need an active Retell AI account and an API key. Paste the key into Switchy's connection flow. The MCP uses API_KEY auth, so there's no OAuth redirect—just copy the key from Retell's dashboard and you're done. No admin role required, but the key must have permissions to create calls and manage numbers.
Can the MCP actually place phone calls, or just retrieve logs?
It places calls. The 'Create a new outbound phone call' tool initiates real calls to any E.164 number you specify. You can also create web calls (for browser-based voice interactions) and buy new phone numbers with specific area codes. It's not read-only—your team can trigger live voice interactions from Switchy.
How is this different from using Retell AI's dashboard directly?
The dashboard is fine for one-off testing, but the MCP lets you automate call workflows inside Switchy. Combine it with other MCPs (like a CRM or calendar) to trigger calls based on events, log outcomes in your database, or route call transcripts to Slack. You skip the manual copy-paste loop between tools.
Who on my team should connect the Retell AI MCP?
Whoever manages your voice AI campaigns or has access to Retell's API keys. Once connected, any Switchy workspace member can use the tools (subject to your workspace permissions). If you're worried about accidental calls, restrict the connection to a specific channel or user group in Switchy's settings.