Create configuration override

curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "string"
}'

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "string",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 1,
        "assignments": [
          {
            "dynamic_variable": "string",
            "value_path": "string",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "string",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "string",
                  "description": "string"
                },
                "path": "string"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

Create configuration overrides for a specific MCP tool.

curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "string"
}'

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "string",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 1,
        "assignments": [
          {
            "dynamic_variable": "string",
            "value_path": "string",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "string",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "string",
                  "description": "string"
                },
                "path": "string"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

Create configuration overrides for a specific MCP tool.

Path parameters

mcp_server_idstringRequired

ID of the MCP Server.

Request

This endpoint expects an object.

tool_namestringRequired

The name of the MCP tool

pre_tool_speechenum or nullOptionalDefaults to auto

If set, overrides the server’s pre_tool_speech setting for this tool.

Allowed values:

disable_interruptionsboolean or nullOptional

If set, overrides the server’s disable_interruptions setting for this tool

tool_call_soundenum or nullOptional

If set, overrides the server’s tool_call_sound setting for this tool

Allowed values:

tool_call_sound_behaviorenum or nullOptionalDefaults to auto

If set, overrides the server’s tool_call_sound_behavior setting for this tool

Allowed values:

execution_modeenum or nullOptionalDefaults to immediate

If set, overrides the server’s execution_mode setting for this tool

Allowed values:

response_timeout_secsinteger or nullOptional5-300

If set, overrides the server's response timeout for this MCP tool.

assignmentslist of objects or nullOptional

Dynamic variable assignments for this MCP tool

input_overridesmap from strings to objects or nullOptional

Mapping of json path to input override configuration

response_mockslist of objects or nullOptional

Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.

force_pre_tool_speechboolean or nullOptionalDeprecated

DEPRECATED: use pre_tool_speech instead. If set, overrides the server’s force_pre_tool_speech setting for this tool.

Response

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobject or null

The access information of the MCP Server

dependent_agentslist of objects

List of agents that depend on this MCP Server.

Errors

409

Conflict Error

422

Unprocessable Entity Error

Create configuration override

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors

$	curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs \
>	-H "Content-Type: application/json" \
>	-d '{
>	"tool_name": "string"
>	}'

1	{
2	"id": "string",
3	"config": {
4	"url": "string",
5	"name": "string",
6	"approval_policy": "require_approval_all",
7	"tool_approval_hashes": [
8	{
9	"tool_name": "string",
10	"tool_hash": "string",
11	"approval_policy": "requires_approval"
12	}
13	],
14	"transport": "SSE",
15	"secret_token": {
16	"secret_id": "string"
17	},
18	"request_headers": {},
19	"auth_connection": {
20	"auth_connection_id": "string"
21	},
22	"description": "",
23	"pre_tool_speech": "auto",
24	"disable_interruptions": false,
25	"tool_call_sound": "typing",
26	"tool_call_sound_behavior": "auto",
27	"execution_mode": "immediate",
28	"response_timeout_secs": 30,
29	"tool_config_overrides": [
30	{
31	"tool_name": "string",
32	"pre_tool_speech": "auto",
33	"disable_interruptions": true,
34	"tool_call_sound": "typing",
35	"tool_call_sound_behavior": "auto",
36	"execution_mode": "immediate",
37	"response_timeout_secs": 1,
38	"assignments": [
39	{
40	"dynamic_variable": "string",
41	"value_path": "string",
42	"source": "response",
43	"sanitize": false,
44	"preserve_native_type": false
45	}
46	],
47	"input_overrides": {},
48	"response_mocks": [
49	{
50	"mock_result": "string",
51	"parameter_conditions": [
52	{
53	"eval": {
54	"type": "string",
55	"description": "string"
56	},
57	"path": "string"
58	}
59	]
60	}
61	],
62	"force_pre_tool_speech": true
63	}
64	],
65	"disable_compression": false,
66	"force_pre_tool_speech": false
67	},
68	"metadata": {
69	"created_at": 1,
70	"owner_user_id": "string"
71	},
72	"access_info": {
73	"is_creator": true,
74	"creator_name": "John Doe",
75	"creator_email": "john.doe@example.com",
76	"role": "admin"
77	},
78	"dependent_agents": [
79	{
80	"type": "available",
81	"access_level": "admin",
82	"created_at_unix_secs": 1,
83	"id": "string",
84	"name": "string",
85	"referenced_resource_ids": [
86	"string"
87	]
88	}
89	]
90	}