Retellai MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Retellai MCP or direct API to analyze call transcripts, summarize conversations, extract key insights, and automate call follow-ups through natural language.

Get started for free Get a demo

Retellai

Api Key

RetellAI is a platform for capturing calls and transcripts, centralizing business conversations. It helps teams analyze interactions and extract insights to improve customer experience.

67 Tools

Try Retellai now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND

Retellai

Enter ↵

Try asking

TOOLS

Supported Tools

Every Retellai action and event your agent gets out of the box.

Add community voice

Add a community voice from ElevenLabs to your Retell voice library.

Add sources to knowledge base

Tool to add sources (documents, URLs, text) to an existing knowledge base in Retell AI.

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.

Create Voice AI Agent

Create a new voice AI agent with specified configuration.

Create a new outbound phone call

Initiate an outbound call by POST to '/v2/create-phone-call'.

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.

Create Batch Test

Tool to create a batch test job that runs multiple test cases against an agent.

Create a new chat session

Tool to create a new chat session with a chat agent.

Create a new chat agent

Create a new chat agent with specified configuration.

Create chat completion

Tool to create a chat completion for an existing chat session, generating the agent's response to a user message.

Create conversation flow

Create a new Conversation Flow that can be attached to an agent for response generation.

Create conversation flow component

Creates a new shared conversation flow component at POST '/create-conversation-flow-component'.

Create a new knowledge base

Tool to create a new knowledge base in Retell AI with texts, files, and URLs.

Create Retell LLM Response Engine

Create a new Retell LLM Response Engine that can be attached to an agent.

Create Test Case Definition

Tool to create a test case definition for agent QA testing in Retell AI.

Delete agent

Deletes an existing agent by its unique identifier.

Delete call

Delete a specific call and its associated data by call ID.

Delete chat agent

Delete an existing chat agent by its unique identifier.

Delete conversation flow

Delete a conversation flow and all its versions.

Delete conversation flow component

Delete a shared conversation flow component.

Delete knowledge base

Delete an existing knowledge base by its unique identifier.

Delete knowledge base source

Delete an existing source from a knowledge base.

Delete phone number

Tool to delete an existing phone number from Retell AI.

Delete Retell LLM

Delete an existing Retell LLM Response Engine by its unique identifier.

Delete test case definition

Delete a test case definition by its unique identifier.

End chat

Tool to end an active chat session.

Retrieve details of a specific agent

Retrieve details of a specific agent by its unique identifier.

Get agent versions

Tool to retrieve all versions of a specific agent.

Get batch test

Retrieve details and results of a specific batch test job.

Get chat details

Tool to retrieve details of a specific chat session by chat ID.

Retrieve details of a specific chat agent

Retrieve details of a specific chat agent by its unique identifier.

Get all versions of a chat agent

Retrieve all versions of a specific chat agent by its unique identifier.

Get concurrency

Retrieves the current concurrency and concurrency limits for the organization.

Get Conversation Flow

Retrieve details of a specific Conversation Flow by its ID.

Get conversation flow component

Retrieves a shared conversation flow component by its unique identifier.

Get knowledge base

Retrieve details of a specific knowledge base by its unique identifier.

Retrieve details of a specific Retell LLM

Retrieve details of a specific Retell LLM Response Engine by its unique identifier.

Import phone number

Tool to import a phone number from custom telephony and bind agents to it.

List agents

Retrieves a list of all agents associated with the account.

List all chats

Tool to retrieve a list of all chats associated with the account.

List all phone numbers

Retrieves a list of all phone numbers associated with the account.

List batch tests

Tool to list batch test jobs for a response engine.

List chat agents

Tool to retrieve a list of all chat agents associated with the account.

List conversation flow components

Retrieves a list of all shared conversation flow components.

List conversation flows

Tool to list all conversation flows that can be attached to an agent.

List knowledge bases

Tool to retrieve all knowledge bases associated with the account.

List Retell LLMs

Tool to list all Retell LLM Response Engines that can be attached to an agent.

List test case definitions

Tool to list test case definitions for a response engine (Retell LLM or Conversation Flow).

List test runs

Tool to list all test case jobs (test runs) for a batch test job.

List voices

List all voices available to the user.

Publish agent

Publishes the latest version of the agent and creates a new draft agent with a newer version.

Publish chat agent

Publishes the latest version of the chat agent and creates a new draft chat agent with a newer version.

Retrieve call details

Tool to retrieve call details with filtering options.

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 phone number details

Tool to retrieve details of a specific phone number from Retell AI.

Retrieve details of a specific voice

Tool to retrieve details of a specific voice by its voice_id.

Search community voice

Search for community voices from voice providers.

