Resource Reality Check

Verify that a URL is reachable, DNS-valid, and TLS-secure before an agent reads, cites, or calls it.

⚡ 3 credits per call

Uses these tools

Domain Intelligence

Why use this

AI agents hallucinate URLs, operate on stale links, and call APIs that have moved. Run this before reading, citing, or calling anything. Three signals in one round trip: DNS resolution, HTTP reachability, and TLS validity.

Flags

Flag	Meaning
`dns_failed`	Domain does not resolve
`http_unreachable`	HTTP probe returned an error (timeout, connection refused)
`http_error`	HTTP status code ≥ 400
`ssl_invalid`	TLS certificate is invalid or expired
`ssl_expiring_soon`	Certificate expires within 30 days
`ssl_check_failed`	TLS probe failed (no HTTPS, connection refused)

A partial: true field is added when one or more signals failed to run. signals_checked tells you how many actually ran.

API Reference

Endpoint

POST https://api.lightningapi.tools/circuits/resource-reality-check

Required headers

Authorization: Bearer <apiKey>
Content-Type: application/json

Example request

{
  "url": "https://example.com"
}

Example response

{
  "reachable": true,
  "signals": {
    "dns_resolves": true,
    "http_status": 200,
    "content_type": "text/html",
    "ssl_valid": true,
    "ssl_days_remaining": 180
  },
  "flags": [],
  "anomaly_count": 0,
  "signals_checked": 3
}