Skip to main content

Validate MCP Server On-Demand

POST 
/v1/mcp-servers/:server_id/validate

Trigger on-demand validation of an existing MCP server.

Performs immediate synchronous validation by executing an MCP protocol handshake with the server. Returns validation results including health status, validation state, and any failures encountered.

Use Cases:

  • Re-validate server after configuration changes
  • Troubleshoot connectivity issues
  • Verify server health before operations
  • Refresh server information (version, protocol)

Behavior:

  • Synchronous operation - returns results immediately
  • Updates server state: status, validationState, healthState, lastValidatedAt
  • MCP handshake timeout: Configured per-server (default 180s)

Status Codes:

  • 200: Validation completed (check validationState: validated or failed)
  • 400: Validation error (invalid parameters)
  • 403: Not authorized (requires CREATE or EDIT permission, must be in same environment)
  • 404: Server not found
  • 500: Internal server error

Important:

  • Validation failure returns 200 OK with validationState: "failed"
  • Check failures array for detailed error information
  • System errors return 500 (validation couldn't execute)

⚠️ BETA: Endpoint behavior and response schema may change in future releases.

Request​

Responses​

Validation completed - check validationState field for success/failure