Endpoint Check
HTTP probe (status + latency) and TLS certificate inspection (expiry, issuer, SANs).
SKILL.mdskills/endpoint-check/SKILL.md
GitHubEndpoint Check
Use when the user wants to verify that an HTTP endpoint is alive, measure its latency, or inspect a TLS certificate's expiry and issuer. Combines naturally with Phase 7 heartbeat for periodic monitoring.
Use when
- "Is my API up?"
- "How long until cert X expires?"
- "Check my endpoints and alert me if something fails" (pair with heartbeat)
- Verify that a deployment published new code (compare response body)
Do not use when
- You need complex auth (OAuth, mTLS) — use
fetch-urlor a dedicated extension - You need full body download — use
fetch-url - It is an internal container health check — use the orchestrator-native check
Tools
status
No args. Info + limits.
http_probe { url, method?, timeout_secs?, follow_redirects?, expected_status? }
urlrequired (http/https)methodGET (default) or HEADtimeout_secs1..60 (default 10)follow_redirectsdefault trueexpected_statusoptional: returnsmatches_expected: bool
Returns {status, latency_ms, final_url, content_type, body_preview (≤500 chars), [matches_expected]}.
ssl_cert { host, port?, timeout_secs?, warn_days? }
hostrequiredportdefault 443timeout_secs1..60 (default 10)warn_daysdefault 30 — setsexpiring_soon: truebelow threshold
Returns {subject, issuer, sans, serial_hex, signature_algorithm, chain_length, not_before_unix, not_after_unix, seconds_until_expiry, days_until_expiry, expiring_soon, expired}.
Note: this tool does not validate trust chains — expired/self-signed
certs still return parsed metadata. Use expired/expiring_soon to decide.
Execution guidance
- For periodic monitoring, combine with heartbeat: probe every N minutes
and alert when
statuschanges orexpiring_soonflips true. - For deploy comparisons, store baseline probe output in TaskFlow
state_jsonand diff against new runs. ssl_certis informational; for actionable alerts, usedays_until_expirywith a stricter threshold (e.g., 14 days).- Error
-32005timeout means server did not reply withintimeout_secs. - Errors
-32060/-32061inssl_certusually indicate DNS/TCP connect issues.