Use the Speak AI MCP server tool update_voice_agent to update a voice agent.
What does it do?
Update a voice agent. Requires the OWNER or ADMIN role. Send only the fields you want to change; agentId, companyId, and userId are immutable and silently dropped if sent.
Parameters
update_voice_agent takes 10 parameters, 1 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
agentId |
string | Yes | ID of the voice agent to update (from list_voice_agents) |
name |
string | No | Required on create. Trimmed, non-empty. |
personality |
string | No | Required on create. Free text describing the agent’s tone. |
instructions |
string | No | Required on create. The agent’s system instructions. |
voice |
object | No | Required on create. |
llm |
object | No | |
avatar |
object | No | Set to attach a video avatar; avatarUrl/provider are derived server-side from the catalog row. |
conversationMode |
enum: voice_only, video_avatar | No | |
folderId |
string | No | Folder to file this agent’s conversations under. |
enableWebSearch |
boolean | No | Let the agent search the web mid-call, separate from any attached knowledge base. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for update_voice_agent.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.
Related
- Voice agents lists the rest of the Voice agents category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.