COconductorone
MCP Servers

Test Connection

Changed on

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

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/mcp_servers/test_connection
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

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

credentialVerifiedboolean

True when the upstream accepted the supplied credentials. For hosted configurations that means the catalog entry's auth_validation_url answered an authenticated tools/list. Always false when the configuration carries no credential.

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 a connection test completes successfully: the upstream was contacted with the supplied credentials. For hosted configurations that is an authenticated MCP tools/list against the catalog entry's auth_validation_url.

toolCountstring int64

Number of tools exposed by the connection test. For external configurations, this is the upstream tools/list result. For hosted configurations, this is the catalog tool surface. Zero when reachable=false. int64 to match MCPServerSearchWithToolCountResult.tool_count.

Changes