Retell AI MCP Server

Instructions

Implementation Reference

• src/index.ts:1193-1196 (handler)

  The execution handler for the retell_update_chat_agent tool. It extracts the agent_id from arguments, renames it to chatAgentId, and sends a PATCH request to the Retell API endpoint `/update-chat-agent/${chatAgentId}` with the remaining update data.

  case "retell_update_chat_agent": {
    const { agent_id: chatAgentId, ...chatAgentUpdateData } = args;
    return retellRequest(`/update-chat-agent/${chatAgentId}`, "PATCH", chatAgentUpdateData as Record<string, unknown>);
  }

• src/index.ts:667-684 (schema)

  Input schema definition for the retell_update_chat_agent tool, specifying required agent_id and optional agent_name and webhook_url fields.

  inputSchema: {
    type: "object",
    properties: {
      agent_id: {
        type: "string",
        description: "The chat agent ID to update"
      },
      agent_name: {
        type: "string",
        description: "New display name"
      },
      webhook_url: {
        type: "string",
        description: "New webhook URL"
      }
    },
    required: ["agent_id"]
  }

• src/index.ts:664-685 (registration)

  Tool registration object in the tools array used for listing available tools via ListToolsRequestHandler. Includes name, description, and input schema.

  {
    name: "retell_update_chat_agent",
    description: "Update a chat agent's configuration.",
    inputSchema: {
      type: "object",
      properties: {
        agent_id: {
          type: "string",
          description: "The chat agent ID to update"
        },
        agent_name: {
          type: "string",
          description: "New display name"
        },
        webhook_url: {
          type: "string",
          description: "New webhook URL"
        }
      },
      required: ["agent_id"]
    }
  },