Detect MCP connection¶

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

POST https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/connections/actions/probe-mcp

Before you call¶

The example below uses:

$AI_STUDIO_API_KEY: The actual personal access token, passed through the X-API-Key Header.
$WORKSPACE_ID: Target workspace ID, passed through X-Workspace-ID Header.

Request example¶

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

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.

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

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¶

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

Last updated on Sep 3, 2026