Earth & Sky

Is tonight actually usable for stargazing or astrophotography? Combines real dark hours and true moon illumination (computed from first principles) with live hourly cloud cover, weighting low cloud above high cloud. Returns a 0-100 usability score per night hour, the best consecutive usable run, and a plain verdict. lat/lon required; tz_offset and when optional.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude, -90..90."
    },
    "lon": {
      "type": "number",
      "description": "Longitude, -180..180."
    },
    "tz_offset": {
      "type": "number",
      "description": "Hours offset from UTC for local clock labels. Default: estimated from longitude."
    },
    "when": {
      "type": "string",
      "description": "Optional ISO date/time to plan for. Default now."
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}

Stateful quake subscriptions. Unlike a local tool, the filter and its cursor are stored on the server, so poll returns ONLY events newer than your last poll - no re-scanning, no client-side dedupe. Actions: create (min_magnitude, place), poll (id), list, delete (id).

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "create",
        "poll",
        "list",
        "delete"
      ],
      "description": "create a subscription, poll it, list yours, or delete one."
    },
    "id": {
      "type": "string",
      "description": "Subscription id (for poll/delete)."
    },
    "min_magnitude": {
      "type": "number",
      "description": "Minimum magnitude for create. Default 0."
    },
    "place": {
      "type": "string",
      "description": "Substring place filter for create, e.g. 'Japan'."
    },
    "since_hours": {
      "type": "number",
      "description": "On create, seed the cursor this many hours back so the very first poll can return existing events. Default 0 (only new events)."
    },
    "owner": {
      "type": "string",
      "description": "Optional namespace to group subscriptions. Default 'public'."
    }
  },
  "required": [
    "action"
  ]
}

Recent earthquakes from USGS. Filter by window (hour/day/week/month), minimum magnitude, and place text. Returns magnitude, place, depth, time.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month"
      ],
      "description": "Lookback window. Default day."
    },
    "min_magnitude": {
      "type": "number",
      "description": "Minimum magnitude, e.g. 4.5. Default 0."
    },
    "place": {
      "type": "string",
      "description": "Substring match on the place name, e.g. 'Japan'. Not a geographic polygon search."
    },
    "limit": {
      "type": "integer",
      "description": "Max events returned, 1-100. Default 20."
    }
  }
}

Current weather and the next 12 hours for a latitude/longitude, from Open-Meteo. No API key required.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "description": "-90 to 90."
    },
    "longitude": {
      "type": "number",
      "description": "-180 to 180."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ]
}

Current latitude/longitude of the International Space Station.

{
  "type": "object",
  "properties": {}
}

One-shot summary of what is happening on Earth right now: 24h earthquake totals plus current ISS position.

{
  "type": "object",
  "properties": {}
}

Real sky for a place and night: sunrise/sunset, moonrise/moonset, true moon phase and illumination, and the best dark window for stargazing. Computed from first principles (no key, no ephemeris file).

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude in degrees (-90..90)"
    },
    "lon": {
      "type": "number",
      "description": "Longitude in degrees (-180..180)"
    },
    "tz_offset": {
      "type": "number",
      "description": "Hours offset from UTC (optional)"
    },
    "when": {
      "type": "string",
      "description": "ISO date/time to use instead of now (optional)"
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}

Current (or given date's) moon phase and illumination for a location.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude in degrees"
    },
    "lon": {
      "type": "number",
      "description": "Longitude in degrees"
    },
    "when": {
      "type": "string",
      "description": "ISO date/time (optional)"
    }
  }
}

The real sky for a place and an instant: sunrise/sunset, moonrise/moonset, true moon phase and illumination, and the best dark window for stargazing. Pure astronomy, no API key.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude, decimal degrees."
    },
    "lon": {
      "type": "number",
      "description": "Longitude, decimal degrees."
    },
    "tz_offset": {
      "type": "number",
      "description": "Local UTC offset in hours. Optional."
    },
    "when": {
      "type": "string",
      "description": "ISO date/datetime UTC. Defaults to now."
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}