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 CLI for Headless Automation

Use the Retell AI CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 4 read 2 write API key auth

Submit Retell AI feedback View package source

Retell AI CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Retell AI CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Retell AI CLI for Headless Automation
kosmokrator integrations:configure retell-ai --set api_key="$RETELL_AI_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call retell-ai.retell_ai_create_call '{"agent_id":"example_agent_id","metadata":"example_metadata"}' --json

Discovery Before Execution

Agents and scripts can inspect Retell AI docs and schemas before choosing a function.

kosmo integrations:docs retell-ai --json
kosmo integrations:docs retell-ai.retell_ai_create_call --json
kosmo integrations:schema retell-ai.retell_ai_create_call --json
kosmo integrations:search "Retell AI" --json
kosmo integrations:list --json

Useful Retell AI CLI Functions

Function	Type	Parameters	Description
`retell-ai.retell_ai_create_call`	Write	agent_id, metadata	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	call_id	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	filter	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	none	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	voice_id, prompt, options	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	none	Retrieve current Retell AI account information, including available agents and account status. Useful for verifying connectivity and understanding account capabilities.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Retell AI CLI Pages

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