> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Obtener anulación de configuración de herramienta MCP

GET https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}

Obtiene las anulaciones de configuración de una herramienta MCP específica.

Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/mcp/tool-configuration/get

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `mcp_server_id` (string, required) — ID del servidor MCP.
- `tool_name` (string, required) — Nombre de la herramienta MCP cuya anulación de configuración se recuperará.

## Response

### 200

Respuesta correcta.

- `tool_name` (string, required) — El nombre de la herramienta MCP
- `pre_tool_speech` (enum, optional, default: auto) — Si se establece, anula la configuración pre_tool_speech del servidor para esta herramienta.
  - Allowed values: `auto`, `force`, `off`
- `interruption_mode` (enum, optional, default: allow) — Si se establece, anula la configuración interruption_mode del servidor para esta herramienta.
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `tool_call_sound` (McpToolConfigOverrideOutputToolCallSound, optional) — Anula la configuración tool_call_sound del servidor para esta herramienta. Un nombre de sonido reproduce ese sonido; 'off' anula el sonido por silencio; null significa no anularla (heredar el valor predeterminado del servidor).
- `tool_call_sound_behavior` (enum, optional, default: auto) — Si se establece, anula la configuración tool_call_sound_behavior del servidor para esta herramienta.
  - Allowed values: `auto`, `always`
- `execution_mode` (enum, optional, default: immediate) — Si se establece, anula la configuración execution_mode del servidor para esta herramienta.
  - Allowed values: `immediate`, `post_tool_speech`, `async`
- `response_timeout_secs` (integer, optional) — Si se establece, anula el tiempo de espera de respuesta del servidor para esta herramienta MCP (en segundos).
- `assignments` (list of DynamicVariableAssignment, optional) — Asignaciones de variables dinámicas para esta herramienta MCP
- `input_overrides` (map from string to McpToolConfigOverrideOutputInputOverridesValue, optional) — Asignación de ruta JSON a configuración de anulación de entrada
- `response_mocks` (list of ToolResponseMockConfigOutput, optional) — Respuestas simuladas con condiciones de parámetros opcionales. Se evalúan de arriba abajo; prevalece la primera coincidencia.
- `force_pre_tool_speech` (boolean, optional, deprecated) — OBSOLETO: usa `pre_tool_speech` en su lugar. Si se establece, sustituye la configuración force_pre_tool_speech del servidor para esta herramienta.
- `disable_interruptions` (boolean, optional, deprecated) — OBSOLETO: usa `interruption_mode` en su lugar. Si se establece, sustituye la configuración disable_interruptions del servidor para esta herramienta.

## Errors

### 404 Tool Configs Get Request Not Found Error

No se ha encontrado la anulación de configuración de la herramienta

- `any`

### 422 Tool Configs Get Request Unprocessable Entity Error

Error de validación

- `detail` (list of ValidationError, optional)

## Types

### McpToolConfigOverrideOutputToolCallSound

Anula la configuración tool_call_sound del servidor para esta herramienta. Un nombre de sonido reproduce ese sonido; 'off' anula el sonido por silencio; null significa no anularla (heredar el valor predeterminado del servidor).

### DynamicVariableAssignment

Configuración para extraer valores de las respuestas de herramientas y asignarlos a variables dinámicas.

- `dynamic_variable` (string, required) — El nombre de la variable dinámica a la que se asignará el valor extraído
- `value_path` (string, required) — Ruta de notación por puntos para extraer el valor de la fuente (por ejemplo, 'user.name' o 'data.0.id')
- `source` ("response", optional) — La fuente de la que extraer el valor. Actualmente solo se admite 'response'.
- `sanitize` (boolean, optional, default: false) — Si es true, el valor de esta asignación se eliminará de la respuesta de la herramienta antes de enviarla al LLM y a la transcripción, pero se seguirá procesando para la asignación de variables.
- `preserve_native_type` (boolean, optional, default: false) — Si es true, los valores no escalares (listas, objetos) extraídos de la respuesta de la herramienta se almacenan con su tipo nativo en lugar de convertirse en cadenas JSON. Activa esta opción para usar directamente los arrays extraídos como variables dinámicas de lista.

### McpToolConfigOverrideOutputInputOverridesValue

- `source`: `constant`
  - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — El valor constante que se usará
- `source`: `dynamic_variable`
  - `dynamic_variable` (string, required) — El nombre de la variable dinámica que se debe usar
- `source`: `llm`
  - `prompt` (string, optional) — Sustitución del prompt para el LLM. Si no se proporciona, se utiliza la descripción del esquema original.
- `source`: `omit`

### ToolResponseMockConfigOutput

- `mock_result` (string, required) — El valor de retorno que ve el LLM cuando esta simulación está activa.
- `parameter_conditions` (list of UnitTestToolCallParameter, optional) — Si la lista está vacía, el mock se activará siempre.
- `is_error` (boolean, optional, default: false) — Si es true, el resultado del mock se presenta al LLM como un error de herramienta en lugar de como un resultado correcto.

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)

### ConstantSchemaOverrideConstantValue

El valor constante que se usará

### UnitTestToolCallParameter

- `eval` (UnitTestToolCallParameterEval, required)
- `path` (string, required)

### ValidationErrorLocItem

### UnitTestToolCallParameterEval

- `type`: `anything`
- `type`: `exact`
  - `expected_value` (string, required) — El valor de cadena exacto con el que debe coincidir el parámetro.
- `type`: `llm`
  - `description` (string, required) — Una descripción de la estrategia de evaluación que se utilizará para la prueba.
- `type`: `regex`
  - `pattern` (string, required) — Un patrón regex con el que comparar la respuesta del agente.

## Examples

**Response**

```json
{
  "tool_name": "tool_name",
  "pre_tool_speech": "auto",
  "interruption_mode": "allow",
  "tool_call_sound": "typing",
  "tool_call_sound_behavior": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 1,
  "assignments": [
    {
      "dynamic_variable": "user_name",
      "value_path": "user.name",
      "source": "response",
      "sanitize": false,
      "preserve_native_type": false
    }
  ],
  "input_overrides": {
    "key": {
      "source": "constant",
      "constant_value": "constant_value"
    }
  },
  "response_mocks": [
    {
      "mock_result": "mock_result",
      "parameter_conditions": [
        {
          "eval": {
            "type": "anything"
          },
          "path": "path"
        }
      ],
      "is_error": true
    }
  ],
  "force_pre_tool_speech": true,
  "disable_interruptions": true
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name"

response = requests.get(url)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```