hazards.securitygeek.io

{
  "name": "get_current_view",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns what the user currently sees in Nearcast: map centre, bounds, zoom, the active country/hazard-type/severity/magnitude filters, the selected hazard (if any), counts of hazards in view, and data freshness per source. Call this first to understand the shared state before changing it.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_visible_hazards",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the hazards currently visible in the user's Nearcast map after applying the active country, hazard type, severity, magnitude and geographic (map bounds) filters. Ordered by display significance. Concise records only; use get_hazard_details for full information.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 200,
        "description": "Maximum number of hazards to return (default 50)."
      },
      "hazardType": {
        "type": "string",
        "enum": [
          "wildfire",
          "weather",
          "earthquake"
        ],
        "description": "Optionally restrict to one hazard type."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "set_focus_area",
  "kind": "act",
  "impl": "imperative",
  "description": "Moves the user's map. Provide ONE of: `regions` (province/territory or state codes such as [\"BC\",\"WA\"] — the map fits all of them), explicit `bounds` (west/south/east/north in degrees), or `latitude`+`longitude` with optional `zoom`. The map visibly animates and the shared view state updates.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "regions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 1,
        "maxItems": 10,
        "description": "Region codes or names, e.g. [\"British Columbia\", \"WA\"]. Canadian provinces/territories and all US states are supported."
      },
      "bounds": {
        "type": "object",
        "properties": {
          "west": {
            "type": "number"
          },
          "south": {
            "type": "number"
          },
          "east": {
            "type": "number"
          },
          "north": {
            "type": "number"
          }
        },
        "required": [
          "west",
          "south",
          "east",
          "north"
        ],
        "description": "Bounding box in WGS84 degrees."
      },
      "latitude": {
        "type": "number",
        "minimum": -90,
        "maximum": 90
      },
      "longitude": {
        "type": "number",
        "minimum": -180,
        "maximum": 180
      },
      "zoom": {
        "type": "number",
        "minimum": 1,
        "maximum": 15,
        "description": "Map zoom level when centering on a point (default 8)."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "set_hazard_filters",
  "kind": "act",
  "impl": "imperative",
  "description": "Updates the hazard filters shared with the user (map and list update visibly). Only the provided fields change. `minimumSeverity` applies to weather alerts (agency-issued severity: info < minor < moderate < severe < extreme); `minimumEarthquakeMagnitude` applies to earthquakes. Wildfires are not filtered by severity. Pass null to clear a minimum.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "countries": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "CA",
            "US"
          ]
        },
        "minItems": 1,
        "description": "Countries to show, e.g. [\"CA\"] or [\"CA\",\"US\"]."
      },
      "hazardTypes": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "wildfire",
            "weather",
            "earthquake"
          ]
        },
        "minItems": 1,
        "description": "Hazard types to show."
      },
      "minimumSeverity": {
        "type": [
          "string",
          "null"
        ],
        "enum": [
          "info",
          "minor",
          "moderate",
          "severe",
          "extreme",
          null
        ],
        "description": "Minimum weather-alert severity, or null for all."
      },
      "minimumEarthquakeMagnitude": {
        "type": [
          "number",
          "null"
        ],
        "minimum": 0,
        "maximum": 10,
        "description": "Minimum earthquake magnitude, or null for all."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "focus_hazard",
  "kind": "act",
  "impl": "imperative",
  "description": "Selects one hazard for the user: highlights it on the map, pans/zooms to it and opens its details panel — the same selection a human makes by clicking a marker. Returns a concise summary of the hazard. Use get_hazard_details for the full record.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hazardId": {
        "type": "string",
        "description": "Nearcast hazard id, e.g. \"usgs:us7000abcd\" or \"eccc:…\"."
      }
    },
    "required": [
      "hazardId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_hazard_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the complete normalized record for one hazard: description, agency-issued classifications, timestamps, measurements (magnitude, hectares, containment…), issuing agency and the official source link. Does not change the user's view.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hazardId": {
        "type": "string",
        "description": "Nearcast hazard id."
      }
    },
    "required": [
      "hazardId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "compare_regions",
  "kind": "act",
  "impl": "imperative",
  "description": "Deterministically compares two or more Canadian provinces/territories and/or US states using all currently loaded hazards (current filters are NOT applied): wildfire count, out-of-control wildfires, reported hectares, weather alert counts, earthquake counts and significant (M4.0+) earthquakes. Counts only; no safety judgements.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "regions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 2,
        "maxItems": 8,
        "description": "Region codes or names, e.g. [\"BC\", \"WA\"] or [\"Alberta\", \"British Columbia\"]."
      }
    },
    "required": [
      "regions"
    ],
    "additionalProperties": false
  }
}

{
  "name": "create_situation_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns a structured, deterministic situation snapshot for an area — the current map view by default, or the given regions — listing the most significant wildfires, weather alerts and earthquakes with counts and source status. Nearcast supplies facts; the agent writes any narrative. No safety conclusions are included.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "regions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 1,
        "maxItems": 8,
        "description": "Optional region codes/names. Omit to use the user's current map view and filters."
      },
      "maxPerType": {
        "type": "integer",
        "minimum": 1,
        "maximum": 25,
        "description": "Max hazards listed per type (default 8)."
      }
    },
    "additionalProperties": false
  }
}