---
title: "Agenti AI e server MCP | Criora Docs"
description: "Leggi i dati di previsione, clima, pericoli e Paesi di Criora da un assistente AI o da un agente che costruisci tu"
url: "https://criora.com/it/docs/references/api-and-agents"
language: "it"
---

# Agenti AI e server MCP

Tutto ciò che mostrano la mappa e l’Atlante di Criora è accessibile a un assistente AI o a un agente che costruisci tu: la previsione a sette giorni con il relativo rischio per qualsiasi punto, il profilo climatico di lungo periodo di qualsiasi punto, gli eventi pericolosi vicino a un punto e il profilo di rischio di ogni Paese. Criora offre questi dati tramite un server MCP.

Non servono account né chiavi. Il server è in sola lettura.

## Per gli assistenti AI: il server MCP

Criora gestisce un server [Model Context Protocol](https://modelcontextprotocol.io) remoto all’indirizzo:

```
https://criora.com/mcp
```

Aggiungilo come connettore personalizzato in qualsiasi assistente che supporti i server MCP remoti (Claude, ChatGPT, Cursor, VS Code e altri). Non è richiesta alcuna autenticazione. Ad esempio, in un file di configurazione MCP:

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

In VS Code o Cursor si aggiunge con un clic: [VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=criora&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcriora.com%2Fmcp%22%7D), [Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=criora&config=eyJ1cmwiOiJodHRwczovL2NyaW9yYS5jb20vbWNwIn0%3D).

Per dare gli stessi strumenti a un agente che costruisci tu, vedi [Framework per agenti](https://criora.com/it/docs/references/agent-frameworks): LangChain, LlamaIndex, l’OpenAI Agents SDK e n8n.

Il server offre gli strumenti elencati qui sotto. Quelli dedicati ai luoghi accettano latitudine e longitudine, oppure il nome di un luogo, che associano alla corrispondenza migliore e riportano nella risposta.

| Strumento | A cosa risponde |
| --- | --- |
| `assess_place` | Fino a dieci luoghi, ciascuno nei giorni richiesti, in un’unica risposta: rischio previsto giorno per giorno, oltre la previsione le normali climatiche del mese (1991-2020), pericoli nelle vicinanze, profilo climatico, Paese |
| `get_forecast` | Meteo e rischio meteorologico a sette giorni, per giorno locale o passo per passo |
| `rank_by_forecast` | Le città o i Paesi in cui il meteo dei prossimi 1-7 giorni è più pericoloso, eventualmente limitato a un solo fenomeno |
| `get_area_risk` | Il meteo dei prossimi 1-7 giorni su un intero Paese o una regione, giorno per giorno, e su richiesta i suoi layer climatici di lungo periodo |
| `get_climate_profile` | Esposizione di lungo periodo: alluvioni, innalzamento del livello del mare, caldo, siccità, stress idrico e altro; riscaldamento e variazione delle piogge come mediana dei modelli, con il loro 10° e 90° percentile |
| `get_climate_table` | Livelli a lungo termine per 2-50 luoghi in una sola chiamata, come tabella: una riga per luogo, una colonna per livello e banda; senza categorie né livelli, le esposizioni principali; ogni riga con la classe di danno di un’abitazione |
| `get_climate_twin` | La grande città il cui clima di oggi una città avrà nel 2041-2060, in due scenari |
| `get_place_history` | Ciò che ha colpito un luogo nei decenni passati: terremoti, cicloni, alluvioni, tsunami ed eruzioni per decennio, i maggiori con data, distanza, vittime e danni, e da quale anno ogni conteggio è completo |
| `estimate_financial_impact` | Danni indicativi da alluvioni e vento dei cicloni tropicali a un edificio o a un bene: il danno annuo atteso e quello degli eventi con tempo di ritorno da 50 a 500 anni, come quota del valore e in denaro, dal minimo al massimo, oggi o nel 2050 e nel 2080 |
| `get_hazards_near` | Incendi, terremoti, alluvioni, cicloni, vulcani, siccità e qualità dell’aria vicino a un luogo |
| `list_hazards` | Disastri naturali e allerte ufficiali in corso in un paese, in una regione o nel mondo intero |
| `get_country_profile` | I punteggi di rischio di un Paese e, su richiesta, gli indicatori più lontani dalla mediana mondiale, o tutti, con i relativi valori di riferimento |
| `get_enso_outlook` | Le previsioni della NOAA su El Niño e La Niña per le prossime stagioni e, per un Paese, che cosa ciascuno gli ha portato in quelle stagioni dal 1950 |
| `compare_countries` | Da due a dieci Paesi a confronto, con la rispettiva posizione in classifica |
| `rank_countries` | I Paesi a rischio più alto o più basso, nel complesso, su una dimensione o su un pericolo o un altro indicatore, eventualmente entro una regione o una fascia di reddito |
| `find_place` | Le coordinate di un luogo a partire dal nome, quando il nome è ambiguo |
| `search` | Paesi, luoghi, le pagine di Criora su metodologia e fonti dei dati e il suo catalogo di livelli e indicatori che corrispondono a una ricerca, anche quando nomina insieme un luogo e un tema, come identificativi per fetch e pagine da citare |
| `fetch` | Un Paese, un luogo, una pagina o un catalogo come documento Markdown con la pagina di Criora da citare, per agenti di ricerca come ChatGPT deep research |
| `show_risk_map` | Una mappa interattiva nella conversazione, di un luogo, di più luoghi a confronto, di un evento come una tempesta o del mondo: il rischio della settimana, o la previsione di pioggia, temperatura o vento, sotto i pericoli vicini |

Negli assistenti che mostrano le MCP Apps, come Claude, `show_risk_map` disegna la mappa nella conversazione: si può spostare e ingrandire, aprire a schermo intero, scorrere la settimana ora per ora e passare dal rischio previsto a pioggia, temperatura e vento. Si apre su un luogo, su più luoghi con la settimana di ciascuno affiancata, su un evento come una tempesta con il suo cono di previsione e la sua traiettoria oppure, se non si indica nulla di questo, sul mondo: gli eventi più critici e i paesi dove più persone sono a rischio questa settimana. Gli assistenti che non mostrano app ricevono la stessa risposta come testo, con un link al luogo sulla mappa di Criora.

Il server offre anche cinque prompt, domande già pronte da cui un assistente può partire: `assess_trip` per capire quanto è rischioso un viaggio nelle sue date, `compare_places_to_live` per confrontare l’esposizione a lungo termine di più luoghi, `country_briefing` per mettere un paese a confronto con la sua regione e con il resto del mondo, `site_due_diligence` per il rischio climatico e di catastrofi di un immobile o di un sito e `esg_country_screen` per valutare i Paesi in base al rischio climatico e di catastrofi in vista di decisioni ESG, di investimento o sulla catena di fornitura.

### Leggere il rischio previsto

Ogni passo della previsione riporta una classe di rischio da 0 (Minimo) a 4 (Critico), il pericolo che la determina e il valore fisico su cui si basa: la temperatura percepita UTCI per caldo e freddo, la velocità delle raffiche per il vento, l’intensità delle precipitazioni per pioggia e neve. Pioggia, neve e vento prevalgono sulla temperatura, secondo la stessa regola usata dalla mappa. Il riepilogo di ogni giorno indica il rischio principale e riporta, per ciascun pericolo, la classe più alta raggiunta quel giorno.

### Come leggere la gravità di un evento

Ogni evento porta `severity_rank`, Criora Severity da 0 a 100, che confronta eventi di pericoli diversi: un’alluvione con un terremoto o un incendio. Pesa il livello ufficiale dell’evento su una scala comune, le persone che vivono nella sua impronta (`people`, da GHS-POP 2025) e la sua misura rispetto alle altre del suo tipo. È stato adattato su situazioni reali passate in base a ciò che è successo dopo, e ordina il 78,5% delle loro coppie come hanno fatto le conseguenze, contro il 30% dell’ordine che Criora usava prima.

Il livello ufficiale è sempre restituito accanto al rango, mai sostituito da esso, e `footprint` indica come è stata tracciata l’area in cui si contano le persone. In una risposta dettagliata, `building_value` è il costo di ricostruzione, in euro, degli edifici e del loro contenuto nella stessa area, le abitazioni separate dal resto: un valore indicativo, non di mercato. `get_hazards_near` e `list_hazards` iniziano dall’indice più alto. `get_hazards_near`, e `list_hazards` per un paese, elencano anche in `coverage` ogni fonte che vi segnala eventi, i suoi pericoli e se sta segnalando ora o tace dalla sua ultima lettura; `warnings: false` significa che lì a Criora non arrivano ora allerte di alcuna autorità. `volcano_levels: false` significa che lì a Criora non arrivano i livelli di allerta di alcun osservatorio vulcanologico: un vulcano è noto solo per le eruzioni segnalate. Cosa pesa il rango e quanto ci si può fidare: [Criora Severity](https://criora.com/it/docs/methodology/criora-severity).

Con `days`, `get_hazards_near` e `list_hazards` elencano ogni evento attivo in quei giorni, compresi quelli conclusi, ciascuno contrassegnato da `current`: `true` finché è in corso, `false` quando è finito.

Su cosa si basa una stima del danno e quanto ci si può fidare: [Stime dell’impatto finanziario](https://criora.com/it/docs/methodology/financial-impact).

## Le pagine in markdown

Ogni pagina pubblica del sito, un paese o una città dell’Atlante, una guida, un evento, è servita anche in markdown: il testo che vede chi legge, senza l’impaginazione. Richiedete l’indirizzo stesso della pagina con `Accept: text/markdown`, oppure aggiungete `.md`, come in <https://criora.com/atlas/PRT.md>. Il testo si apre con titolo, descrizione, indirizzo e lingua della pagina. Le pagine della mappa rispondono con [llms.txt](https://criora.com/llms.txt), la descrizione del sito per gli agenti.

## Limiti

Nomi di luogo

I nomi di luogo si cercano nel dizionario geografico di Criora basato su GeoNames (CC BY 4.0):
città, paesi, villaggi, regioni, isole, vulcani e laghi con i loro nomi in tutte le lingue, ma non
gli indirizzi stradali. Se un nome è ambiguo, aggiungi la regione o il paese dopo una virgola:
Portland, Maine.

Le risposte di previsione cambiano quando viene pubblicata una nuova corsa del modello, due volte al giorno. I layer climatici cambiano quando un dataset viene ricostruito. Alle risposte possono aggiungersi nuovi campi; quelli esistenti mantengono il loro significato.

## Fonti e attribuzione

Ogni risposta indica la propria fonte. Se pubblichi o ridistribuisci dati di Criora, cita Criora e rispetta la licenza della fonte indicata: la previsione proviene da Environment and Climate Change Canada (ECCC) con la sua Data Server End-use Licence, i giorni dall’8 al 15 dalla previsione d’insieme dell’ECMWF con licenza CC BY 4.0 e la dicitura «Based on data and products of the European Centre for Medium-Range Weather Forecasts (ECMWF)», i nomi dei luoghi da GeoNames con licenza CC BY 4.0, gli indirizzi e le ricerche inverse da OpenStreetMap con licenza ODbL, e ogni layer climatico indica il proprio fornitore e la propria licenza. L’elenco completo è in [Fonti dei dati](https://criora.com/it/docs/references/data-sources). L’uso del server MCP e dei dati di Criora è regolato dai [Termini di servizio](https://criora.com/it/terms).

Criora pubblica dati, non consulenza. I suoi valori non sostituiscono una consulenza professionale in materia finanziaria, assicurativa o di sicurezza.

[Guarda sulla mappa](https://criora.com/it/)

[Guarda sulla mappa](https://criora.com/it/)