Update agent

Update an existing agent's latest draft version.

Update call

Update an active call's parameters such as metadata, dynamic variables, or data storage settings.

Update chat agent

Update an existing chat agent configuration.

Update chat metadata

Tool to update metadata and sensitive data storage settings for an existing chat.

Update conversation flow

Update an existing conversation flow configuration.

Update conversation flow component

Update an existing shared conversation flow component by its ID.

Update phone number configuration

Update agent bound to a purchased phone number.

Update Retell LLM Response Engine

Update an existing Retell LLM Response Engine by its unique identifier.

Update test case definition

Update a test case definition for agent testing.

SETUP GUIDE

Connect Retellai MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai

Install the Composio SDK and your agent framework

Create a session with MCP enabled

typescript

import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["retellai"],
  mcp: true,
});

Create a session scoped to Retellai and read its MCP URL and headers

Connect your agent to the MCP server

typescript

import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all phone numbers and their assigned agents",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();

Pass the session's MCP URL and headers to your agent and run a Retellai request

SETUP GUIDE

Connect Retellai API Tool with your Agent

Install Composio

typescript

npm install @composio/core @composio/openai openai

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK

Create a Composio session

typescript

import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["retellai"] });
const tools = await session.tools();

Initialize Composio with the OpenAI Responses provider and create a session scoped to Retellai

Run Retellai tools with your agent

typescript

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all phone numbers and their assigned agents" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);

Send a request, execute the Retellai tool calls through the session, and print the final answer

Why Use Composio?

AI Native Retellai Integration

Supports both Retellai MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Retellai data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Retellai access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Retellai
Scoped, least privilege access to Retellai resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Retellai with any AI Agent Framework

Choose a Framework you want to connect Retellai with

Claude Code

Use Retellai MCP with Claude Code

Claude Cowork

Use Retellai MCP with Claude Cowork

OpenAI Agents SDK

Use Retellai MCP with OpenAI Agents SDK

Claude Agents SDK

Use Retellai MCP with Claude Agents SDK

Codex

Use Retellai MCP with Codex

OpenClaw

Use Retellai MCP with OpenClaw

Hermes

Use Retellai MCP with Hermes

Atomic Agent

Use Retellai MCP with Atomic Agent

Google ADK

Use Retellai MCP with Google ADK

Langchain

Use Retellai MCP with Langchain

AI SDK

Use Retellai MCP with AI SDK

Mastra AI

Use Retellai MCP with Mastra AI

LlamaIndex

Use Retellai MCP with LlamaIndex

CrewAI

Use Retellai MCP with CrewAI

Pydantic AI

Use Retellai MCP with Pydantic AI

Autogen

Use Retellai MCP with Autogen

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Gmail

Oauth2

Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

Outlook

Oauth2S2s Oauth2

Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management.

Slack

Oauth2

Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place.

Gong

BasicOauth2

Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action.

FAQ

Frequently asked questions

Yes, Retellai requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Retellai connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your Retellai account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the Retellai actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside Retellai at any time.

When you connect a Retellai account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Retellai as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Retellai. If Retellai lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Retellai at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Retellai connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment Retellai rejects the old key. Create a new key in Retellai and reconnect the account from the Composio dashboard or by asking your agent to reconnect Retellai. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Retellai use. Paid plans add higher limits and team features. Your Retellai plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Retellai accounts).

With Composio, you connect Retellai once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Retellai.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Retellai tool your agent needs.Free to start.

Start building

Retellai MCP server for AI agents and assistants

Try Retellai now

Supported Tools

Connect Retellai MCP Tool with your Agent

Install Composio

Create a session with MCP enabled

Connect your agent to the MCP server

Connect Retellai API Tool with your Agent

Install Composio

Create a Composio session

Run Retellai tools with your agent

Why Use Composio?

AI Native Retellai Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Retellai with any AI Agent Framework

Claude Code

Claude Cowork

OpenAI Agents SDK

Claude Agents SDK

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Rolling this out across your team?

Explore Other Toolkits

Gmail

Outlook

Slack

Gong

Frequently asked questions

Do I need my own developer credentials to use Retellai with Composio?+

Can I use multiple toolkits together?+

Is Composio secure with my Retellai account?+

What if the API changes?+

Where do I get a Retellai API key, and who can see it?+

Does the agent act as me inside Retellai?+

Which Retellai permissions does the agent get?+

Can I use multiple Retellai accounts with Claude and ChatGPT?+

What happens if I rotate or revoke my Retellai API key?+

Does using Retellai through Composio cost extra?+

How is Composio different from the Retellai connectors already built into Claude and ChatGPT?+

Start with Retellai.It takes 30 seconds.