Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

MCP Servers

Test Connection

TestConnection probes an MCP server with the supplied URL + transport + plaintext credentials and reports whether a real MCP initialize + tools/list succeeded.

post/api/v1/mcp_servers/test_connection

Request body

appIdstring

App ID of an existing external MCP connector. When set together with connector_id, the request runs in edit mode (see above).

connectorIdstring

Connector ID of an existing external MCP connector. When set together with app_id, the request runs in edit mode (see above).

updateMaskstring nullable

Response

Successful response

failureReasonstring

Sanitized, human-readable explanation of why the probe failed, set only when reachable=false (e.g. "MCP server unreachable or rejected the credentials (HTTP 401 Unauthorized)"). Empty when reachable=true. Never contains raw upstream response bytes.

reachableboolean

True when the MCP initialize handshake AND a tools/list call both succeeded against the upstream with the supplied credentials. False when the probe ran but the upstream was unreachable or rejected the request — see failure_reason. Malformed requests (missing/invalid config, bad permissions) are returned as a gRPC error, not reachable=false.

toolCountstring int64

Number of tools advertised by the upstream's tools/list response. Zero when reachable=false; can also legitimately be zero when the server is reachable but exposes no tools. int64 to match MCPServerSearchWithToolCountResult.tool_count.