Update MCP server configuration

from elevenlabs import ElevenLabs
from elevenlabs.environment import ElevenLabsEnvironment
client = ElevenLabs(
    environment=ElevenLabsEnvironment.PRODUCTION
)
client.conversational_ai.mcp_servers.update(
    mcp_server_id="mcp_server_id"
)

{
  "id": "id",
  "config": {
    "url": "url",
    "name": "name",
    "approval_policy": "auto_approve_all",
    "tool_approval_hashes": [
      {
        "tool_name": "tool_name",
        "tool_hash": "tool_hash"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret_id"
    },
    "request_headers": {
      "key": "value"
    },
    "description": "description",
    "force_pre_tool_speech": true,
    "disable_interruptions": true,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "tool_config_overrides": [
      {
        "tool_name": "tool_name",
        "assignments": [
          {
            "dynamic_variable": "user_name",
            "value_path": "user.name",
            "source": "response",
            "sanitize": false
          }
        ]
      }
    ],
    "disable_compression": true
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "owner_user_id"
  },
  "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": "id",
      "name": "name",
      "referenced_resource_ids": [
        "referenced_resource_ids"
      ]
    }
  ]
}

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_policyenumOptional

The approval mode to set for the MCP server

Allowed values:

force_pre_tool_speechbooleanOptional

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

disable_interruptionsbooleanOptional

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

tool_call_soundenumOptional

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

Allowed values:

tool_call_sound_behaviorenumOptional

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

Allowed values:

execution_modeenumOptional

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

Allowed values:

request_headersmap from strings to optional strings or objectsOptional

The headers to include in requests to the MCP server

disable_compressionbooleanOptional

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.

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

Path parameters

Headers

Request

Response

Errors