check_upstream_health
Probe an upstream host:port over TCP to confirm it is listening before creating a site or when debugging a 502 error.
Instructions
TCP-probe an upstream host:port to confirm something is actually listening there, independent of nginx or DNS. Use to sanity-check an upstream before create_site, or to debug a 502 afterward. For confirming a public domain resolves, use check_dns instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"upstream_host": "<upstream_host>",
"upstream_port": "<upstream_port>"
},
"name": "check_upstream_health"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| timeout_ms | No | Milliseconds to wait before reporting unreachable | |
| upstream_host | Yes | Hostname or IP that nginx would proxy_pass to | |
| upstream_port | Yes | TCP port to probe |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Human-readable outcome, e.g. success, timeout, or connection error detail | |
| reachable | Yes |