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.

Retell AI CLI for Headless Automation

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

7 functions 5 read 2 write Bearer token 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 --set access_token="$RETELL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call retell.retell_list_calls '{"limit":1,"filter_criteria":"example_filter_criteria","before":"example_before","after":"example_after"}' --json

Discovery Before Execution

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

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

Useful Retell AI CLI Functions

Function	Type	Parameters	Description
`retell.retell_list_calls`	Read	limit, filter_criteria, before, after	List AI voice calls from Retell. Supports filtering by criteria and cursor-based pagination using before/after timestamps.
`retell.retell_get_call`	Read	call_id	Get detailed information about a specific AI voice call, including transcript, duration, and status.
`retell.retell_create_phone_call`	Write	agent_id, metadata, retell_llm_dynamic_variables	Create a new AI-powered phone call using a Retell AI agent. The agent will handle the conversation automatically.
`retell.retell_list_agents`	Read	none	List all AI voice agents configured in Retell AI. Returns agent IDs, names, and configuration details.
`retell.retell_get_agent`	Read	agent_id	Get detailed information about a specific AI voice agent, including its model, voice, prompt, and configuration.
`retell.retell_create_agent`	Write	model, voice_id, prompt, response_engine	Create a new AI voice agent in Retell AI. Configure the model, voice, system prompt, and response engine.
`retell.retell_get_current_user`	Read	none	Get information about the currently authenticated Retell AI user. Useful for verifying credentials and account details.

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.