Agents Platform

Get Mcp Tool Configuration Override

Changed on

Retrieve configuration overrides for a specific MCP tool.

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

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}
  • Auth
    none declared

Path parameters

mcp_server_idstring required

ID of the MCP Server.

tool_namestring required

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.

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"
    }
  ]
}

Changes

  • f053c821dc18Revision changes
    • breaking

      response property input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value list-of-types was widened by adding types null to media type application/json of response 200

  • d39efac71e54Revision changes
    • info

      added the optional property /// to the response with the status