> 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. # MCP-Tool-Konfigurationsüberschreibung löschen DELETE https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name} Entfernt Konfigurationsüberschreibungen für ein bestimmtes MCP-Tool. Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/mcp/tool-configuration/delete ## 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 des MCP-Servers. - `tool_name` (string, required) — Name des MCP-Tools, für das Konfigurationsüberschreibungen entfernt werden sollen. ## Response ### 200 Erfolgreiche Antwort - `id` (string, required) - `config` (McpServerConfigOutput, required) - `metadata` (McpServerMetadataResponseModel, required) — Die Metadaten des MCP-Servers - `access_info` (ResourceAccessInfo, optional) — Die Zugriffsinformationen des MCP-Servers - `dependent_agents` (list of McpServerResponseModelDependentAgentsItem, optional) — Liste der Agenten, die von diesem MCP-Server abhängen. ## Errors ### 422 Tool Configs Delete Request Unprocessable Entity Error Validierungsfehler - `detail` (list of ValidationError, optional) ## Types ### McpServerConfigOutput - `url` (McpServerConfigOutputUrl, required) — Die URL des MCP-Servers. Falls sie ein Geheimnis enthält, speichern Sie sie als Workspace-Geheimnis, andernfalls als einfachen String. Muss HTTPS verwenden. - `name` (string, required) - `approval_policy` (enum, optional, default: require_approval_all) — Definiert die Genehmigungsrichtlinie auf MCP-Serverebene für die Tool-Ausführung. - Allowed values: `auto_approve_all`, `require_approval_all`, `require_approval_per_tool` - `tool_approval_hashes` (list of McpToolApprovalHash, optional) — Liste der Tool-Genehmigungs-Hashes für die Genehmigung pro Tool, wenn approval_policy REQUIRE_APPROVAL_PER_TOOL ist - `transport` (enum, optional, default: SSE) — Der zur Verbindung mit dem MCP-Server verwendete Transporttyp - Allowed values: `SSE`, `STREAMABLE_HTTP` - `secret_token` (McpServerConfigOutputSecretToken, optional) — Das geheime Token (Authorization-Header), das als Workspace-Secret oder In-Place-Secret gespeichert ist - `request_headers` (map from string to McpServerConfigOutputRequestHeadersValue, optional) — Die in der Anfrage enthaltenen Header - `request_meta` (map from string to McpServerConfigOutputRequestMetaValue, optional) — Einträge, die im MCP-Feld `_meta` von tools/call-Anfragen gesendet werden. Werte können JSON-Skalare oder Verweise auf ein Workspace-Geheimnis, eine dynamische Variable oder eine pro Aufruf aufgelöste Umgebungsvariable sein. - `auth_connection` (McpServerConfigOutputAuthConnection, optional) — Optionale Authentifizierungsverbindung zur Anmeldung bei diesem MCP-Server - `description` (string, optional, default: ) - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. Applies to every tool from this MCP server unless overridden per tool. - Allowed values: `auto`, `force`, `off` - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. Applies to every tool from this MCP server unless overridden per tool. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `tool_call_sound` (enum, optional) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung für alle Tools dieses MCP-Servers abgespielt wird - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe bei allen Tools dieses MCP-Servers abgespielt werden soll. - Allowed values: `auto`, `always` - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie alle Tools dieses MCP-Servers ausgeführt werden: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `response_timeout_secs` (integer, optional, default: 30) — Die maximale Wartezeit in Sekunden für den Abschluss jedes MCP-Tool-Aufrufs. Muss zwischen 5 und 300 Sekunden liegen, einschließlich. - `tool_config_overrides` (list of McpToolConfigOverrideOutput, optional) — Liste der tool-spezifischen Konfigurationsüberschreibungen, die die Standardwerte auf Serverebene für bestimmte Tools überschreiben - `disable_compression` (boolean, optional, default: false) — Ob die HTTP-Komprimierung für diesen MCP-Server deaktiviert werden soll. Aktivieren Sie dies, wenn der Server keine komprimierten Antworten unterstützt. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true erfordern alle Tools dieses MCP-Servers eine Ansage vor der Tool-Ausführung. - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während ein Tool dieses MCP-Servers ausgeführt wird. ### McpServerMetadataResponseModel - `created_at` (integer, required) - `owner_user_id` (string, optional) ### ResourceAccessInfo - `is_creator` (boolean, required) — Ob der Nutzer, der die Anfrage stellt, den Agenten erstellt hat. - `creator_name` (string, required) — Name des Erstellers des Agenten - `creator_email` (string, required) — E-Mail-Adresse des Erstellers des Agents - `role` (enum, required) — Die Rolle des Benutzers, der die Anfrage stellt - Allowed values: `admin`, `editor`, `commenter`, `viewer` - `anonymous_access_level_override` (enum, optional) — Die Zugriffsebene für anonyme Nutzer. Bei None ist die Ressource nicht öffentlich freigegeben. - Allowed values: `admin`, `editor`, `commenter`, `viewer` - `access_source` (enum, optional) — Warum der anfragende Nutzer Zugriff auf diese Ressource hat. 'creator' = der Aufrufer ist der Eigentümer. 'explicit' = der Aufrufer (oder eine seiner Workspace-Gruppen) ist zusätzlich zur workspaceweiten Gruppe „everyone“ in role_to_group_ids aufgeführt. 'workspace_default' = die workspaceweite Gruppe „everyone“ ist in role_to_group_ids aufgeführt (jedes nicht anonyme Workspace-Mitglied, einschließlich Administratoren, sieht diese Ressource). 'workspace_admin' = der Aufrufer ist Workspace-Administrator und der Administratorzugang ist der *einzige* Zugriffsweg; reserviert für Dokumente, die sonst niemand sehen kann. Ermöglicht der Benutzeroberfläche offenzulegen, warum ein Betrachter mit Administrator-Bypass ein Dokument sieht, das nicht explizit mit ihm geteilt wurde. - Allowed values: `creator`, `explicit`, `workspace_admin`, `workspace_default` ### McpServerResponseModelDependentAgentsItem - `type`: `available` - `access_level` (enum, required) - Allowed values: `admin`, `editor`, `commenter`, `viewer` - `created_at_unix_secs` (integer, required) - `id` (string, required) - `name` (string, required) - `referenced_resource_ids` (list of string, optional) — Falls der Agent transitiv abhängig ist, enthält dies die IDs der Ressourcen, von denen der Agent direkt abhängt. - `type`: `unknown` - `id` (string, required) - `referenced_resource_ids` (list of string, optional) — Falls der Agent transitiv abhängig ist, enthält dies die IDs der Ressourcen, von denen der Agent direkt abhängt. ### ValidationError - `loc` (list of ValidationErrorLocItem, required) - `msg` (string, required) - `type` (string, required) ### McpServerConfigOutputUrl Die URL des MCP-Servers. Falls sie ein Geheimnis enthält, speichern Sie sie als Workspace-Geheimnis, andernfalls als einfachen String. Muss HTTPS verwenden. ### McpToolApprovalHash Modell zum Speichern von Tool-Genehmigungs-Hashes für Genehmigungen pro Tool. - `tool_name` (string, required) — Der Name des MCP-Tools - `tool_hash` (string, required) — SHA256-Hash der Parameter und Beschreibung des Tools - `approval_policy` (enum, optional, default: requires_approval) — Die Genehmigungsrichtlinie für dieses Tool - Allowed values: `auto_approved`, `requires_approval` ### McpServerConfigOutputSecretToken Das geheime Token (Authorization-Header), das als Workspace-Secret oder In-Place-Secret gespeichert ist ### McpServerConfigOutputRequestHeadersValue ### McpServerConfigOutputRequestMetaValue ### McpServerConfigOutputAuthConnection Optionale Authentifizierungsverbindung zur Anmeldung bei diesem MCP-Server ### McpToolConfigOverrideOutput - `tool_name` (string, required) — Der Name des MCP-Tools - `pre_tool_speech` (enum, optional, default: auto) — Falls gesetzt, überschreibt dies die serverseitige Einstellung pre_tool_speech für dieses Tool. - Allowed values: `auto`, `force`, `off` - `interruption_mode` (enum, optional, default: allow) — Falls gesetzt, überschreibt dies die serverseitige Einstellung interruption_mode für dieses Tool. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `tool_call_sound` (McpToolConfigOverrideOutputToolCallSound, optional) — Überschreibt die tool_call_sound-Einstellung des Servers für dieses Tool. Ein Soundname spielt diesen Sound ab; 'off' überschreibt mit keinem Sound (Stille); null bedeutet nicht überschreiben (Serverstandard übernehmen). - `tool_call_sound_behavior` (enum, optional, default: auto) — Falls gesetzt, überschreibt dies die serverseitige Einstellung tool_call_sound_behavior für dieses Tool. - Allowed values: `auto`, `always` - `execution_mode` (enum, optional, default: immediate) — Falls gesetzt, überschreibt dies die serverseitige Einstellung execution_mode für dieses Tool. - Allowed values: `immediate`, `post_tool_speech`, `async` - `response_timeout_secs` (integer, optional) — Falls gesetzt, überschreibt dies das serverseitige Antwort-Timeout für dieses MCP-Tool (in Sekunden). - `assignments` (list of DynamicVariableAssignment, optional) — Zuweisungen dynamischer Variablen für dieses MCP-Tool - `input_overrides` (map from string to McpToolConfigOverrideOutputInputOverridesValue, optional) — Zuordnung von JSON-Pfaden zu Konfigurationen für Eingabeüberschreibungen - `response_mocks` (list of ToolResponseMockConfigOutput, optional) — Mock-Antworten mit optionalen Parameterbedingungen. Sie werden von oben nach unten ausgewertet; der erste Treffer gewinnt. - `force_pre_tool_speech` (boolean, optional, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Wenn festgelegt, überschreibt dies die Einstellung force_pre_tool_speech des Servers für dieses Tool. - `disable_interruptions` (boolean, optional, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Wenn festgelegt, überschreibt dies die Einstellung disable_interruptions des Servers für dieses Tool. ### ValidationErrorLocItem ### ConvAiSecretLocator Wird verwendet, um auf ein Secret aus dem Secret-Speicher des Agenten zu verweisen. - `secret_id` (string, required) ### ConvAiUserSecretDbModel Nutzerspezifisches Secret-Modell, das nicht mit anderen Nutzern in einem Workspace geteilt wird. - `name` (string, required) - `encrypted_value` (string, required) - `nonce` (string, required) - `id` (string, required) ### ConvAiDynamicVariable Wird verwendet, um auf eine dynamische Variable zu verweisen. - `variable_name` (string, required) ### ConvAiEnvVarLocator Wird verwendet, um über ihr Label auf eine Umgebungsvariable zu verweisen. - `env_var_label` (string, required) ### AuthConnectionLocator Wird verwendet, um auf eine Authentifizierungsverbindung aus dem Speicher für Authentifizierungsverbindungen des Workspace zu verweisen. - `auth_connection_id` (string, required) ### EnvironmentAuthConnectionLocator Verweist per Label auf eine Umgebungsvariable vom Typ 'auth_connection'. Zur Laufzeit wird die Authentifizierungsverbindung für die aktuelle Umgebung aufgelöst, wobei auf die Standardumgebung zurückgegriffen wird. - `env_var_label` (string, required) ### McpToolConfigOverrideOutputToolCallSound Überschreibt die tool_call_sound-Einstellung des Servers für dieses Tool. Ein Soundname spielt diesen Sound ab; 'off' überschreibt mit keinem Sound (Stille); null bedeutet nicht überschreiben (Serverstandard übernehmen). ### DynamicVariableAssignment Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen. - `dynamic_variable` (string, required) — Der Name der dynamischen Variable, der der extrahierte Wert zugewiesen wird - `value_path` (string, required) — Pfad in Punktnotation zum Extrahieren des Werts aus der Quelle (z. B. 'user.name' oder 'data.0.id') - `source` ("response", optional) — Die Quelle, aus der der Wert extrahiert wird. Derzeit wird nur „response“ unterstützt. - `sanitize` (boolean, optional, default: false) — Wenn true, wird der Wert dieser Zuweisung aus der Tool-Antwort entfernt, bevor sie an das LLM und Transkript gesendet wird, aber weiterhin für die Variablenzuweisung verarbeitet. - `preserve_native_type` (boolean, optional, default: false) — Wenn true, werden nicht skalare Werte (Listen, Objekte), die aus der Tool-Antwort extrahiert werden, in ihrem nativen Typ gespeichert, statt in JSON-Strings umgewandelt zu werden. Aktivieren Sie dies, um extrahierte Arrays direkt als dynamische Listenvariablen zu verwenden. ### McpToolConfigOverrideOutputInputOverridesValue - `source`: `constant` - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — Der zu verwendende konstante Wert - `source`: `dynamic_variable` - `dynamic_variable` (string, required) — Der Name der zu verwendenden dynamischen Variable - `source`: `llm` - `prompt` (string, optional) — Prompt-Überschreibung für das LLM. Wenn nicht angegeben, wird die ursprüngliche Schemabeschreibung verwendet. - `source`: `omit` ### ToolResponseMockConfigOutput - `mock_result` (string, required) — Der Rückgabewert, den das LLM sieht, wenn dieser Mock aktiv ist. - `parameter_conditions` (list of UnitTestToolCallParameter, optional) — Wenn die Liste leer ist, wird der Mock immer aktiviert. - `is_error` (boolean, optional, default: false) — Wenn true, wird das Mock-Ergebnis dem LLM als Tool-Fehler statt als erfolgreiches Ergebnis bereitgestellt. ### ConstantSchemaOverrideConstantValue Der zu verwendende konstante Wert ### UnitTestToolCallParameter - `eval` (UnitTestToolCallParameterEval, required) - `path` (string, required) ### UnitTestToolCallParameterEval - `type`: `anything` - `type`: `exact` - `expected_value` (string, required) — Der genaue Zeichenfolgenwert, dem der Parameter entsprechen muss. - `type`: `llm` - `description` (string, required) — Eine Beschreibung der für den Test zu verwendenden Bewertungsstrategie. - `type`: `regex` - `pattern` (string, required) — Ein Regex-Muster, mit dem die Antwort des Agenten abgeglichen wird. ## Examples **Response** ```json { "id": "id", "config": { "url": "url", "name": "name", "approval_policy": "auto_approve_all", "tool_approval_hashes": [ { "tool_name": "tool_name", "tool_hash": "tool_hash" } ], "transport": "SSE", "secret_token": { "secret_id": "secret_id" }, "request_headers": { "key": "value" }, "request_meta": { "key": "value" }, "auth_connection": { "auth_connection_id": "auth_connection_id" }, "description": "description", "pre_tool_speech": "auto", "interruption_mode": "allow", "tool_call_sound": "typing", "tool_call_sound_behavior": "auto", "execution_mode": "immediate", "response_timeout_secs": 1, "tool_config_overrides": [ { "tool_name": "tool_name", "assignments": [ { "dynamic_variable": "user_name", "value_path": "user.name", "source": "response", "sanitize": false, "preserve_native_type": false } ] } ], "disable_compression": true }, "metadata": { "created_at": 1, "owner_user_id": "owner_user_id" }, "access_info": { "is_creator": true, "creator_name": "John Doe", "creator_email": "john.doe@example.com", "role": "admin", "anonymous_access_level_override": "admin", "access_source": "creator" }, "dependent_agents": [ { "type": "available", "access_level": "admin", "created_at_unix_secs": 1, "id": "id", "name": "name", "referenced_resource_ids": [ "referenced_resource_ids" ] } ] } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name" response = requests.delete(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: 'DELETE'}; 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("DELETE", 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::Delete.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.delete("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name") .asString(); ``` ```php request('DELETE', '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.DELETE); 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 = "DELETE" 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() ```