Update MCP server configuration | ElevenLabs Documentation

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

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "force_pre_tool_speech": false,
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "tool_config_overrides": [
      {
        "tool_name": "string",
        "force_pre_tool_speech": true,
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "assignments": [
          {
            "dynamic_variable": "string",
            "value_path": "string",
            "source": "response",
            "sanitize": false
          }
        ],
        "input_overrides": {}
      }
    ],
    "disable_compression": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

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 nullOptionalDefaults to require_approval_all

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 nullOptionalDefaults to auto

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

Allowed values:

execution_modeenum or nullOptionalDefaults to immediate

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

secret_tokenobject or nullOptional

Optional secret token for authentication with this MCP server

auth_connectionobject or nullOptional

Optional auth connection to use for authentication with 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

List of agents that depend on this MCP Server.

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Request

Response

Errors