{
 "name": "Ground Truth Worldwide",
 "version": "1.0.0",
 "audience": "AI agents",
 "description": "Cited, time-stamped public facts for anywhere on Earth from free public sources.",
 "base_url": "https://gt.llpro.ai",
 "listed": true,
 "endpoints": {
  "ask": {
   "method": "POST",
   "url": "https://gt.llpro.ai/v1/ask",
   "body": {
    "topic": "weather|weather_alerts|river_level|flood|earthquakes|disasters|air_quality|road_closures|power_outages|burn_ban",
    "place": "Lafayette or Lagos, Nigeria",
    "lat": "optional",
    "lon": "optional",
    "max_age_minutes": "optional"
   }
  },
  "ask_get": "https://gt.llpro.ai/v1/ask?topic=river_level&place=Lafayette",
  "mcp": "https://gt.llpro.ai/mcp",
  "sources": "https://gt.llpro.ai/v1/sources",
  "track_record": "https://gt.llpro.ai/v1/track-record"
 },
 "answer_format": [
  "fact",
  "place",
  "time",
  "source_url",
  "age_seconds",
  "stale",
  "confidence"
 ],
 "auth": "none. Send X-Agent-Id: <your stable id> for your own metering and track record.",
 "pricing": {
  "free": {
   "calls_per_day_per_agent": 100
  },
  "paid": {
   "enabled": false,
   "planned_usd_per_call": "0.002",
   "rails": [
    "x402 (USDC on Base)",
    "Stripe agent checkout"
   ],
   "status": "planned, not charging"
  }
 },
 "freshness_policy": "Every answer carries age_seconds; answers older than the topic limit are marked stale=true with confidence <= 0.4.",
 "topics": {
  "weather": "Current weather anywhere on Earth (Open-Meteo, modelled from national weather services).",
  "weather_alerts": "Official weather alerts. Live for the US (NWS); other countries say 'not connected' until a national feed is added.",
  "river_level": "River gauge height and flow near a place (USGS gauges in the US; GloFAS modelled discharge worldwide).",
  "flood": "Flood alerts (NWS, US) plus river discharge outlook (GloFAS, worldwide) and nearby US gauges.",
  "earthquakes": "Earthquakes of magnitude 2.5+ within 300 km of a place in the last 7 days, worldwide (USGS).",
  "disasters": "Active Orange/Red disaster alerts within 500 km, worldwide: cyclones, floods, volcanoes, drought, wildfire, quakes (GDACS).",
  "air_quality": "Current US AQI and PM2.5 anywhere (modelled, Open-Meteo/CAMS).",
  "road_closures": "Road and ferry closures. NOT CONNECTED yet (national feeds mostly need registered keys).",
  "power_outages": "Power outages. NOT CONNECTED yet (no open worldwide machine feed found).",
  "burn_ban": "Burn bans. NOT CONNECTED; US Red Flag fire-weather warnings are returned instead."
 }
}