assess_place

Climate and disaster risk overview of one place or property in a single answer: this week's forecast risk by day, natural hazards happening nearby, the headline long-term exposures (heat, river and coastal flooding, sea level rise, water stress, drought, heavy rain, wildfire, climate zone) and the risk profile of the country it lies in. Use it first for an open question about one place ("is it safe there", "what are the risks", "should I worry about floods or heat"). For one specific question call the matching tool, which answers it in full: get_forecast, get_hazards_near, get_climate_profile or get_country_profile. To compare places, call get_climate_profile once per place. Give latitude and longitude, or a place name, which is resolved to its best match and reported back. Returns the forecast days, the hazard events, the headline climate layers with their sources, the country summary and criora_url, the place on the Criora map.

read-only

Argument	Type	Description
place	any	A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them
latitude	any	Latitude of the place asked about, in degrees, WGS84. Give it with longitude, or give place instead
longitude	any	Longitude of the place asked about, in degrees, WGS84. Give it with latitude, or give place instead

Input schema (JSON)

{
  "type": "object",
  "title": "assess_placeArguments",
  "properties": {
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null,
      "description": "A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them"
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        {
          "type": "null"
        }
      ],
      "title": "Latitude",
      "default": null,
      "description": "Latitude of the place asked about, in degrees, WGS84. Give it with longitude, or give place instead"
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        },
        {
          "type": "null"
        }
      ],
      "title": "Longitude",
      "default": null,
      "description": "Longitude of the place asked about, in degrees, WGS84. Give it with latitude, or give place instead"
    }
  }
}

compare_countries

Climate and disaster risk of two to ten named countries side by side: each one's overall risk score and class, its climate, nature, social, governance and adaptation scores, and its world rank by overall risk. Use it when the countries are known in advance. To find the countries most or least at risk use rank_countries; for one country's indicators, get_country_profile. Countries are ISO 3166-1 alpha-3 codes or English names; an unknown one is refused with the expected form. Scores run 0 to 100, higher is riskier, and rank 1 is the highest risk among 194 countries. Sources: INFORM Risk Index, ND-GAIN and the World Bank.

read-only

Argument	Type	Description
countries*	array	ISO3 codes or English names of 2 to 10 countries

Input schema (JSON)

{
  "type": "object",
  "title": "compare_countriesArguments",
  "required": [
    "countries"
  ],
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Countries",
      "maxItems": 10,
      "minItems": 2,
      "description": "ISO3 codes or English names of 2 to 10 countries"
    }
  }
}

fetch

One Criora document as markdown, with its title, the Criora page to cite and the sources it draws on, by an id search returned. country:<ISO3> (country:BGD) gives the country's risk score, class and rank, each dimension with its class, and its most notable indicators against the world and regional medians. place:<latitude>,<longitude> (place:23.8103,90.4125) gives this week's forecast risk by day, the most notable hazard events nearby, the headline climate exposures and the country. page:methodology and page:sources are those pages of the site; catalog:layers lists every climate layer and catalog:indicators every country indicator. Use it to read a document for research and cite it. The specific tools answer with every figure as data, through get_country_profile, assess_place and the rest. An id of another form is refused with the forms it takes. A long text is cut at a paragraph, with the page that has the rest.

read-only

Argument	Type	Description
id*	string	An id search returned: country:<ISO3>, place:<latitude>,<longitude>, page:<name> or catalog:layers / catalog:indicators

Input schema (JSON)

{
  "type": "object",
  "title": "fetchArguments",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "An id search returned: country:<ISO3>, place:<latitude>,<longitude>, page:<name> or catalog:layers / catalog:indicators"
    }
  }
}

find_place

Candidate coordinates for a place name or address, best match first, each with its full name and kind (city, state, road and so on). Call it when a name is ambiguous (several Springfields) and the right candidate must be chosen, or when one place is the subject of several calls and its coordinates should be looked up once. The other place tools take a name themselves and use its best match, so a single question about an unambiguous place needs no find_place first. It queries OpenStreetMap Nominatim (ODbL) through Criora's geocoder, which every user shares and which sends one request a second: a burst of calls waits its turn, and a name looked up in the last week is answered from a cache. A name that matches nothing returns an empty list. A city resolves to its centre as OpenStreetMap maps it.

read-only

Argument	Type	Description
limit	integer	How many candidates to return
query*	string	A place name or address, in any language

Input schema (JSON)

{
  "type": "object",
  "title": "find_placeArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "How many candidates to return"
    },
    "query": {
      "type": "string",
      "title": "Query",
      "description": "A place name or address, in any language"
    }
  }
}

get_climate_profile

