---
title: "ШІ-агенти та MCP-сервер | Criora Docs"
description: "Як отримувати дані Criora про прогноз, клімат, загрози та країни через ШІ-асистента або власного агента"
url: "https://criora.com/uk/docs/references/api-and-agents"
language: "uk"
---

# ШІ-агенти та MCP-сервер

Усе, що показують карта й Атлас Criora, доступне ШІ-асистенту або Вашому власному агенту: семиденний прогноз погоди та його ризик для будь-якої точки, довгостроковий кліматичний профіль будь-якої точки, небезпечні події поблизу точки та профіль ризиків кожної країни. Criora надає ці дані через MCP-сервер.

Ні обліковий запис, ні ключ не потрібні. Сервер працює лише на читання.

## Для ШІ-асистентів: MCP-сервер

Criora надає віддалений сервер [Model Context Protocol](https://modelcontextprotocol.io) за адресою:

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

Додайте його як власний конектор у будь-якому асистенті, що підтримує віддалені MCP-сервери (Claude, ChatGPT, Cursor, VS Code та інші). Автентифікація не потрібна. Наприклад, у конфігураційному файлі MCP:

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

У VS Code і Cursor його можна додати в один клік: [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).

Як дати ті самі інструменти агенту, якого ви будуєте самі, показано на сторінці [Фреймворки агентів](https://criora.com/uk/docs/references/agent-frameworks): LangChain, LlamaIndex, OpenAI Agents SDK і n8n.

Сервер пропонує наведені нижче інструменти. Інструменти для місць приймають широту й довготу або назву місця: інструмент сам знаходить найкращий збіг і повідомляє, яке місце обрав.

| Інструмент | На яке питання відповідає |
| --- | --- |
| `assess_place` | До десяти місць, кожне у вибрані дні, в одній відповіді: ризик за прогнозом на кожен день, за межами прогнозу кліматичні норми місяця (1991-2020), загрози поблизу, кліматичний профіль, країна |
| `get_forecast` | Погода й погодний ризик на сім днів, за місцевими добами або за кроками прогнозу |
| `rank_by_forecast` | Міста або країни, де погода найближчих 1-7 днів найнебезпечніша, за потреби за однією загрозою |
| `get_area_risk` | Погода найближчих 1-7 днів над усією країною чи регіоном за днями, а на запит і довгострокові кліматичні шари цієї території |
| `get_climate_profile` | Довгострокова експозиція: повені, підвищення рівня моря, спека, посуха, водний стрес та інші загрози; потепління та зміна опадів як медіана моделей з їхніми 10-м і 90-м процентилями |
| `get_climate_table` | Довгострокові шари для 2-50 місць за один виклик у вигляді таблиці: рядок на місце, стовпець на шар і смугу; без категорій і шарів видаються головні ризики; у кожному рядку клас збитків для житла |
| `get_climate_twin` | Велике місто, чий сьогоднішній клімат матиме місто у 2041-2060 роках, за двома сценаріями |
| `get_place_history` | Що траплялося в цьому місці за минулі десятиліття: землетруси, циклони, повені, цунамі та виверження за десятиліттями, найбільші з датою, відстанню, жертвами та збитками, і з якого року підрахунок повний |
| `estimate_financial_impact` | Орієнтовні збитки від повеней і вітру тропічних циклонів будівлі чи іншому активу: очікувані річні збитки й збитки від подій повторюваністю від 50 до 500 років, у частці вартості та в грошах, з нижньою й верхньою оцінкою, зараз або у 2050 і 2080 роках |
| `get_hazards_near` | Лісові пожежі, землетруси, повені, циклони, вулкани, посухи та якість повітря поблизу місця |
| `list_hazards` | Стихійні лиха та чинні офіційні попередження в країні, регіоні або в усьому світі |
| `get_country_profile` | Оцінки ризиків країни та, на запит, індикатори, що найбільше відхиляються від світової медіани, або всі, з їхніми орієнтирами для порівняння |
| `get_enso_outlook` | Прогноз NOAA щодо Ель-Ніньйо та Ла-Ніньї на найближчі сезони і, для країни, що кожне з цих явищ приносило їй у ці сезони з 1950 року |
| `compare_countries` | Від двох до десяти країн у порівнянні, з їхніми місцями в рейтингу |
| `rank_countries` | Країни з найвищим або найнижчим ризиком, загалом, за одним виміром або за однією небезпекою чи іншим індикатором, за потреби в межах регіону чи групи за доходом |
| `find_place` | Координати за назвою місця, якщо назва неоднозначна |
| `search` | Країни, місця, сторінки Criora про методологію і джерела даних та її каталог шарів і показників, що відповідають запиту, зокрема коли в ньому названо і місце, і тему, у вигляді ідентифікаторів для fetch і сторінок для цитування |
| `fetch` | Країна, місце, сторінка або каталог як документ Markdown із посиланням на сторінку Criora для цитування, для дослідницьких агентів на кшталт ChatGPT deep research |
| `show_risk_map` | Інтерактивна мапа просто в розмові: місця, кількох місць поруч, однієї події, наприклад шторму, або всього світу; ризик цього тижня або прогноз опадів, температури чи вітру під небезпечними явищами поблизу |

В асистентах, які показують MCP Apps, наприклад у Claude, `show_risk_map` малює мапу просто в розмові: її можна рухати й масштабувати, відкрити на весь екран, програти тиждень по годинах і перемикатися між прогнозом ризику, опадів, температури й вітру. Вона відкривається на місці, на кількох місцях із тижнем кожного поруч, на одній події, наприклад шторму з його конусом прогнозу й траєкторією, або, якщо нічого з цього не вказано, на всьому світі: найкритичніші події та країни, де цього тижня найбільше людей під загрозою. Асистенти без застосунків отримують ту саму відповідь текстом, з посиланням на місце на мапі Criora.

Крім того, сервер пропонує п’ять промптів, готових запитань, з яких асистент може почати: `assess_trip` показує, наскільки ризикована поїздка у вибрані дати, `compare_places_to_live` порівнює довгострокові ризики кількох місць, `country_briefing` зіставляє країну з її регіоном і рештою світу, `site_due_diligence` оцінює кліматичні ризики й ризики катастроф для об’єкта нерухомості чи майданчика, а `esg_country_screen` порівнює країни за кліматичними ризиками й ризиками катастроф для рішень у сфері ESG, інвестицій або ланцюгів постачання.

### Як читати ризик у прогнозі

Кожен крок прогнозу містить клас ризику від 0 («Слабкий») до 4 («Тяжкий»), загрозу, яка його визначає, і фізичну величину, на якій він ґрунтується: відчутну температуру за індексом UTCI для спеки й холоду, швидкість поривів для вітру, інтенсивність опадів для дощу й снігу. Дощ, сніг і вітер мають пріоритет над температурою: за тим самим правилом працює карта. Зведення кожного дня називає головний ризик дня й перелічує найвищий клас, якого того дня досягає кожна загроза.

### Як читати тяжкість події

Кожна подія має `severity_rank`, індекс Criora Severity від 0 до 100, що дає змогу порівнювати події різних типів: повінь із землетрусом чи пожежею. Він враховує офіційний рівень події на єдиній шкалі, кількість людей, які живуть у зоні впливу (`people`, за даними GHS-POP 2025), і показник події серед інших того самого типу. Індекс підібрано за реальними минулими ситуаціями за тим, що сталося потім, і він розставляє 78,5% їхніх пар так само, як їх розставили наслідки, проти 30% для порядку, яким Criora користувалася раніше.

Офіційний рівень завжди повертається поруч з індексом і ніколи ним не замінюється, а `footprint` вказує, як побудовано зону, у якій рахують людей. У детальній відповіді `building_value` означає вартість заміщення в євро будівель і їхнього вмісту в тій самій зоні, житло окремо від решти: орієнтовна оцінка, не ринкова вартість. Відповіді `get_hazards_near` і `list_hazards` починаються з подій із найвищим індексом. Відповіді `get_hazards_near`, а для країни й `list_hazards`, також перелічують у `coverage` усі джерела, що повідомляють про це місце, їхні загрози і те, чи працює джерело зараз, чи мовчить від останнього читання; `warnings: false` означає, що попередження офіційних служб про це місце зараз до Criora не доходять. `volcano_levels: false` означає, що рівні тривоги вулканологічних обсерваторій про це місце до Criora не доходять: про вулкан відомо лише з повідомлень про виверження. Що враховує індекс і наскільки йому можна довіряти: [Criora Severity](https://criora.com/uk/docs/methodology/criora-severity).

З `days` відповіді `get_hazards_near` і `list_hazards` містять усі події, активні в ці дні, зокрема вже завершені; кожна має поле `current`: `true`, поки подія триває, і `false`, коли вона закінчилася.

На чому ґрунтується оцінка збитків і наскільки їй можна довіряти: [Оцінки фінансових збитків](https://criora.com/uk/docs/methodology/financial-impact).

## Сторінки у форматі markdown

Кожна публічна сторінка сайту, країна чи місто в Атласі, посібник, подія, доступна також у markdown: текст, який бачить читач, без верстки. Запитайте адресу самої сторінки із заголовком `Accept: text/markdown` або додайте до неї `.md`, як-от <https://criora.com/atlas/PRT.md>. Текст починається з назви, опису, адреси та мови сторінки. Сторінки мапи відповідають файлом [llms.txt](https://criora.com/llms.txt), описом сайту для агентів.

## Обмеження

Назви місць

Назви місць шукаються у власному довіднику Criora на основі GeoNames (CC BY 4.0): міста, селища,
села, регіони, острови, вулкани й озера з назвами всіма мовами, але не адреси вулиць. Якщо назва
неоднозначна, додайте регіон або країну через кому: Portland, Maine.

Відповіді з прогнозом змінюються, коли публікується новий прогін моделі, тобто двічі на добу. Кліматичні шари змінюються, коли набір даних перебудовується. У відповідях можуть з’являтися нові поля; наявні поля зберігають своє значення.

## Джерела та зазначення авторства

Кожна відповідь називає своє джерело. Публікуючи або поширюючи дані Criora, зазначайте Criora та дотримуйтеся ліцензії названого джерела: прогноз надає Міністерство довкілля та зміни клімату Канади (ECCC) за ліцензією Data Server End-use Licence, дні з 8-го по 15-й узято з ансамблю ECMWF за ліцензією CC BY 4.0 із зазначенням «Based on data and products of the European Centre for Medium-Range Weather Forecasts (ECMWF)», назви місць узято з GeoNames за ліцензією CC BY 4.0, адреси та зворотний пошук з OpenStreetMap за ліцензією ODbL, а кожен кліматичний шар зазначає власного постачальника й ліцензію. Повний перелік наведено в розділі [Джерела даних](https://criora.com/uk/docs/references/data-sources). Використання MCP-сервера та даних Criora регулюють [Умови використання](https://criora.com/uk/terms).

Criora публікує дані, а не поради. Її цифри не замінюють професійної консультації з фінансових і страхових питань чи з питань безпеки.

[Подивитися на мапі](https://criora.com/uk/)

[Подивитися на мапі](https://criora.com/uk/)