Skip to main content
Glama

Criora: climate & disaster risk for any place

The weather ahead and the long-term climate over a country or a region

get_area_risk
Read-onlyIdempotent

The next 1 to 7 days' weather danger over a whole country or region, day by day: the worst class reached, its hazard, the share of the area at each class, the worst point and the cities most at risk; with categories or layers, also long-term climate layers over the area (mean, 10th and 90th percentile, share at or above a value).

Use for "how bad is the weather in Japan this week", "how much of Spain faces high heat tomorrow", "how much of Bangladesh floods in a 100-year flood". One place: get_forecast or get_climate_profile.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_area_risk"
  }
}

Input Schema

NameRequiredDescriptionDefault
bboxNoOr the area is this region, as [west, south, east, north] in degrees; across 180, give east past 180
daysNoThe window: the next 1 to 7 days from now
aboveNoWith categories or layers: give each layer's share of the area at or above this value, in the layer's own unit (1.0 with flood_riverine/inundation: the share under at least 1 m of a 100-year river flood). The flood layers give it at 0.5 m when omitted
hazardNoOnly this hazard; every hazard when omitted
layersNoAlso read these climate layers over the area, by id, e.g. flood_riverine/inundation; fetch catalog:layers lists every id
countryNoThe area is this country or territory: its ISO 3166-1 alpha-3 code (e.g. JPN) or its name
categoriesNoAlso read the long-term climate layers of these categories over the area. misc holds Köppen climate zone, now and in 2050 and 2080, solar radiation, solar radiation of the sunniest month, surface runoff; fetch catalog:layers lists every layer
response_formatNoconcise (default) answers the question; detailed adds every field the sources giveconcise

Output Schema

