productivity
Retell AI MCP, CLI, and Lua Integration for AI Agents
Retell AI integration docs for AI agents: MCP gateway setup, Retell AI CLI commands, Lua API reference, credentials, and function schemas.Retell AI for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
retell-ai.retell_ai_create_call | Write write | 3 | Create a new AI-powered phone call using a Retell AI voice agent. Specify the agent ID and optional metadata to attach context to the call. |
retell-ai.retell_ai_create_web_call | Write write | 0 | Create a Retell web call. |
retell-ai.retell_ai_get_call | Read read | 1 | Retrieve details for a specific phone call by its ID. Returns call status, duration, transcript, and associated metadata. |
retell-ai.retell_ai_list_calls | Read read | 1 | List phone calls from Retell AI. Returns call records with status, duration, and metadata. Supports optional filters for agent, status, or date range. |
retell-ai.retell_ai_update_call | Write write | 0 | Update call metadata. |
retell-ai.retell_ai_stop_call | Write write | 0 | Stop an in-progress call. |
retell-ai.retell_ai_delete_call | Write write | 0 | Delete a call record. |
retell-ai.retell_ai_list_agents | Read read | 0 | List all configured voice agents in your Retell AI account. Returns agent IDs, names, voice settings, and other configuration details. |
retell-ai.retell_ai_get_agent | Read read | 0 | Get a voice agent. |
retell-ai.retell_ai_create_agent | Write write | 3 | Create a new voice AI agent in Retell AI. Specify the voice ID and system prompt. Additional options like agent name, language, and behavior settings can be provided. |
retell-ai.retell_ai_update_agent | Write write | 0 | Update a voice agent. |
retell-ai.retell_ai_delete_agent | Write write | 0 | Delete a voice agent. |
retell-ai.retell_ai_list_phone_numbers | Read read | 0 | List phone numbers. |
retell-ai.retell_ai_get_phone_number | Read read | 0 | Get a phone number. |
retell-ai.retell_ai_update_phone_number | Write write | 0 | Update phone number routing. |
retell-ai.retell_ai_list_retell_llms | Read read | 0 | List Retell LLMs. |
retell-ai.retell_ai_get_retell_llm | Read read | 0 | Get a Retell LLM. |
retell-ai.retell_ai_list_voices | Read read | 0 | List voices. |
retell-ai.retell_ai_get_voice | Read read | 0 | Get a voice. |
retell-ai.retell_ai_get_current_user | Read read | 0 | Retrieve current Retell AI account information, including available agents and account status. Useful for verifying connectivity and understanding account capabilities. |
retell-ai.retell_ai_api_get | Read read | 0 | Call a documented GET endpoint. |
retell-ai.retell_ai_api_post | Write write | 0 | Call a documented POST endpoint. |
retell-ai.retell_ai_api_patch | Write write | 0 | Call a documented PATCH endpoint. |
retell-ai.retell_ai_api_delete | Write write | 0 | Call a documented DELETE endpoint. |