Agents Platform

Create Mcp Tool Configuration Override

Changed on

Create configuration overrides for a specific MCP tool.

post/v1/convai/mcp-servers/{mcp_server_id}/tool-configs

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
  • Auth
    none declared

Path parameters

mcp_server_idstring required

ID of the MCP Server.

Query parameters

environmentstring

Environment whose values are used when the MCP server URL, headers, or auth connection reference environment variables. Mirrors the environment a conversation would run in; defaults to production.

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.

Request body

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.

input_overridesobject nullable

Mapping of json path to input override configuration

tool_namestring required

The name of the MCP tool

Example request

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

Response

Successful Response

idstring required

Changes

  • f053c821dc18Revision changes
    • breaking

      response property config/tool_config_overrides/items/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

    • info

      request property //// list-of-types was widened by adding types null to media type application/json

  • 1cae8adcc965Revision changes
    • info

      added the optional property / to the response with the status