Long-term climate risk and environmental data of a place or property, read at the point from 55 global layers: river and coastal flood depth of a 100-year flood now and in 2050 and 2080, sea level rise, extreme heat and cold days, heavy rain, drought (SPI-12, aridity, WRI drought risk), water stress, wind and storm days, warming and rainfall change to 2050 and 2080 (CMIP6), NDVI vegetation index and leaf area, wildfire burned area, soil moisture, snow, surface water, elevation, slope, land subsidence, land cover, built-up share and the Köppen climate zone. Use it for what a place is exposed to over years, and once per place to compare places; assess_place has only the headline layers. For this week's weather use get_forecast; for events happening now, get_hazards_near. Narrow it with categories, or with layers by id: the resource criora://layers, or fetch catalog:layers, lists every layer with its unit, years and source. Returns each layer's readings by band with its unit, year, cell size and source (ERA5, CMIP6, WRI Aqueduct, IPCC AR6, MODIS, JRC, Copernicus DEM and others). Give latitude and longitude, or a place name.

read-only

Argument	Type	Description
place	any	A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them
layers	any	Only these layers, by id, e.g. ndvi/annual for the NDVI vegetation index or flood_riverine/inundation for river flood depth; every id with what it measures is in the resource criora://layers. Combined with categories, both are given
latitude	any	Latitude of the place asked about, in degrees, WGS84. Give it with longitude, or give place instead

get_country_profile

Climate and disaster risk of one country, of 194, for ESG, investment, insurance and humanitarian screening: the overall risk score (0 to 100, higher is riskier), class and world rank, and the climate, nature, social, governance and adaptation scores and classes, with its region and income group. Use it for one country in depth. For named countries side by side use compare_countries; for the countries most or least at risk, rank_countries; for a place inside a country, assess_place. include_indicators=true adds the indicators behind each dimension from the INFORM Risk Index, ND-GAIN and the World Bank (flood, earthquake and drought risk, water stress, food security, health, governance and about 150 more), those furthest from the world median first, each with its value, year, source and the medians of the world, region, subregion and income group; indicators_limit caps them per dimension, and criora://indicators lists them all. The country is an ISO 3166-1 alpha-3 code or its English name; an unknown one is refused with the expected form.

read-only

Argument	Type	Description
country*	string	ISO 3166-1 alpha-3 code (e.g. BGD) or English country name
indicators_limit	integer	With include_indicators, how many indicators to list per dimension
include_indicators	boolean	Add the underlying indicators, the furthest from the world median first, each with its world and regional medians; the scores alone when false

Input schema (JSON)

{
  "type": "object",
  "title": "get_country_profileArguments",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "title": "Country",
      "description": "ISO 3166-1 alpha-3 code (e.g. BGD) or English country name"
    },
    "indicators_limit": {
      "type": "integer",
      "title": "Indicators Limit",
      "default": 8,
      "maximum": 60,
      "minimum": 1,
      "description": "With include_indicators, how many indicators to list per dimension"
    },
    "include_indicators": {
      "type": "boolean",
      "title": "Include Indicators",
      "default": false,
      "description": "Add the underlying indicators, the furthest from the world median first, each with its world and regional medians; the scores alone when false"
    }
  }
}

get_forecast

