Get MCP server

GET

/v1/convai/mcp-servers/:mcp_server_id

GET

/v1/convai/mcp-servers/:mcp_server_id

$ curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id

1 {
2   "id": "id",
3   "config": {
4     "url": "url",
5     "name": "name",
6     "approval_policy": "auto_approve_all",
7     "tool_approval_hashes": [
8       {
9         "tool_name": "tool_name",
10         "tool_hash": "tool_hash"
11       }
12     ],
13     "transport": "SSE",
14     "secret_token": {
15       "secret_id": "secret_id"
16     },
17     "request_headers": {
18       "key": "value"
19     },
20     "request_meta": {
21       "key": "value"
22     },
23     "auth_connection": {
24       "auth_connection_id": "auth_connection_id"
25     },
26     "description": "description",
27     "pre_tool_speech": "auto",
28     "interruption_mode": "allow",
29     "tool_call_sound": "typing",
30     "tool_call_sound_behavior": "auto",
31     "execution_mode": "immediate",
32     "response_timeout_secs": 1,
33     "tool_config_overrides": [
34       {
35         "tool_name": "tool_name",
36         "assignments": [
37           {
38             "dynamic_variable": "user_name",
39             "value_path": "user.name",
40             "source": "response",
41             "sanitize": false,
42             "preserve_native_type": false
43           }
44         ]
45       }
46     ],
47     "disable_compression": true
48   },
49   "metadata": {
50     "created_at": 1,
51     "owner_user_id": "owner_user_id"
52   },
53   "access_info": {
54     "is_creator": true,
55     "creator_name": "John Doe",
56     "creator_email": "john.doe@example.com",
57     "role": "admin",
58     "anonymous_access_level_override": "admin",
59     "access_source": "creator"
60   },
61   "dependent_agents": [
62     {
63       "type": "available",
64       "access_level": "admin",
65       "created_at_unix_secs": 1,
66       "id": "id",
67       "name": "name",
68       "referenced_resource_ids": [
69         "referenced_resource_ids"
70       ]
71     }
72   ]
73 }

Retrieve a specific MCP server configuration from the workspace.

Path parameters

mcp_server_idstringRequired

ID of the MCP Server.

Response

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobjectOptional

The access information of the MCP Server

dependent_agentslist of objectsOptional

List of agents that depend on this MCP Server.

Errors

422

Mcp Servers Get Request Unprocessable Entity Error

Path parameters

Headers

Response

Errors