Skip to main content

agent_health

Check whether a specific fleet agent is healthy. Calls the agent gateway's GET /health endpoint and returns its JSON body verbatim.

Arguments​

ArgumentTypeRequiredNotes
namestringyesAgent name from agents.json

Return value​

A text content block containing the raw JSON returned by the gateway's /health endpoint. The shape is whatever the gateway emits — the bridge does not transform it.

Example call​

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"agent_health","arguments":{"name":"researcher"}}}

Example result (gateway-specific):

{"ok":true,"uptime":12345.6}

Failure modes​

ErrorCause
unknown agent: {name}Name not in agents.json
Abort/network error wrapped as fleet-bridge error: ...Gateway unreachable, connection refused, or the call exceeded the timeout

The health call is bounded by an abort timeout controlled by FLEET_BRIDGE_HEALTH_TIMEOUT_MS (default 5000 milliseconds). A slow or hung gateway aborts within that window and the call returns an error — there is no retry.

Note that HTTP-level non-2xx responses are not explicitly checked: the bridge returns whatever /health responds with (attempting to parse it as JSON), so a gateway returning non-JSON on /health surfaces a JSON parse error rather than a status code.