Test MCP connection health
POST /api/mcp-connections/{id}/test
Performs a live health check against the MCP server. The test verifies that the server is reachable and authentication is valid. The connection’s status and lastHealthCheckAt fields are updated based on the result. Use this to verify connectivity after initial setup or to diagnose issues.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The unique identifier of the MCP connection to test.
Responses
Section titled “ Responses ”The health check completed. Check the ‘status’ field for the result (‘active’ or ‘error’).
Result of testing an MCP connection’s health. The test attempts to reach the server and verify authentication.
object
Result of the health check. ‘active’ means the server responded successfully. ‘error’ means the server was unreachable or returned an error.
Example
activeTimestamp of this health check.
Example
2026-03-27T10:15:00.000ZNo MCP connection exists with the given ID in the authenticated tenant.
Standard error response returned by all endpoints on failure.
object
A human-readable error message describing what went wrong.
Example
Conversation not found