Get configuration override

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

$ curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name

1 {
2   "tool_name": "tool_name",
3   "pre_tool_speech": "auto",
4   "disable_interruptions": true,
5   "tool_call_sound": "typing",
6   "tool_call_sound_behavior": "auto",
7   "execution_mode": "immediate",
8   "response_timeout_secs": 1,
9   "assignments": [
10     {
11       "dynamic_variable": "user_name",
12       "value_path": "user.name",
13       "source": "response",
14       "sanitize": false,
15       "preserve_native_type": false
16     }
17   ],
18   "input_overrides": {
19     "key": {
20       "source": "constant",
21       "constant_value": "constant_value"
22     }
23   },
24   "response_mocks": [
25     {
26       "mock_result": "mock_result",
27       "parameter_conditions": [
28         {
29           "eval": {
30             "type": "anything"
31           },
32           "path": "path"
33         }
34       ]
35     }
36   ],
37   "force_pre_tool_speech": true
38 }

Retrieve configuration overrides for a specific MCP tool.

Path parameters

mcp_server_idstringRequired

ID of the MCP Server.

tool_namestringRequired

Name of the MCP tool to retrieve config overrides for.

Response

Successful Response

tool_namestring

The name of the MCP tool

pre_tool_speechenumDefaults to auto

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

disable_interruptionsboolean

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

tool_call_soundenum

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

tool_call_sound_behaviorenumDefaults to auto

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

execution_modeenumDefaults to immediate

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

response_timeout_secsinteger5-300

If set, overrides the server’s response timeout for this MCP tool (seconds).

assignmentslist of objects

Dynamic variable assignments for this MCP tool

input_overridesmap from strings to optional objects

Mapping of json path to input override configuration

response_mockslist of objects

Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.

force_pre_tool_speechbooleanDeprecated

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

Errors

404

Tool Configs Get Request Not Found Error

422

Tool Configs Get Request Unprocessable Entity Error

Path parameters

Headers

Response

Errors