This week's weather and extreme-weather risk at a place: heat waves and cold (graded on the UTCI felt temperature), storms and wind gusts, heavy rain, snow and freezing rain, by local day, with each day's risk class from Very low to Critical and the hazard behind it. Use it for the weather or the weather risk in the next seven days. For disasters already happening use get_hazards_near; for what a place is exposed to over years, get_climate_profile. Returns for each day the minimum and maximum temperature, peak precipitation rate, peak wind gust and the risk with its driver (the value that set the class, the class's threshold and, for heat and cold, the air temperature beside the UTCI) and an explanation in words; hourly=true adds every forecast step. Steps are hourly on the first day, then 3-hourly, then 6-hourly from the fourth day, so a day's true peak can fall between two steps; a day marked partial is cut by the forecast window. Source: Environment and Climate Change Canada GDPS model, read at its 15 km cell. Give latitude and longitude, or a place name.

read-only

Argument	Type	Description
place	any	A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them
hourly	boolean	Add every forecast step, hour by hour where the model has them, to the daily summary
latitude	any	Latitude of the place asked about, in degrees, WGS84. Give it with longitude, or give place instead
longitude	any	Longitude of the place asked about, in degrees, WGS84. Give it with latitude, or give place instead

get_hazards_near

Natural disasters and hazards happening now or recently near a place, every one the sources hold: wildfires (NASA FIRMS satellite fire detections), every earthquake USGS records with its depth, felt reports, intensity and PAGER alert, tsunami bulletins of the NOAA warning centres, tropical cyclones with the official NHC cone and forecast track, floods, volcanic eruptions and droughts (GDACS), official warnings for every natural hazard from the US National Weather Service and, through WMO WIS2, from MeteoAlarm's national services across Europe (wind, snow and ice, thunderstorms, fog, heat, cold, coastal, rain, flood, fire danger, avalanche), and air quality (OpenAQ reference monitors). Use it for what is happening there now. For the weather forecast use get_forecast; for long-term exposure, get_climate_profile. Returns the most severe and most recent events first, each with its kind (occurrence or warning), type, severity (low to critical), distance, bearing and time; a warning also carries its issuer (sender), issued_at, onset_at and expires_at and whether the place lies inside its area (inside), and a moving storm its track. total and counts_by_type cover every event found. radius_km (1 to 500), event_types and days (1 to 30) narrow the search; without radius_km every type is searched at its largest distance, which radius_used_km reports. Give latitude and longitude, or a place name.

read-only

Argument	Type	Description
days	any	Only events of the last N days, 1 to 30; all current when omitted
place	any	A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them
latitude	any

get_map_event

One hazard event the interactive map opens when the reader taps a warning's area or a storm's cone: the event, or none when it is no longer listed. The map calls it in clients that display it; to list the hazards near a place, use get_hazards_near.

read-only

Argument	Type	Description
id*	integer	The event's id, as a warning's area on the map lists it

Input schema (JSON)

{
  "type": "object",
  "title": "get_map_eventArguments",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "title": "Id",
      "minimum": 1,
      "description": "The event's id, as a warning's area on the map lists it"
    }
  }
}

get_map_events

The hazard events the interactive map loads when the reader pans or zooms to a new view. The map calls it in clients that display it; to list the hazards near a place, use get_hazards_near.

read-only

Argument	Type	Description
latitude*	number	Latitude of the view's centre
longitude*	number	Longitude of the view's centre
radius_km*	number	How far the view reaches from its centre, in km

Input schema (JSON)

{
  "type": "object",
  "title": "get_map_eventsArguments",
  "required": [
    "latitude",
    "longitude",
    "radius_km"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "title": "Latitude",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude of the view's centre"
    },
    "longitude": {
      "type": "number",
      "title": "Longitude",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude of the view's centre"
    },
    "radius_km": {
      "type": "number",
      "title": "Radius Km",
      "maximum": 500,
      "minimum": 1,
      "description": "How far the view reaches from its centre, in km"
    }
  }
}

get_map_warnings

The official warnings the interactive map draws over a view: each hazard's edge at each class and its symbols, at the view's zoom. The map calls it in clients that display it; to list the warnings near a place, use get_hazards_near.

read-only

Argument	Type	Description
east*	number	The view's east edge, unwrapped past 180
west*	number	The view's west edge, unwrapped past 180
zoom*	integer	The zoom the view is drawn at
north*	number	The view's north edge
south*	number	The view's south edge

Input schema (JSON)

{
  "type": "object",
  "title": "get_map_warningsArguments",
  "required": [
    "west",
    "south",
    "east",
    "north",
    "zoom"
  ],
  "properties": {
    "east": {
      "type": "number",
      "title": "East",
      "maximum": 540,
      "minimum": -540,
      "description": "The view's east edge, unwrapped past 180"
    },
    "west": {
      "type": "number",
      "title": "West",
      "maximum": 540,
      "minimum": -540,
      "description": "The view's west edge, unwrapped past 180"
    },
    "zoom": {
      "type": "integer",
      "title": "Zoom",
      "maximum": 22,
      "minimum": 0,
      "description": "The zoom the view is drawn at"
    },
    "north": {
      "type": "number",
      "title": "North",
      "maximum": 90,
      "minimum": -90,
      "description": "The view's north edge"
    },
    "south": {
      "type": "number",
      "title": "South",
      "maximum": 90,
      "minimum": -90,
      "description": "The view's south edge"
    }
  }
}

list_hazards

