Get MCP server

curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \
     -H "Content-Type: application/json"

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcp.example.com/api/v1/tools",
    "name": "Primary MCP Server",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "DataFetcher",
        "tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f67890abcdef1234567890abcdef12",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
    },
    "request_headers": {
      "Authorization": "Bearer {{token}}",
      "X-Custom-Header": "custom-value"
    },
    "auth_connection": {
      "auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
    },
    "description": "Handles all primary tool executions for the workspace.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 60,
    "tool_config_overrides": [
      {
        "tool_name": "DataFetcher",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 15,
        "assignments": [
          {
            "dynamic_variable": "fetched_data",
            "value_path": "data.results",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": true
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"results\": [{\"id\": 1, \"value\": \"mocked data\"}]}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "expected_value": "test"
                },
                "path": "parameters.query"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1686000000,
    "owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1686000000,
      "id": "agent-9876abcd-1234-ef56-7890-abcdef654321",
      "name": "Support Agent",
      "referenced_resource_ids": [
        "agent-9876abcd-1234-ef56-7890-abcdef654321"
      ]
    }
  ]
}

curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \
     -H "Content-Type: application/json"

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcp.example.com/api/v1/tools",
    "name": "Primary MCP Server",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "DataFetcher",
        "tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f67890abcdef1234567890abcdef12",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
    },
    "request_headers": {
      "Authorization": "Bearer {{token}}",
      "X-Custom-Header": "custom-value"
    },
    "auth_connection": {
      "auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
    },
    "description": "Handles all primary tool executions for the workspace.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 60,
    "tool_config_overrides": [
      {
        "tool_name": "DataFetcher",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 15,
        "assignments": [
          {
            "dynamic_variable": "fetched_data",
            "value_path": "data.results",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": true
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"results\": [{\"id\": 1, \"value\": \"mocked data\"}]}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "expected_value": "test"
                },
                "path": "parameters.query"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1686000000,
    "owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1686000000,
      "id": "agent-9876abcd-1234-ef56-7890-abcdef654321",
      "name": "Support Agent",
      "referenced_resource_ids": [
        "agent-9876abcd-1234-ef56-7890-abcdef654321"
      ]
    }
  ]
}

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_infoobject or null

The access information of the MCP Server

dependent_agentslist of objects

List of agents that depend on this MCP Server.

Errors

422

Unprocessable Entity Error

Get MCP server

Path parameters

Headers

Response

Errors

Path parameters

Headers

Response

Errors

$	curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \
>	-H "Content-Type: application/json"

1	{
2	"id": "mcp-123e4567-e89b-12d3-a456-426614174000",
3	"config": {
4	"url": "https://mcp.example.com/api/v1/tools",
5	"name": "Primary MCP Server",
6	"approval_policy": "require_approval_all",
7	"tool_approval_hashes": [
8	{
9	"tool_name": "DataFetcher",
10	"tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f67890abcdef1234567890abcdef12",
11	"approval_policy": "requires_approval"
12	}
13	],
14	"transport": "SSE",
15	"secret_token": {
16	"secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
17	},
18	"request_headers": {
19	"Authorization": "Bearer {{token}}",
20	"X-Custom-Header": "custom-value"
21	},
22	"auth_connection": {
23	"auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
24	},
25	"description": "Handles all primary tool executions for the workspace.",
26	"pre_tool_speech": "auto",
27	"disable_interruptions": false,
28	"tool_call_sound": "typing",
29	"tool_call_sound_behavior": "auto",
30	"execution_mode": "immediate",
31	"response_timeout_secs": 60,
32	"tool_config_overrides": [
33	{
34	"tool_name": "DataFetcher",
35	"pre_tool_speech": "auto",
36	"disable_interruptions": true,
37	"tool_call_sound": "typing",
38	"tool_call_sound_behavior": "auto",
39	"execution_mode": "immediate",
40	"response_timeout_secs": 15,
41	"assignments": [
42	{
43	"dynamic_variable": "fetched_data",
44	"value_path": "data.results",
45	"source": "response",
46	"sanitize": false,
47	"preserve_native_type": true
48	}
49	],
50	"input_overrides": {},
51	"response_mocks": [
52	{
53	"mock_result": "{\"results\": [{\"id\": 1, \"value\": \"mocked data\"}]}",
54	"parameter_conditions": [
55	{
56	"eval": {
57	"type": "exact",
58	"expected_value": "test"
59	},
60	"path": "parameters.query"
61	}
62	]
63	}
64	],
65	"force_pre_tool_speech": true
66	}
67	],
68	"disable_compression": false,
69	"force_pre_tool_speech": false
70	},
71	"metadata": {
72	"created_at": 1686000000,
73	"owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
74	},
75	"access_info": {
76	"is_creator": true,
77	"creator_name": "John Doe",
78	"creator_email": "john.doe@example.com",
79	"role": "admin",
80	"access_source": "creator"
81	},
82	"dependent_agents": [
83	{
84	"type": "available",
85	"access_level": "admin",
86	"created_at_unix_secs": 1686000000,
87	"id": "agent-9876abcd-1234-ef56-7890-abcdef654321",
88	"name": "Support Agent",
89	"referenced_resource_ids": [
90	"agent-9876abcd-1234-ef56-7890-abcdef654321"
91	]
92	}
93	]
94	}