Can I use Retell AI as a CLI?

Yes. KosmoKrator exposes a Retell AI CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Retell AI through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Retell AI tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Retell AI credentials stored?

Retell AI credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Retell AI MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

voice

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.

6 functions 4 read 2 write API key auth

Submit Retell AI feedback View package source

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.

Machine-Readable Metadata

integration_slug: retell-ai
route_slug: retell-ai
package: retell-ai
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Retell AI CLIHeadless setup and direct function calls. Retell AI MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Retell AI MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Retell AI.

Retell AI CLI Matrix

Use these pages for direct Retell AI CLI workflows in scripts, CI, cron, and agent wrappers.

CI Retell AI CLI for CI. Cron Jobs Retell AI CLI for cron jobs. Shell Scripts Retell AI CLI for shell scripts. Headless Automation Retell AI CLI for headless automation. Coding Agents Retell AI CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`retell-ai.retell_ai_create_call`	Write `write`	2	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_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_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_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_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.