Natural disasters, hazards and official warnings in force across a country, a region or the whole world, from the same sources as get_hazards_near: wildfires, earthquakes, tsunami bulletins, tropical cyclones, floods, volcanic eruptions, droughts, official weather warnings (US National Weather Service, MeteoAlarm services across Europe) and air quality. Use it for questions about an area rather than a point: what is happening in Japan, which red warnings are in force in Europe, the strongest earthquakes in the world this week. For what is near one place use get_hazards_near; for one country's long-term risk, get_country_profile. Give country, or bbox for a region, or neither for the whole world. Every type, kind and severity is included unless event_types, kinds (occurrence, warning, status), min_severity or days narrow it. Returns the most severe events first and then the most recently active, limit of them; total and the counts by type, severity and kind cover every event that matched. A warning carries its issuer (sender), onset_at and expires_at; metadata holds the source's own facts, such as an earthquake's depth or a storm's wind. A country or a bbox holds an event by its point: a warning whose area reaches in from outside is not listed, and get_hazards_near answers for a place inside any area.

read-only

Argument	Type	Description
bbox	any	A region as [west, south, east, north] in degrees. A region across 180 gives its east past 180, at any width ([120, -50, 300, 30] runs from 120 east across the Pacific to 60 west); west above east also crosses 180, for a region less than half the world across
days	any	Only events active in the last N days, 1 to 30; all current when omitted
kinds	any	Only occurrences, warnings or statuses; all of them when omitted

rank_countries

The countries most or least at climate and disaster risk, overall or on one dimension (climate, nature, social, governance, adaptation), each with its score, risk class and rank, optionally only those in a region, subregion or income group. Answers "which countries are most exposed to climate risk", "the riskiest countries in Southern Asia" or "low-income countries with the lowest adaptation score". For countries named in advance use compare_countries; for one country in depth, get_country_profile. Regions, subregions and income groups are named as the countries' meta names them; a name no country has is refused with the names there are. The filters combine, and a combination that matches nothing returns an empty list; limit cuts the list, while matched counts every country that passed the filters. Scores run 0 to 100, higher is riskier. A country's rank is among all 194 countries, 1 being the highest risk: a filter narrows the list but not the rank. Countries without a score on the dimension are counted in no_score.

read-only

Argument	Type	Description
limit	integer	How many countries to list
order	string	Most at risk first, or least at risk first
region	any	Only countries in this UN region, e.g. Asia
dimension	string	The score to rank by
subregion	any	Only countries in this UN M49 subregion, e.g. Southern Asia
income_group

search

Find Criora's documents on a subject, to read and cite with fetch: a country's climate and disaster risk profile, a place's risk report, the pages on Criora's methodology and data sources, and the data catalogue (every climate layer with satellite data such as NDVI, and the country indicators). Each result has the id fetch reads and the Criora page to cite. Use it to find what Criora has before reading it with fetch. For an answer in one call the specific tools are shorter: assess_place for a place, get_country_profile for a country, rank_countries for the countries most at risk. A country is found by its ISO 3166-1 alpha-3 or alpha-2 code or its English name. The words methodology or sources find those pages; layers, catalogue, satellite, NDVI or indicators find the data catalogue. Only when nothing else matches is the query looked up as a place name, in the geocoder every user shares; a place is found best by its name alone. Nothing found is an empty list.

read-only

Argument	Type	Description
query*	string	A country, a place name, or a subject: methodology, data sources, or the data catalogue (layers, NDVI, satellite, indicators)

Input schema (JSON)

{
  "type": "object",
  "title": "searchArguments",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "title": "Query",
      "description": "A country, a place name, or a subject: methodology, data sources, or the data catalogue (layers, NDVI, satellite, indicators)"
    }
  }
}

show_risk_map

Shows an interactive map of a place in clients that render apps, such as Claude and ChatGPT: this week's forecast risk over the area, hazard events nearby as markers, and the risk by day, which the reader can pan, zoom and open full screen. Instead of the risk, the map can lay the precipitation, temperature or wind forecast under the events (`layer`), hour by hour over the week, and the reader can switch between all four. A client without apps gets the same summary as text, with a link to the place on Criora's own map. Use it when the user wants to see the place, the week's risk or the hazards around it on a map, or when a map makes an answer clearer than a list. The figures come from the same sources as get_forecast and get_hazards_near, which give them in full. Give latitude and longitude, or place, which costs a lookup in the shared geocoder. With both, the coordinates are used and place only names the map, at no lookup: pass the name the user knows the place by, or the map is titled by its coordinates and country.

read-only

Argument	Type	Description
focus	string	What the map shows: this week's forecast risk, the hazard events nearby, or both
layer	string	The forecast field the map opens on, under the hazard events: the risk (default), or the precipitation, temperature or wind forecast when the question is about the weather itself. The reader can switch between them on the map
place	any	A place name or address, used only when latitude and longitude are not given. It is resolved to its best match by a geocoder shared by every user and limited to one lookup a second, so pass coordinates when you have them
latitude	any

Criora climate risk

Try it

assess_place

Criora climate risk

Try it

assess_place

Tools (15)