MCP Gateway
ApiMcp servers

Check server health

Check health of an MCP server by attempting to connect and list its tools. Updates status to RUNNING if successful, ERROR if failed.

POST
/api/v1/servers/{server_id}/health

Path Parameters

server_id*string
Formatuuid

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/health"
{
  "server_id": "820efca4-4a15-4ab7-82fc-9e76f6d61325",
  "server_name": "string",
  "previous_status": "pending",
  "current_status": "pending",
  "message": "string",
  "checked_at": "2019-08-24T14:15:22Z"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Check all servers health

Check health of all MCP servers and update their statuses. Returns aggregated results with counts by status.

Configure server OAuth

Configure OAuth for an MCP server, enabling per-user OAuth authentication. The client_secret is encrypted at rest using AES-256-GCM.