Retell AI MCP server

Read from the package source without running it. The installed server may list more.

• add_knowledge_base_sources
• configure_retell_api_key

  Host-managed setup only. The user adds the Retell AI API key in Settings → Connectors in the app. Do not ask for or accept the key in chat. WHERE TO GET A KEY: 1. Go to https://www.retellai.com/dashboard 2. Navigate to API Keys in settings 3. Create and copy your API key All other Retell AI tools require a valid API key to work.

• create_agentwrite action
• create_batch_callwrite action
• create_knowledge_basewrite action
• create_phone_callwrite action
• create_retell_llmwrite action
• create_web_callwrite action
• delete_agentwrite action
• delete_phone_numberwrite action
• delete_retell_llmwrite action
• get_agent
• get_agent_versions
• get_call
• get_chat

  Get details of a specific chat including full transcript, per-message breakdown, and analysis. WHEN TO USE: - After list_chats, to read one chat's full transcript - To review chat analysis (summary, sentiment, success) for quality checks ERROR RECOVERY: - 401: API key is missing or invalid → configure_retell_api_key - 404: chat_id not found → check the ID returned by list_chats RELATED TOOLS: - li

• get_concurrency
• get_knowledge_base

  Get details of a specific knowledge base, including its sources and processing status. WHEN TO USE: - Check whether a knowledge base has finished processing (status "complete") - List the documents/URLs/texts a knowledge base contains - Verify a source was added before attaching the knowledge base to an agent ERROR RECOVERY: - 401: API key is missing or invalid → configure_retell_api_key - 404: kn

• get_phone_number
• get_retell_llm
• list_agents
• list_calls
• list_chat_agents

  List configured chat agents in your Retell account (paginated). WHEN TO USE: - Discover chat agents before reading their chats - Find chat agent IDs by name NOTE: Returns summary records (agent_id, agent_name, channel, tags, timestamps). Results are filtered to chat agents; use list_agents for voice agents. ERROR RECOVERY: - 401: API key is missing or invalid → configure_retell_api_key RELATED TOO

• list_chats
• list_knowledge_bases
• list_phone_numbers
• list_retell_llms
• list_voices

  Browse all available TTS voices in Retell. WHEN TO USE: - Find voice IDs when creating or updating an agent - Compare providers/voice names before selecting a voice - Verify a voice_id still exists after a 404 from create_agent/update_agent COMMON MISTAKES: - Passing the display name instead of the exact voice_id - Reusing an old voice_id without checking it still exists ERROR RECOVERY: - 401: API

• publish_agentwrite action
• stop_call

  Stop an ongoing call immediately. WHEN TO USE: - User wants to end a call in progress - Call is stuck or behaving unexpectedly - Emergency stop COMMON MISTAKES: - Calling this on an already ended call; use get_call first if unsure ERROR RECOVERY: - 401: API key is missing or invalid → configure_retell_api_key - 404: call_id not found or no longer active → verify with list_calls/get_call RELATED TO

• update_agentwrite action
• update_phone_numberwrite action
• update_retell_llmwrite action

• Code scan41 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 1 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

85/100

higher than 75% of 4,456 AI and agents servers

Tools

32

the typical AI and agents server has 7

Tools that change things

41%

typical: 3%. Fewer write tools means less an agent can break

GitHub stars

14

more than 86% of 2,733 AI and agents servers

Downloads a week

88

more than 57% of 1,712 AI and agents servers with a package

Retell AI: common questions

Is Retell AI MCP server safe?

Yes, by our scan: it is graded A (85/100). Read the Retell AI safety report

How do I install Retell AI?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Retell AI need an API key?

Yes. The registry entry asks for RETELL_API_KEY.

Is Retell AI maintained?

The last commit was 11 days ago (2026-11-04). The latest release is v0.3.0.

What can I use instead of Retell AI?

Servers from other publishers that do the same job: Agent-Native Clips MCP server, Alibaba Cloud DashScope — Qwen MCP server and agent-custody MCP server.

How does Retell AI compare with other AI and agents MCP servers?

safety score 85/100 (higher than 75% of 4,456 AI and agents servers); tools 32 (the typical AI and agents server has 7); tools that change things 41% (typical: 3%. Fewer write tools means less an agent can break). Full comparison.