KosmoKrator

ai

Retell AI MCP Integration for Claude Agent SDK

Connect Retell AI to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write Bearer token auth
Submit Retell AI feedback View package source

Connect Retell AI to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Retell AI MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-retell": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=retell",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=retell --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Retell AI instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Retell AI Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Retell AI integration catalog.

MCP toolSource functionTypeDescription
integration__retell__retell_list_calls retell.retell_list_calls Read List AI voice calls from Retell. Supports filtering by criteria and cursor-based pagination using before/after timestamps.
integration__retell__retell_get_call retell.retell_get_call Read Get detailed information about a specific AI voice call, including transcript, duration, and status.
integration__retell__retell_create_phone_call retell.retell_create_phone_call Write Create a new AI-powered phone call using a Retell AI agent. The agent will handle the conversation automatically.
integration__retell__retell_list_agents retell.retell_list_agents Read List all AI voice agents configured in Retell AI. Returns agent IDs, names, and configuration details.
integration__retell__retell_get_agent retell.retell_get_agent Read Get detailed information about a specific AI voice agent, including its model, voice, prompt, and configuration.
integration__retell__retell_create_agent retell.retell_create_agent Write Create a new AI voice agent in Retell AI. Configure the model, voice, system prompt, and response engine.
integration__retell__retell_get_current_user retell.retell_get_current_user Read Get information about the currently authenticated Retell AI user. Useful for verifying credentials and account details.

Related Retell AI Pages

Retell AI CLIUse direct JSON commands instead of MCP discovery. Retell AI MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.