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": "mcp-1234abcd5678efgh", 3 "config": { 4 "url": "https://api.mcpserver.example.com/v1/tools", 5 "name": "Primary MCP Server", 6 "approval_policy": "auto_approve_all", 7 "tool_approval_hashes": [ 8 { 9 "tool_name": "DataFetcher", 10 "tool_hash": "a3f5c9d8e7b6f4a1c2d3e4f56789abcd1234567890abcdef1234567890abcdef", 11 "approval_policy": "auto_approved" 12 } 13 ], 14 "transport": "SSE", 15 "secret_token": { 16 "secret_id": "secret-9876zyxw4321" 17 }, 18 "request_headers": { 19 "Authorization": { 20 "secret_id": "secret-auth-token-001" 21 }, 22 "X-Custom-Header": "custom-value-123" 23 }, 24 "description": "Handles tool execution for conversational AI platform", 25 "force_pre_tool_speech": false, 26 "disable_interruptions": false, 27 "tool_call_sound": "typing", 28 "tool_call_sound_behavior": "auto", 29 "execution_mode": "immediate", 30 "tool_config_overrides": [ 31 { 32 "tool_name": "WeatherTool", 33 "force_pre_tool_speech": true, 34 "disable_interruptions": true, 35 "tool_call_sound": "elevator2", 36 "tool_call_sound_behavior": "auto", 37 "execution_mode": "post_tool_speech", 38 "assignments": [ 39 { 40 "dynamic_variable": "current_temperature", 41 "value_path": "weather.current.temp_c", 42 "source": "response" 43 } 44 ] 45 } 46 ], 47 "disable_compression": false 48 }, 49 "metadata": { 50 "created_at": 1684990000, 51 "owner_user_id": "user-1234abcd5678efgh" 52 }, 53 "access_info": { 54 "is_creator": true, 55 "creator_name": "John Doe", 56 "creator_email": "[email protected]", 57 "role": "admin" 58 }, 59 "dependent_agents": [ 60 { 61 "referenced_resource_ids": [ 62 "agent-5678abcd1234efgh" 63 ], 64 "id": "agent-5678abcd1234efgh", 65 "name": "Customer Support Bot", 66 "type": "available", 67 "created_at_unix_secs": 1685000000, 68 "access_level": "admin" 69 } 70 ] 71 }

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

disable_compressionboolean or nullOptional

Whether to disable HTTP compression for this 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