Criora — climate and disaster risk MCP server

Criora is a hosted, remote Model Context Protocol server that answers climate and disaster risk questions for any place, trip or portfolio on Earth: weather risk for the days ahead (the 7-day forecast, the ECMWF ensemble to day 15, then the month's normal), official warnings and disasters near a place or across a country, a region or the world, what has hit a place in past decades, long-term climate exposure, indicative flood and cyclone damage to an asset, and country risk. In assistants that display MCP Apps, such as Claude, it can also show an interactive map of the place right in the conversation.

• Endpoint: https://criora.com/mcp
• Transport: Streamable HTTP
• Authentication: none, no account or API key
• Access: read-only, free
• Registry name: com.criora/criora in the official MCP registry

This repository holds the documentation and registry metadata for the hosted server. The server itself runs at criora.com; there is nothing to install.

Use cases

• Travel safety: "is it safe to travel to Tokyo on the 25th?": heat, storms and heavy rain on each stop's own dates, up to ten places in one call, and disasters happening nearby.
• Property, real estate and site due diligence: flood risk (river and coastal flood depth by scenario), sea level rise, extreme heat, drought, water stress, wildfire and subsidence at an address or coordinates, with warming to 2050 and 2080; up to 200 sites at once as a table, and indicative flood and cyclone wind damage to an asset in money (ESRS E1, IFRS S2, TCFD, EU Taxonomy screening).
• Relocation: compare the long-term climate exposure of several cities side by side, see what has hit a place before, and which city's climate today a city will have in the 2050s.
• ESG, insurance and investment research: country climate and disaster risk for 194 countries (INFORM Risk Index, ND-GAIN, World Bank), rankings within a region or income group, 123 indicators against regional and world benchmarks, rankings on any one hazard or indicator, and what El Niño and La Niña have brought a country.
• Disaster monitoring and warnings: official weather warnings (US National Weather Service, MeteoAlarm across Europe), earthquakes, hurricanes and typhoons with their forecast cone, wildfires, floods, volcanoes, tsunami bulletins, volcano alert levels, ash clouds and air quality, near a place or across a country, a region or the world; and where the days ahead are most dangerous.

Connect

Claude (claude.ai, Claude Desktop): Settings → Connectors → Add custom connector, then paste https://criora.com/mcp.

Claude Code:

claude mcp add --transport http criora https://criora.com/mcp

or as a Claude Code plugin (MCP server plus a skill that tells Claude when to use which tool):

/plugin marketplace add thothbot/criora-mcp
/plugin install criora@criora

Cursor (~/.cursor/mcp.json) and other clients that use an mcpServers file:

{
  "mcpServers": {
    "criora": { "url": "https://criora.com/mcp" }
  }
}

Google Antigravity (App, CLI, IDE): install the plugin from this repository (MCP server plus a skill that tells the agent when to use which tool):

agy plugin install https://github.com/thothbot/criora-mcp

or add the server to mcp_config.json yourself:

{
  "mcpServers": {
    "criora": { "serverUrl": "https://criora.com/mcp" }
  }
}

Gemini CLI:

gemini extensions install https://github.com/thothbot/criora-mcp

VS Code (.vscode/mcp.json):

{
  "servers": {
    "criora": { "type": "http", "url": "https://criora.com/mcp" }
  }
}

ChatGPT and other assistants: add https://criora.com/mcp as a custom connector / remote MCP server.

Data catalog

The server reads 57 long-term climate layers (heat, rain, drought, wind, water stress, flood depth, sea level rise, NDVI, land cover, terrain and more), the 7-day forecast, hazard events and official warnings from the US NWS, MeteoAlarm and other national services (via WMO WIS2), Japan's JMA, Korea's KMA and the Philippines' PAGASA, NOAA's tsunami centres, the NHC and JTWC, USGS and EMSC, GDACS, NASA FIRMS, the VAACs and AirNow, past events for a place's history, and 123 country indicators. The full list with units, resolution, period and source is in docs/data-catalog.md.

Tools

Place tools take latitude and longitude, or a place name that they resolve to the best match and report back. Every tool is read-only and publishes its output schema; answers at their defaults stay under about 8,000 tokens.

Tool	What it answers
assess_place	Everything about one to ten places in one call, each on its own dates: each day's risk (the 7-day forecast, then the ECMWF ensemble's chances to day 15, then the month's 1991-2020 normal), hazards nearby, the headline long-term exposures, a home's damage band and the country's risk. The best first call for an open question or a trip.
get_forecast	This week's weather and weather risk, by local day or step by step. Each day carries a risk class with the hazard behind it (heat and cold on the UTCI felt temperature, wind, rain, snow, freezing rain).
get_hazards_near	What is happening now near a place: official warnings, earthquakes, tsunami bulletins, tropical cyclones with cone and track, wildfires, floods, eruptions and volcano alert levels, ash clouds, droughts and air quality. Each event carries Criora Severity (severity_rank, 0 to 100) beside the issuer's own level; says whether the place lies inside a warning's area.
list_hazards	Every hazard and warning in force across a country or territory, a region (bbox) or the whole world, most severe first: "which red warnings are in force in Europe", "the strongest earthquakes this week". The world's answer carries the Earth's pulse.
get_place_history	What has hit a place before: earthquakes, tropical cyclones, tsunamis, floods and eruptions near it, by decade and the largest, with date, distance, deaths and damage, and from when each count is complete.
rank_by_forecast	The cities (100,000 people or more) or the countries where the next 1 to 7 days' weather is most dangerous, by how high the risk reaches and how many people it reaches.
get_area_risk	The days ahead over a whole country or region: the worst class, the share of the area at each class, the worst point and the cities most at risk; with categories or layers, the long-term climate layers over the area too.
get_climate_profile	Long-term exposure from 57 layers: river and coastal flood depth, sea level rise, heat, drought, water stress, wind, wildfire, earthquake hazard, NDVI and other satellite layers, terrain, land cover, with warming and rainfall change projected to 2050 and 2080. Narrow it with categories or layers (ids in criora://layers).
get_climate_table	The same layers at up to 200 places in one call, as a table: a row per place, a column per layer and band, each row with a home's damage band. For a portfolio of sites or a grid of points.
get_climate_twin	The large city whose climate today is most like a city's climate in 2041-2060, under SSP2-4.5 and SSP5-8.5: "what will Belgrade feel like in 2050".
estimate_financial_impact	Indicative damage to a building or asset from river and coastal flooding and tropical cyclone wind: expected annual damage and the 50 to 500-year events, low, central and high, today or in 2050 and 2080. For ESRS E1, IFRS S2, TCFD or EU Taxonomy screening, not a valuation.
get_country_profile	A country's overall risk score and its climate, nature, social, governance and adaptation scores; with response_format=detailed, the INFORM, ND-GAIN and World Bank indicators behind them against world and regional benchmarks.
compare_countries	Two to ten countries side by side on overall risk and each dimension, with their ranks.
rank_countries	The countries most or least at risk, overall, on one dimension or on one hazard or indicator (river flooding, cyclone exposure...), optionally within a region, subregion or income group.
get_enso_outlook	El Niño and La Niña now and ahead (NOAA CPC's alert and chances for the nine seasons ahead) and, for a country, what each phase has brought it in each season since 1950.
find_place	Coordinates for a place name, when a name is ambiguous.
search	Find countries, places, Criora reference pages and the data catalogue; returns ids for fetch. Built to the shape ChatGPT deep research and company knowledge expect.
fetch	A readable document for a search id (country:BGD, place:<lat>,<lon>, page:methodology, catalog:layers), with a link to the Criora page it comes from.
show_risk_map	An interactive map in the conversation: a place, several places, one event (its area, a storm's cone and track) or the whole world, with this week's forecast risk or the rain, temperature or wind hour by hour, under the hazards and official warning areas. Clients without apps get the same summary as text.

Data tools answer concisely by default; response_format=detailed gives every field. Calls written for 1.x are still answered.

Interactive map

show_risk_map is an MCP App: in clients that display apps (Claude on the web, desktop and mobile, and other MCP Apps hosts) it draws a map under the answer, on Criora's own Natural Earth ground:

• this week's worst forecast risk with its hazard symbols, or one forecast hour of it;
• the precipitation, temperature or wind forecast instead (layer), with animated wind streams and a key;
• hazard events nearby as markers the reader can tap for the event's details;
• official warning areas and hurricane cones and tracks, drawn as the Criora site draws them;
• a timeline of the week under the field switch: the risk hour by hour with each day's main hazard, or the temperature, wind or rain at the place, with the reading for the hour shown.

The reader can pan, zoom, open the map full screen, tap or scrub the timeline, play the week hour by hour and switch between the four fields; the map tells the assistant what the reader is looking at. The card follows the host's own theme and type, light or dark. Clients that do not display apps get the same answer as text, with a link to the place on Criora's own map.

Resources

URI	What it holds
criora://country/{iso3}	A country's risk scores and classes as JSON (template; ISO3 codes autocomplete).
criora://methodology	How Criora scores country risk (markdown).
criora://sources	The datasets behind every answer, with licences (markdown).
criora://layers	Every long-term climate layer get_climate_profile reads, with its id, unit, years and source (markdown).
criora://indicators	The country indicators by risk dimension and source (markdown).
criora://changelog	Methodology versions and what changed (markdown).
criora://pulse	The Earth's pulse: how the world's dial of events in force is built (markdown).
ui://criora/map.html	The interactive map page show_risk_map opens (MCP App).

Prompts

Prompt	Arguments	Purpose
assess_trip	destination, dates (optional)	How risky a trip is: weather risk on the travel days, hazards nearby, seasonal exposure.
compare_places_to_live	places (semicolon-separated)	Long-term climate exposure and country risk of several places side by side.
country_briefing	country (name or ISO3, autocompleted)	One country's climate and disaster risk against its region and the world.
site_due_diligence	site, purpose (optional)	Climate and disaster risk of a property or site: flooding, heat, drought, wildfire, subsidence, hazards nearby.
esg_country_screen	countries or region (optional)	Screen countries on climate and disaster risk for ESG, investment or supply-chain decisions.

Example questions

• "How exposed is Ghana to climate disasters?"
• "What is the weather risk in Lisbon this week?"
• "Are there any wildfires or earthquakes near Tokyo right now?"
• "Compare climate risk for Spain and Portugal."
• "I'm going to Seville from 3 to 6 October — how risky is that trip?"
• "Show me the wind forecast on a map around Brest."
• "What is the flood risk and sea level rise exposure for a house in Rotterdam by 2050?"
• "Is there a heat wave or a hurricane coming to Miami this week?"
• "Which red weather warnings are in force in Europe right now?"
• "What were the strongest earthquakes in the world this week?"
• "Which low-income countries are most exposed to climate risk, for an ESG screen?"
• "Rank these 30 warehouse sites by flood risk."
• "What could a 100-year flood cost a €400,000 house in Valencia?"
• "Has Lisbon had a big earthquake? How often do typhoons reach Manila?"
• "What will Belgrade feel like in 2050?"
• "Which European cities face storms in the next two days?"
• "Is El Niño coming, and what does it bring Indonesia?"

Data sources

Every answer names its source. Main sources: forecast from Environment and Climate Change Canada, ECMWF's ensemble to day 15 and ERA5 normals after that; place names from OpenStreetMap Nominatim (ODbL); hazards and warnings from the US National Weather Service, MeteoAlarm and other national services (via WMO WIS2), JMA, KMA, PAGASA, the NOAA tsunami warning centres, the National Hurricane Center, JTWC, USGS, EMSC, GDACS, NASA FIRMS, the Volcanic Ash Advisory Centres, AirNow and CAMS; El Niño from NOAA CPC; past floods in Europe since 1870 from HANZE; climate layers from ERA5, CMIP6 and IPCC AR6 among others; country indicators from the INFORM Risk Index, ND-GAIN and the World Bank. See Data Sources for the full list and licences.

Limits

• Place-name lookups go through OpenStreetMap Nominatim, which allows one request per second for all of Criora together, so pass coordinates where you have them.
• Forecasts change when a new model run is published, twice a day.

JSON API

The same data is available as a plain JSON API under https://criora.com/api/v1. See Data API and AI agents.

What is sent

The plugin runs nothing on your machine: it adds the hosted server and a skill that tells Claude when to use it. When Claude calls a Criora tool, the tool's arguments (a place name or coordinates, a country, a search phrase) go to https://criora.com/mcp over HTTPS, with the usual request data (IP address, client name and user agent). Criora logs these requests to run and secure the service and keeps the logs for up to 30 days. Place names are looked up with OpenStreetMap Nominatim; nothing else is passed on. No account, API key or other personal data is asked for.

Terms

Criora publishes data, not advice. Use of the service is governed by the Terms of Service and the Privacy Policy. When you publish or redistribute data from Criora, credit Criora and follow the licence of the source each answer names.

The MIT licence in this repository covers the files in this repository (documentation and metadata) only.

Changelog

• 2.2.1 (2026-11-07): a concise assess_place keeps a hazard that was not read as null in a month's days_at_least and an outlook day's chance_at_least, apart from one no day reached: over Antarctica, where ERA5-HEAT has no cells, heat, cold and the day's risk had been left out and read as never reached.
• 2.2.0 (2026-11-05): a get_climate_table row gives its damage band alone (low, moderate, high), the table saying once what the bands mean, so 130 sites' flood layers fit one answer; get_place_history gives Europe's floods since 1870 from HANZE with their dead.
• 2.1.0 (2026-11-05): a detailed get_climate_profile gives all 57 layers in one answer, each source credited once; every layer a profile returns is accepted by layers (incl. cyclone_wind_return_periods/historical); get_climate_table takes up to 200 places (was 50) and says which were left out if the answer is full; the profile sends lists of sites to the table; leaner answer schemas (tools/list 189 KB -> 106 KB); assess_place says per place which days past the forecast come from the ensemble or the normal. Answer schemas change compatibly only.
• 2.0.0 (2026-11-02): 19 tools plus 3 app-only ones. New: get_place_history (what has hit a place, by decade), get_climate_table (the long-term layers at up to 50 places as a table, for a portfolio), get_climate_twin (the city whose climate today a city will have in the 2050s), estimate_financial_impact (indicative flood and cyclone wind damage to an asset, low to high), rank_by_forecast (the cities or countries the days ahead put most at risk), get_area_risk (the days ahead and the climate layers over a country or region) and get_enso_outlook (El Niño and La Niña and what they bring a country). assess_place takes up to ten places, each on its own dates, past the forecast with the ECMWF ensemble to day 15 and then the month's normal. Every event carries Criora Severity (0 to 100) beside the issuer's level; more warning services (JMA, KMA, PAGASA), volcano alert levels and ash clouds; rank_countries ranks on any hazard or indicator; the earthquake hazard layer (56 layers). Answers are concise by default (response_format=detailed for every field), and calls written for 1.x are still answered. The map shows several places, one event or the whole world.
• 1.5.0 (2026-10-21): list_hazards, every hazard and warning in force in a country or territory, a region or the world. Official warnings from the US National Weather Service and, through WMO WIS2, MeteoAlarm's national services across Europe; NOAA tsunami bulletins; NHC storms with their cone and track; every USGS earthquake with its depth and felt reports. get_hazards_near says whether the place lies inside a warning's area, and a warning's own words come apart from its facts as issuer_text. The chat map draws warning areas and storm cones on its own Natural Earth ground. 12 tools plus 3 app-only ones (get_map_events, get_map_warnings, get_map_event).
• 1.4.1 (2026-10-18, Claude Code plugin only; the server stays 1.4.0): the plugin manifest names its icon (./icon.png), and this README says what is sent.
• 1.4.0 (2026-10-16): the tools say what data they hold: get_climate_profile takes layers by id (55 layers, e.g. ndvi/annual) and its categories argument lists each category's layers; resources criora://layers and criora://indicators; search/fetch find the data catalogue (catalog:layers, catalog:indicators); descriptions and titles rewritten to the directories' rules; prompts site_due_diligence and esg_country_screen.
• 1.3.1 (2026-10-15): the map card redesigned to the hosts' own look, in the card and full screen, with the week's timeline under the field switch; clearer hazard icons; Very low in the risk key; a lighter risk wash so the land shows; the forecast read is retried after a failure; the map keeps drawing when a host reports the card off screen; the server description names the map.
• 1.3.0 (2026-10-15): show_risk_map, an interactive map of a place in the chat (risk, rain, temperature, wind).

Contact

Issues and questions: open an issue in this repository or write to thothbot@gmail.com.