NameRequiredDescriptionDefault
runYes
daysYes
levelYes
notesNo
whereYes
creditYes
hazardYes
layersNo
peopleYes
placesYes
sourceYes
windowYes
filtersYes
grid_kmYes
sourcesNo
area_km2Yes
datasetsNo
timezoneYes
truncatedNo
risk_scaleYes
worst_pointYes
cells_sampledYes
places_matchedYes
smaller_than_a_cellYes
share_at_high_or_aboveYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed205 schema fields changed
    • removedOutput schema / $defs / AreaClass / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / AreaClass / properties / label / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / AreaClass / properties / label / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClass / properties / share / description
      Removed value: -"Of the area the layer holds classes in"
    • removedOutput schema / $defs / AreaClimateLayer / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / AreaClimateLayer / properties / applicable / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / applicable / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / applicable / description
      Removed value: -"Given only on a layer without readings"
    • addedOutput schema / $defs / AreaClimateLayer / properties / applicable / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / available / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / available / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / available / description
      Removed value: -"Given only on a layer without readings"
    • addedOutput schema / $defs / AreaClimateLayer / properties / available / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / category / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / AreaClimateLayer / properties / category / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / cell_km / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / cell_km / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / cell_km / description
      Removed value: -"The size of the cell the value is read on"
    • addedOutput schema / $defs / AreaClimateLayer / properties / cell_km / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / cells_sampled / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / cells_sampled / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / cells_sampled / description
      Removed value: -"The layer's own cells the area covers"
    • addedOutput schema / $defs / AreaClimateLayer / properties / cells_sampled / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / description / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / description / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / description / description
      Removed value: -"Absent where datasets gives it for the dataset"
    • addedOutput schema / $defs / AreaClimateLayer / properties / description / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / name / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / name / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / name / description
      Removed value: -"What the layer measures, in plain words"
    • addedOutput schema / $defs / AreaClimateLayer / properties / name / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / note / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / note / default
      Removed value: -null
    • addedOutput schema / $defs / AreaClimateLayer / properties / note / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / share_with_data / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / share_with_data / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / share_with_data / description
      Removed value: -"The share of the area the layer holds values in"
    • addedOutput schema / $defs / AreaClimateLayer / properties / share_with_data / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / source / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / source / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / source / description
      Removed value: -"A key of sources"
    • addedOutput schema / $defs / AreaClimateLayer / properties / source / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / source_detail / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / source_detail / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / source_detail / description
      Removed value: -"What this layer's source says that its other layers' do not"
    • addedOutput schema / $defs / AreaClimateLayer / properties / source_detail / type
      Added value: +[
      +  "object",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / unit / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / unit / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / unit / description
      Removed value: -"The unit every reading of the layer shares"
    • addedOutput schema / $defs / AreaClimateLayer / properties / unit / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaClimateLayer / properties / values / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / values / description
      Removed value: -"The readings, by band"
    • removedOutput schema / $defs / AreaClimateLayer / properties / year / anyOf
      Removed value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaClimateLayer / properties / year / default
      Removed value: -null
    • removedOutput schema / $defs / AreaClimateLayer / properties / year / description
      Removed value: -"The year an ERA5 layer describes"
    • addedOutput schema / $defs / AreaClimateLayer / properties / year / type
      Added value: +[
      +  "integer",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaDay / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / AreaDay / properties / date / description
      Removed value: -"The day in the area's time zone"
    • removedOutput schema / $defs / AreaDay / properties / hazard / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaDay / properties / hazard / description
      Removed value: -"The hazard holding the most of the area at that class"
    • addedOutput schema / $defs / AreaDay / properties / hazard / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaDay / properties / level / description
      Removed value: -"The worst class any of the area reaches that day"
    • removedOutput schema / $defs / AreaDay / properties / share_at_high_or_above / description
      Removed value: -"Of the area, at the day's worst hour for High"
    • removedOutput schema / $defs / AreaDay / properties / worst_hour / description
      Removed value: -"The hour with the most of the area at Critical, then at High or above, then lower"
    • removedOutput schema / $defs / AreaReading / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / AreaReading / properties / classes / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / classes / description
      Removed value: -"A categorical layer's classes by share of the area, largest first; concise gives the five largest as label: share"
    • removedOutput schema / $defs / AreaReading / properties / description / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / description / default
      Removed value: -null
    • addedOutput schema / $defs / AreaReading / properties / description / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / max / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / max / default
      Removed value: -null
    • addedOutput schema / $defs / AreaReading / properties / max / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / mean / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / mean / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / mean / description
      Removed value: -"The area's mean, each cell weighted by its area inside"
    • addedOutput schema / $defs / AreaReading / properties / mean / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / min / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / min / default
      Removed value: -null
    • addedOutput schema / $defs / AreaReading / properties / min / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / p10 / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / p10 / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / p10 / description
      Removed value: -"The value under which 10 % of the area lies"
    • addedOutput schema / $defs / AreaReading / properties / p10 / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / p50 / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / p50 / default
      Removed value: -null
    • addedOutput schema / $defs / AreaReading / properties / p50 / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / p90 / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / p90 / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / p90 / description
      Removed value: -"The value under which 90 % of the area lies"
    • addedOutput schema / $defs / AreaReading / properties / p90 / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaReading / properties / share_at_or_above / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / unit / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / AreaReading / properties / unit / default
      Removed value: -null
    • removedOutput schema / $defs / AreaReading / properties / unit / description
      Removed value: -"Given here only where the readings' units differ"
    • addedOutput schema / $defs / AreaReading / properties / unit / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / AreaShare / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / AreaShare / properties / by_hazard / description
      Removed value: -"Of the area, at this class, by hazard"
    • removedOutput schema / $defs / AreaShare / properties / share / description
      Removed value: -"Of the area, at this class"
    • removedOutput schema / $defs / Credit / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / Credit / properties / attribution / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Credit / properties / attribution / default
      Removed value: -null
    • removedOutput schema / $defs / Credit / properties / attribution / description
      Removed value: -"The credit the licence asks for when it is retold"
    • addedOutput schema / $defs / Credit / properties / attribution / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Credit / properties / licence / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Credit / properties / licence / default
      Removed value: -null
    • addedOutput schema / $defs / Credit / properties / licence / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Credit / properties / name / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Credit / properties / name / default
      Removed value: -null
    • removedOutput schema / $defs / Credit / properties / name / description
      Removed value: -"The feed's name as it is cited"
    • addedOutput schema / $defs / Credit / properties / name / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / ForecastPlace / properties / admin1 / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / ForecastPlace / properties / admin1 / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / properties / country / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / ForecastPlace / properties / country / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / properties / country_name / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / ForecastPlace / properties / country_name / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / properties / hazard / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / ForecastPlace / properties / hazard / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / properties / hours_at_level / description
      Removed value: -"Hours of the window spent at that class"
    • removedOutput schema / $defs / ForecastPlace / properties / level / description
      Removed value: -"The worst risk class the place reaches in the window"
    • removedOutput schema / $defs / ForecastPlace / properties / peak_at / description
      Removed value: -"The first hour at that class, UTC"
    • removedOutput schema / $defs / ForecastPlace / properties / peak_local_time / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / ForecastPlace / properties / peak_local_time / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / ForecastPlace / properties / reading / description
      Removed value: -"The physical reading behind the class at its first hour"
    • removedOutput schema / $defs / ForecastPlace / properties / risk_by_hazard / description
      Removed value: -"The worst class each hazard reaches in the window"
    • removedOutput schema / $defs / ForecastSource / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / NearPlace / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / NearPlace / properties / country / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / NearPlace / properties / country / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / RankWindow / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / RankWindow / properties / partial / description
      Removed value: -"True when the run ends before the window does"
    • removedOutput schema / $defs / RankWindow / properties / steps / description
      Removed value: -"Forecast steps inside the window"
    • removedOutput schema / $defs / Reading / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / Reading / properties / variable / description
      Removed value: -"utci, the felt temperature; wind_gust_10m; or precip_intensity_mmh"
    • removedOutput schema / $defs / ShareAtOrAbove / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / ShareAtOrAbove / properties / share / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / ShareAtOrAbove / properties / share / description
      Removed value: -"Of the area the layer holds values in"
    • addedOutput schema / $defs / ShareAtOrAbove / properties / share / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / ShareAtOrAbove / properties / value / description
      Removed value: -"In the layer's unit: the one asked for, else the source's own line"
    • removedOutput schema / $defs / Source / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / Source / properties / doi / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / doi / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / doi / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Source / properties / institution / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / institution / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / institution / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Source / properties / licence / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / licence / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / licence / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Source / properties / notes / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / notes / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / notes / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Source / properties / url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / url / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / Source / properties / year / anyOf
      Removed value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / Source / properties / year / default
      Removed value: -null
    • addedOutput schema / $defs / Source / properties / year / type
      Added value: +[
      +  "integer",
      +  "null"
      +]
    • removedOutput schema / $defs / Truncated / description
      Removed value: -"Set when an answer was held under its size: the tail of its main list left out."
    • removedOutput schema / $defs / Truncated / properties / field / description
      Removed value: -"The answer's list that was cut"
    • removedOutput schema / $defs / Truncated / properties / left_out / description
      Removed value: -"How many of its entries, the least important, were left out"
    • removedOutput schema / $defs / Truncated / properties / left_out_names / default
      Removed value: -null
    • removedOutput schema / $defs / Truncated / properties / left_out_names / description
      Removed value: -"Each entry left out, where the list is not ordered by importance"
    • removedOutput schema / $defs / Truncated / properties / why / description
      Removed value: -"The limit, and how to ask for the rest"
    • removedOutput schema / $defs / WorstHour / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / WorstHour / properties / at / description
      Removed value: -"UTC"
    • removedOutput schema / $defs / WorstHour / properties / shares / description
      Removed value: -"Each class from Low up the area reaches at that hour"
    • removedOutput schema / $defs / WorstPoint / additionalProperties
      Removed value: -true
    • removedOutput schema / $defs / WorstPoint / properties / at / description
      Removed value: -"The first hour at that class, UTC"
    • removedOutput schema / $defs / WorstPoint / properties / hazard / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / $defs / WorstPoint / properties / hazard / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / WorstPoint / properties / near / description
      Removed value: -"The largest city within reach, as hazard cards name one"
    • removedOutput schema / $defs / WorstPoint / properties / reading / description
      Removed value: -"The physical reading behind the class"
    • removedOutput schema / additionalProperties
      Removed value: -true
    • removedOutput schema / properties / cells_sampled / description
      Removed value: -"Forecast cells the area covers, in whole and in part"
    • removedOutput schema / properties / credit / description
      Removed value: -"How a retelling credits the answer: Source: Criora with a link to the page the answer is about, then each originator whose data it quotes in the words its licence asks for. Concise, each credit once; detailed, by source with its name and licence, criora first"
    • removedOutput schema / properties / datasets / default
      Removed value: -null
    • removedOutput schema / properties / datasets / description
      Removed value: -"With the climate layers: the description the layers of one dataset share"
    • removedOutput schema / properties / filters / additionalProperties
      Removed value: -true
    • removedOutput schema / properties / grid_km / description
      Removed value: -"The side of a forecast cell over the area"
    • removedOutput schema / properties / hazard / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / properties / hazard / description
      Removed value: -"The hazard holding the most of the area at that class"
    • addedOutput schema / properties / hazard / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / layers / default
      Removed value: -null
    • removedOutput schema / properties / layers / description
      Removed value: -"The climate layers asked for, each band's spread over the area"
    • removedOutput schema / properties / level / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / properties / level / description
      Removed value: -"The worst class any of the area reaches in the window; null when the run ends before it starts"
    • addedOutput schema / properties / level / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / notes / default
      Removed value: -null
    • removedOutput schema / properties / notes / description
      Removed value: -"With the climate layers: how they were read"
    • removedOutput schema / properties / people / description
      Removed value: -"Residents, GHS-POP 2025"
    • removedOutput schema / properties / places / description
      Removed value: -"Its cities most at risk, ranked as rank_by_forecast ranks them"
    • removedOutput schema / properties / places_matched / description
      Removed value: -"Its cities of 100,000 or more at Low or above"
    • removedOutput schema / properties / share_at_high_or_above / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / properties / share_at_high_or_above / description
      Removed value: -"Of the area, at the window's worst hour for High"
    • addedOutput schema / properties / share_at_high_or_above / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / smaller_than_a_cell / description
      Removed value: -"True when the area is read from part of one cell"
    • removedOutput schema / properties / sources / default
      Removed value: -null
    • removedOutput schema / properties / sources / description
      Removed value: -"With the climate layers: each source by name"
    • removedOutput schema / properties / timezone / description
      Removed value: -"The zone the days are dated in, at the area's centre"
    • removedOutput schema / properties / truncated / default
      Removed value: -null
    • removedOutput schema / properties / truncated / description
      Removed value: -"Absent unless the answer was cut to fit"
    • removedOutput schema / properties / where / additionalProperties
      Removed value: -true
  2. Added

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/openWorld, so the safety profile is covered; the description adds real behavioral context beyond that — day-by-day vs long-term output, what the categories/layers mode injects, and how response_format=detailed changes the payload. It stops short of stating defaults for area selection (country vs bbox) or any limits on the extra layer computation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the scope in the first clause and the alternative tools at the end where they belong; no filler sentences. The first sentence is long and stack-heavy, which costs a little readability, but every clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 8 all-optional parameters and an output schema present, the description adequately frames both modes and delegates return-value detail to the schema. The one omission is that it never says an area (country or bbox) must be provided to be useful, which matters given zero required parameters.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the parameters are already documented and the baseline is 3. The description does add cross-parameter meaning ('with categories or layers, also long-term climate layers over the area') that ties categories/layers/above together, but it does not clarify the country-vs-bbox selection rule or what happens if both or neither are supplied.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific resource (weather danger plus long-term climate layers), a specific scope (whole country or region, day by day), and enumerates the returned fields (worst class, hazard, share of area per class, worst point, most-at-risk cities). It explicitly distinguishes itself from the single-place siblings get_forecast and get_climate_profile.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives three concrete example questions that map to area-wide risk and adds an explicit routing rule: 'One place: get_forecast or get_climate_profile.' The when-to-use and when-to-use-something-else conditions are both stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.