---
title: "Get Mcp Tool Configuration Override"
method: GET
path: "/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}"
tags: ["Agents Platform"]
---

# Get Mcp Tool Configuration Override

`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

Retrieve configuration overrides for a specific MCP tool.

## Path parameters

- `mcp_server_id` string, required: ID of the MCP Server.
- `tool_name` string, required: Name of the MCP tool to retrieve config overrides for.

## Headers

- `xi-api-key` string, 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 `200`

Successful Response

- MCPToolConfigOverrideOutput
  - `tool_name` string, required: The name of the MCP tool
  - `force_pre_tool_speech` boolean, 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_interruptions` boolean, 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` union: Overrides the server's tool_call_sound setting for this tool. A sound name plays that sound; 'off' overrides to no sound (silence); null means do not override (inherit the server default).
    - 'typing' | 'elevator1' | 'elevator2' | 'elevator3' | 'elevator4': Predefined tool call sounds; ``None`` means no sound.
    - 'off'
  - `tool_call_sound_behavior` 'auto' | 'always': Determines how the tool call sound should be played.
  - `execution_mode` 'immediate' | 'post_tool_speech' | 'async'
  - `response_timeout_secs` integer, nullable: If set, overrides the server's response timeout for this MCP tool (seconds).
  - `assignments` DynamicVariableAssignment[]: Dynamic variable assignments for this MCP tool
    - `source` 'response': The source to extract the value from. Currently only 'response' is supported.
    - `dynamic_variable` string, required: The name of the dynamic variable to assign the extracted value to
    - `value_path` string, required: Dot notation path to extract the value from the source (e.g., 'user.name' or 'data.0.id')
    - `sanitize` boolean: If true, this assignment's value will be removed from the tool response before sending to the LLM and transcript, but still processed for variable assignment.
    - `preserve_native_type` boolean: If true, non-scalar values (lists, objects) extracted from the tool response are stored as their native type instead of being stringified to JSON. Enable this to use extracted arrays directly as list dynamic variables.
  - `input_overrides` object, nullable: Mapping of json path to input override configuration
  - `response_mocks` ToolResponseMockConfigOutput[], nullable: Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.
    - `parameter_conditions` UnitTestToolCallParameter[]: If the list is empty, the mock will always activate.
      - `eval` union, required
        - LLMParameterEvaluationStrategy
          - `type` 'llm', required
          - `description` string, required: A description of the evaluation strategy to use for the test.
        - RegexParameterEvaluationStrategy
          - `type` 'regex', required
          - `pattern` string, required: A regex pattern to match the agent's response against.
        - ExactParameterEvaluationStrategy
          - `type` 'exact', required
          - `expected_value` string, required: The exact string value that the parameter must match.
        - MatchAnythingParameterEvaluationStrategy
          - `type` 'anything', required
      - `path` string, required
    - `mock_result` string, required: The return value the LLM sees when this mock is active.
    - `is_error` boolean: If true, the mock result is surfaced to the LLM as a tool error rather than a successful result.

## Other responses

- `404`: Tool config override not found
- `422`: Validation Error

## Changes

- **2026-08-19** `f053c821dc18`: 1 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`
- **2026-07-27** `d39efac71e54`: 1 info
  - added the optional property `response_mocks/anyOf[subschema #1]/items/is_error` to the response with the `200` status
- **2026-07-26** `494d96419d15`: 1 breaking
  - response property `input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value` list-of-types was widened by adding types `object` to media type `application/json` of response `200`
- **2026-07-13** `009bd651509a`: 1 breaking, 3 info
  - response property `input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - added the optional property `interruption_mode` to the response with the `200` status
  - added `subschema #2` to the `tool_call_sound` response property `anyOf` list for the response status `200`
  - response property `disable_interruptions` deprecated
- …earlier changes not shown

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)