Data API and AI agents
Everything the Criora map and Atlas show can be read programmatically: the seven-day forecast and its risk for any point, the long-term climate profile of any point, hazard events near a point, and the risk profile of every country. The same data is offered in two ways: an MCP server for AI assistants, and a JSON API for your own code.
No account or key is needed. Both are read-only.
For AI assistants: the MCP server
Criora runs a remote Model Context Protocol server at:
https://criora.com/mcpAdd it as a custom connector in any assistant that supports remote MCP servers (Claude, ChatGPT, Cursor, VS Code and others). No authentication is required. For example, in an MCP configuration file:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}The server offers seven tools. Each takes latitude and longitude, or a place name that it resolves to the best match and reports back.
| Tool | What it answers |
|---|---|
assess_place | Everything about a place in one answer: forecast risk by day, hazards nearby, climate profile, country |
get_forecast | Seven-day weather and weather risk, by local day or step by step |
get_climate_profile | Long-term exposure: floods, sea level rise, heat, drought, water stress and more |
get_hazards_near | Wildfires, earthquakes, floods, cyclones, volcanoes, droughts and air quality near a place |
get_country_profile | A country’s risk scores and, on request, every indicator with its benchmarks |
compare_countries | Two to ten countries side by side, with their ranks |
find_place | Coordinates for a place name, when a name is ambiguous |
The server also offers three prompts, ready-made questions an assistant can start from: assess_trip for how risky a trip is on its dates, compare_places_to_live for the long-term exposure of several places side by side, and country_briefing for one country against its region and the world.
For your code: the JSON API
All endpoints answer GET requests with JSON under https://criora.com/api/v1.
| Endpoint | Returns |
|---|---|
/place/forecast?lat=&lon= | The current forecast run at a point: every step and a summary per local day |
/place/climate?lat=&lon= | Every long-term climate layer at a point; categories= narrows it (e.g. flooding) |
/place/report?lat=&lon= | Forecast by day, hazards nearby, climate profile and the country, in one answer |
/geodata/live-events/nearby?lat=&lon= | Hazard events near a point; radius_km=, event_types= and since= narrow it |
/countries/risks | Every country’s overall and dimension scores |
/country/{ISO3}/summary | One country’s scores and classification |
/country/{ISO3}/risks | One country’s indicators, each with its world and regional benchmark |
/geocode/search?q= | Places matching a name, from OpenStreetMap Nominatim |
For example, the forecast for Seville:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Reading the forecast risk
Each forecast step carries a risk class from 0 (Very low) to 4 (Critical), the hazard that sets it, and the physical reading behind it: the UTCI felt temperature for heat and cold, the gust speed for wind, the precipitation rate for rain and snow. Rain, snow and wind take precedence over temperature, which is the same rule the map uses. Each day’s summary names its headline risk and lists the highest class every hazard reaches that day.
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.
Forecast answers change when a new model run is published, twice a day. Climate layers change when a dataset is rebuilt. Fields may be added to answers; existing fields keep their meaning.
Sources and attribution
Every answer names its source. When you publish or redistribute data from Criora, credit Criora and follow the licence of the source it names: the forecast comes from Environment and Climate Change Canada under its Data Server End-use Licence, place names from OpenStreetMap under the ODbL, and each climate layer lists its own provider and licence. See Data Sources for the full list. Use of the API is governed by the Terms of Service.
Criora publishes data, not advice. Its figures are not a substitute for professional financial, insurance or safety advice.