retell_update_agent
Modify configuration settings for an existing voice agent, including voice, language, webhook, and conversation parameters.
Instructions
Update configuration for an existing voice agent.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | The agent ID to update | |
| agent_name | No | New display name | |
| voice_id | No | New voice ID | |
| language | No | New language code | |
| webhook_url | No | New webhook URL | |
| interruption_sensitivity | No | New interruption sensitivity | |
| enable_backchannel | No | Enable/disable backchannel |
Implementation Reference
- src/index.ts:1175-1178 (handler)The switch case handler that implements the core logic for the retell_update_agent tool. It extracts the agent_id from the input arguments and forwards a PATCH request to the Retell API endpoint `/update-agent/${agent_id}` with the remaining fields as update data.case "retell_update_agent": { const { agent_id, ...agentUpdateData } = args; return retellRequest(`/update-agent/${agent_id}`, "PATCH", agentUpdateData as Record<string, unknown>); }
- src/index.ts:529-562 (schema)The input schema defining the parameters for updating a voice agent: required agent_id, and optional fields for agent_name, voice_id, language, webhook_url, interruption_sensitivity, and enable_backchannel.inputSchema: { type: "object", properties: { agent_id: { type: "string", description: "The agent ID to update" }, agent_name: { type: "string", description: "New display name" }, voice_id: { type: "string", description: "New voice ID" }, language: { type: "string", description: "New language code" }, webhook_url: { type: "string", description: "New webhook URL" }, interruption_sensitivity: { type: "number", description: "New interruption sensitivity" }, enable_backchannel: { type: "boolean", description: "Enable/disable backchannel" } }, required: ["agent_id"] }
- src/index.ts:526-563 (registration)The tool registration object in the tools array, which includes the name, description, and input schema. This array is returned by the ListToolsRequestHandler to advertise available tools to MCP clients.{ name: "retell_update_agent", description: "Update configuration for an existing voice agent.", inputSchema: { type: "object", properties: { agent_id: { type: "string", description: "The agent ID to update" }, agent_name: { type: "string", description: "New display name" }, voice_id: { type: "string", description: "New voice ID" }, language: { type: "string", description: "New language code" }, webhook_url: { type: "string", description: "New webhook URL" }, interruption_sensitivity: { type: "number", description: "New interruption sensitivity" }, enable_backchannel: { type: "boolean", description: "Enable/disable backchannel" } }, required: ["agent_id"] } },