v5

latestOpenAPI 3.1.02026-08-043621,4011.8 MB
Agents Platform

Get Mcp Tool Configuration Override

Retrieve configuration overrides for a specific MCP tool.

get/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}

Path parameters

mcp_server_idstring required

ID of the MCP Server.

ID of the MCP Server.

tool_namestring required

Name of the MCP tool to retrieve config overrides for.

Name of the MCP tool to retrieve config overrides for.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

tool_namestring required

The name of the MCP tool

force_pre_tool_speechboolean nullable

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

pre_tool_speech'auto' | 'force' | 'off'
disable_interruptionsboolean nullable

DEPRECATED: use interruption_mode instead. If set, overrides the server's disable_interruptions setting for this tool.

interruption_mode'allow' | 'disable_during_tool' | 'disable_during_tool_and_turn'
tool_call_sound_behavior'auto' | 'always'

Determines how the tool call sound should be played.

execution_mode'immediate' | 'post_tool_speech' | 'async'
response_timeout_secsinteger nullable

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

input_overridesobject nullable

Mapping of json path to input override configuration

Example response

{
  "assignments": [
    {
      "dynamic_variable": "user_name",
      "preserve_native_type": false,
      "sanitize": false,
      "source": "response",
      "value_path": "user.name"
    }
  ]
}