For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • Get started
    • Overview
    • Quickstart
  • Configure
    • Overview
    • Voice & language
    • Knowledge base
    • Tools
    • Personalization
    • Authentication
  • Deploy
    • Overview
    • Environment variables
    • WhatsApp
    • Batch calls
  • Monitor
    • Overview
    • Users
    • Testing
    • Experiments
    • Versioning
    • Conversation Analysis
    • Analytics
    • Real-time monitoring
    • OpenTelemetry traces
    • Privacy
    • Cost optimization
    • CLI
  • Advanced
    • Events
    • Custom models
    • LLM cascading
    • Post-call webhooks
  • Resources
    • UI components
  • Guides
    • Chat Mode
    • Burst pricing
    • ElevenLabs' docs agent
    • Scaling user interviews
    • Simulate Conversations
        • WSSAgent WebSockets
          • POSTCreate MCP server
          • DELDelete MCP server
          • GETList MCP servers
          • GETGet MCP server
          • GETList MCP server tools
          • PATCHUpdate MCP server configuration
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
API referenceMCP

Update MCP server configuration

PATCH
/v1/convai/mcp-servers/:mcp_server_id
PATCH
/v1/convai/mcp-servers/:mcp_server_id
$curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "id": "string",
3  "config": {
4    "url": "string",
5    "name": "string",
6    "approval_policy": "require_approval_all",
7    "tool_approval_hashes": [
8      {
9        "tool_name": "string",
10        "tool_hash": "string",
11        "approval_policy": "requires_approval"
12      }
13    ],
14    "transport": "SSE",
15    "secret_token": {
16      "secret_id": "string"
17    },
18    "request_headers": {},
19    "auth_connection": {
20      "auth_connection_id": "string"
21    },
22    "description": "",
23    "pre_tool_speech": "auto",
24    "disable_interruptions": false,
25    "tool_call_sound": "typing",
26    "tool_call_sound_behavior": "auto",
27    "execution_mode": "immediate",
28    "response_timeout_secs": 30,
29    "tool_config_overrides": [
30      {
31        "tool_name": "string",
32        "pre_tool_speech": "auto",
33        "disable_interruptions": true,
34        "tool_call_sound": "typing",
35        "tool_call_sound_behavior": "auto",
36        "execution_mode": "immediate",
37        "response_timeout_secs": 1,
38        "assignments": [
39          {
40            "dynamic_variable": "string",
41            "value_path": "string",
42            "source": "response",
43            "sanitize": false,
44            "preserve_native_type": false
45          }
46        ],
47        "input_overrides": {},
48        "response_mocks": [
49          {
50            "mock_result": "string",
51            "parameter_conditions": [
52              {
53                "eval": {
54                  "type": "string",
55                  "description": "string"
56                },
57                "path": "string"
58              }
59            ]
60          }
61        ],
62        "force_pre_tool_speech": true
63      }
64    ],
65    "disable_compression": false,
66    "force_pre_tool_speech": false
67  },
68  "metadata": {
69    "created_at": 1,
70    "owner_user_id": "string"
71  },
72  "access_info": {
73    "is_creator": true,
74    "creator_name": "John Doe",
75    "creator_email": "john.doe@example.com",
76    "role": "admin",
77    "access_source": "creator"
78  },
79  "dependent_agents": [
80    {
81      "type": "available",
82      "access_level": "admin",
83      "created_at_unix_secs": 1,
84      "id": "string",
85      "name": "string",
86      "referenced_resource_ids": [
87        "string"
88      ]
89    }
90  ]
91}
Update the configuration settings for an MCP server.
Was this page helpful?
Previous

Update MCP server approval policy

Next
Built with

Path parameters

mcp_server_idstringRequired
ID of the MCP Server.

Headers

xi-api-keystringOptional

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:
pre_tool_speechenum or nullOptionalDefaults to auto

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

Allowed values:
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:
response_timeout_secsinteger or nullOptional5-300
The maximum time in seconds to wait for each MCP tool call to complete.
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
force_pre_tool_speechboolean or nullOptionalDeprecated

DEPRECATED: use pre_tool_speech instead. If set, overrides the server’s force_pre_tool_speech setting for this tool.

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