Update MCP server configuration

1 curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \ 2 -H "xi-api-key: xi-api-key" \ 3 -H "Content-Type: application/json" \ 4 -d '{}'

1 { 2 "id": "string", 3 "config": { 4 "url": "string", 5 "name": "string", 6 "approval_policy": "auto_approve_all", 7 "tool_approval_hashes": [ 8 { 9 "tool_name": "string", 10 "tool_hash": "string", 11 "approval_policy": "auto_approved" 12 } 13 ], 14 "transport": "SSE", 15 "secret_token": { 16 "secret_id": "string" 17 }, 18 "request_headers": {}, 19 "description": "", 20 "force_pre_tool_speech": false, 21 "disable_interruptions": false, 22 "tool_call_sound": "typing", 23 "tool_call_sound_behavior": "auto", 24 "execution_mode": "immediate", 25 "tool_config_overrides": [ 26 { 27 "tool_name": "string", 28 "force_pre_tool_speech": true, 29 "disable_interruptions": true, 30 "tool_call_sound": "typing", 31 "tool_call_sound_behavior": "auto", 32 "execution_mode": "immediate", 33 "assignments": [ 34 { 35 "dynamic_variable": "string", 36 "value_path": "string", 37 "source": "response" 38 } 39 ] 40 } 41 ] 42 }, 43 "metadata": { 44 "created_at": 1, 45 "owner_user_id": "string" 46 }, 47 "access_info": { 48 "is_creator": true, 49 "creator_name": "string", 50 "creator_email": "string", 51 "role": "admin" 52 }, 53 "dependent_agents": [ 54 { 55 "type": "unknown" 56 } 57 ] 58 }

Update the configuration settings for an MCP server.

Path Parameters

mcp_server_idstringRequired

ID of the MCP Server.

Request

This endpoint expects an object.

approval_policyenum or nullOptional

The approval mode to set for the MCP server

Allowed values:

force_pre_tool_speechboolean or nullOptional

If set, overrides the server’s force_pre_tool_speech setting for this tool

disable_interruptionsboolean or nullOptional

If set, overrides the server’s disable_interruptions setting for this tool

tool_call_soundenum or nullOptional

Predefined tool call sound type to play during tool execution for all tools from this MCP server

Allowed values:

tool_call_sound_behaviorenum or nullOptional

Determines when the tool call sound should play for all tools from this MCP server

Allowed values:

execution_modeenum or nullOptional

If set, overrides the server’s execution_mode setting for this tool

Allowed values:

request_headersmap from strings to strings or objects or nullOptional

The headers to include in requests to the MCP server

Response

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobject or null

The access information of the MCP Server

dependent_agentslist of objects or null

List of agents that depend on this MCP Server.

Path Parameters

Headers

Request

Response

Errors