Detect MCP connection¶

Probes the MCP service and returns discoverable tools; probing does not save connections.

HTTP
POST $CLOUDSIGMA_API_BASE/workspaces/{workspace_id}/connections/actions/probe-mcp

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

Request¶

Input examples

Shell
curl -X POST "$CLOUDSIGMA_API_BASE/workspaces/$WORKSPACE_ID/connections/actions/probe-mcp" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "endpoint_uri": "https://mcp.example.com",
    "transport": "http-streaming"
  }'

Parameter reference

Request body

Parameters	Type	Is it required	Description
`endpoint_uri`	string	No	MCP service address to probe. Required if `connection_id` is not provided.
`connection_id`	string	No	The saved connection ID. Required if `endpoint_uri` is not provided.
`auth_type`	string	No	Authentication type.
`api_key_header`	string	No	The request header name used by API Key.
`credential`	object	No	Credentials to use when probing, can contain `bearer_token`, `api_key`, `basic_username`, `basic_password`, or `custom_headers`.
`transport`	string	No	MCP transmission method: `sse` or `http-streaming`. Use `http-streaming` when not provided.

Successful response¶

Returns 200 and the found tool on success.

Response example

JSON
{"code":0,"data":{"tools":[]}}

Field reference

The response fields are as follows.

Field	Type	Description
`data.tool_count`	integer	The number of tools found.
`data.tools`	array	Tools returned by MCP service.
`data.protocol_version`	string	MCP protocol version; will not be returned if not provided.

Error response¶

Response example

JSON
{"code":2,"message":"invalid request body"}

Last updated on Sep 15, 2026