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 AI Agents

Use the Retell AI CLI from KosmoKrator to call Retell AI tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 4 read 2 write API key auth

Submit Retell AI feedback View package source

Retell AI CLI Setup

Retell AI can be configured headlessly with `kosmokrator integrations:configure retell-ai`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure retell-ai --set api_key="$RETELL_AI_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor retell-ai --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`RETELL_AI_API_KEY`	Secret `secret`	yes	API Key
`url`	`RETELL_AI_URL`	URL `url`	no	API Base URL

Call Retell AI Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call retell-ai.retell_ai_create_call '{
  "agent_id": "example_agent_id",
  "metadata": "example_metadata"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:retell-ai retell_ai_create_call '{
  "agent_id": "example_agent_id",
  "metadata": "example_metadata"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities 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

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Retell AI.

`retell-ai.retell_ai_create_call`

Write write

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.

Parameters: agent_id, metadata

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_create_call '{"agent_id":"example_agent_id","metadata":"example_metadata"}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_create_call '{"agent_id":"example_agent_id","metadata":"example_metadata"}' --json

`retell-ai.retell_ai_get_call`

Read read

Retrieve details for a specific phone call by its ID. Returns call status, duration, transcript, and associated metadata.

Parameters: call_id

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_get_call '{"call_id":"example_call_id"}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_get_call '{"call_id":"example_call_id"}' --json

`retell-ai.retell_ai_list_calls`

Read read

List phone calls from Retell AI. Returns call records with status, duration, and metadata. Supports optional filters for agent, status, or date range.

Parameters: filter

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_list_calls '{"filter":"example_filter"}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_list_calls '{"filter":"example_filter"}' --json

`retell-ai.retell_ai_list_agents`

Read read

List all configured voice agents in your Retell AI account. Returns agent IDs, names, voice settings, and other configuration details.

Parameters: none

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_list_agents '{}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_list_agents '{}' --json

`retell-ai.retell_ai_create_agent`

Write write

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.

Parameters: voice_id, prompt, options

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_create_agent '{"voice_id":"example_voice_id","prompt":"example_prompt","options":"example_options"}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_create_agent '{"voice_id":"example_voice_id","prompt":"example_prompt","options":"example_options"}' --json

`retell-ai.retell_ai_get_current_user`

Read read

Retrieve current Retell AI account information, including available agents and account status. Useful for verifying connectivity and understanding account capabilities.

Parameters: none

Generic CLI call

kosmo integrations:call retell-ai.retell_ai_get_current_user '{}' --json

Provider shortcut

kosmo integrations:retell-ai retell_ai_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`retell-ai.retell_ai_create_call`

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.

Operation: Write write
Schema command: kosmo integrations:schema retell-ai.retell_ai_create_call --json

Parameter	Type	Required	Description
`agent_id`	string	yes	The Retell AI agent ID to use for the call (e.g., "agent_17a9b81c3c0").
`metadata`	object	no	Optional key-value metadata to attach to the call for tracking and context (e.g., {"customer_id": "12345", "campaign": "onboarding"}).

`retell-ai.retell_ai_get_call`

Retrieve details for a specific phone call by its ID. Returns call status, duration, transcript, and associated metadata.

Operation: Read read
Schema command: kosmo integrations:schema retell-ai.retell_ai_get_call --json

Parameter	Type	Required	Description
`call_id`	string	yes	The unique identifier of the call to retrieve (e.g., "call_17a9b81c3c0").

`retell-ai.retell_ai_list_calls`

List phone calls from Retell AI. Returns call records with status, duration, and metadata. Supports optional filters for agent, status, or date range.

Operation: Read read
Schema command: kosmo integrations:schema retell-ai.retell_ai_list_calls --json

Parameter	Type	Required	Description
`filter`	object	no	Optional filters to apply. Supported keys may include agent_id, status, start_timestamp, end_timestamp, etc.

`retell-ai.retell_ai_list_agents`

List all configured voice agents in your Retell AI account. Returns agent IDs, names, voice settings, and other configuration details.

Operation: Read read
Schema command: kosmo integrations:schema retell-ai.retell_ai_list_agents --json

Parameter	Type	Required	Description
No parameters.

`retell-ai.retell_ai_create_agent`

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.

Operation: Write write
Schema command: kosmo integrations:schema retell-ai.retell_ai_create_agent --json

Parameter	Type	Required	Description
`voice_id`	string	yes	The voice ID to assign to the agent (e.g., "11labs_Alice"). Determines the voice the agent speaks with.
`prompt`	string	yes	The system prompt that defines the agent's behavior, personality, and conversation guidelines.
`options`	object	no	Additional agent configuration options (e.g., {"agent_name": "Support Agent", "language": "en", "ambient_noise": true}).

`retell-ai.retell_ai_get_current_user`

Retrieve current Retell AI account information, including available agents and account status. Useful for verifying connectivity and understanding account capabilities.

Operation: Read read
Schema command: kosmo integrations:schema retell-ai.retell_ai_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.