Endpoint Reachability Check
check_endpointPreflight an unfamiliar public URL or API before an AI agent relies on it. It performs one live fetch and returns a PASS/WARN/FAIL verdict with HTTP status, content type, response time, final URL/redirect behavior, auth and rate-limit signals, and a short response sample. A PASS proves only that this fetch succeeded at check time; it does not validate authenticated flows, POST side effects, JavaScript execution, or business logic.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL or bare domain to probe. Bare domains like google.com are accepted and normalized to https:// automatically. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Normalized URL that was actually fetched. | |
| error | No | Validation or network error when the request could not be completed. | |
| status | No | HTTP status code returned by the endpoint, when a response was received. | |
| summary | Yes | Short human-readable explanation of the verdict. | |
| verdict | Yes | Operational preflight verdict. It is evidence for an agent decision, not a security guarantee. | |
| evidence | Yes | Structured observations used to produce the verdict. | |
| finalUrl | No | Final response URL when the runtime exposes it. | |
| inputUrl | No | Original user input when normalization changed it, for example when https:// was added. | |
| next_step | Yes | Agent-readable follow-up for sources that should remain trustworthy over time. | |
| accessible | Yes | True when the endpoint returned a 2xx HTTP status. | |
| redirected | No | True when the fetch followed a redirect to a different final URL. | |
| contentType | No | Response Content-Type header, if present. | |
| rateLimited | No | True when the server responded with 429 Too Many Requests. | |
| authRequired | No | True when the server responded with 401 or 403, which usually means credentials are required. | |
| responseTimeMs | No | Elapsed request time in milliseconds. | |
| sampleResponse | No | First 1,000 characters of the response body for quick inspection. Use this as a debugging hint only; it may be truncated and should not be treated as a complete page capture. | |
| recommended_action | Yes | Suggested next step based only on observed response behavior. |