Вход

Предоставляет доступ к открытым данным о погоде, климате и окружающей среде: геокодирование, прогнозы, исторические данные, морские условия, качество воздуха и высота над уровнем моря без необходимости ключей API.

давно не проверялся Удалённый · Streamable HTTP Без авторизации Исследования Данные и базы Open-Meteo Модерация · 21 просмотров

Что умеет

Предоставляет доступ к открытым данным о погоде, климате и окружающей среде: геокодирование, прогнозы, исторические данные, морские условия, качество воздуха и высота над уровнем моря без необходимости ключей API.

Перевод каталога (LLM) · показать оригинал автора

Геокодирование, прогноз, исторический климат, морские условия, качество воздуха и высота над уровнем моря — на открытых данных Open-Meteo, без ключей.

  • Публичный хостинг, ключи не нужны
  • Координаты, климат и качество воздуха в одном наборе

Кому пригодится

  • Автоматическая генерация точных погодных прогнозов для конкретных городов или координат, где агент сначала использует геокодирование для получения широты и долготы, исключая ошибки от абстрактных названий мест.
  • Проведение ретроспективного анализа климатических условий за прошлые периоды (например, оценка последствий урагана или засухи) на основе реальных исторических данных Open-Meteo вместо выдуманных фактов LLM.
  • Оценка рисков природных катаклизмов в реальном времени, включая прогноз волн, качества воздуха и паводков, с возможностью выполнения SQL-запросов для фильтрации массивных наборов данных по нужным параметрам.
  • Интеграция долгосрочных климатических проекций до 2050 года в аналитические отчеты для стратегического планирования, обеспечивая агент актуальными научными данными без ручного поиска источников.

Подключение

Удалённый сервер: клиент обращается по адресу, код на вашей машине не запускается.

Claude Desktop

claude_desktop_config.json

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Вставьте блок mcpServers в файл конфигурации своего клиента. Ключи не входят в файл: вместо SET_LOCALLY подставьте свои значения.

{
    "mcpServers": {
        "open-meteo-mcp": {
            "url": "https://open-meteo.caseyjhand.com/mcp"
        }
    }
}

Вызов без установки — через шлюз

Агент вызывает инструменты этого сервера через https://www.n2j.ru/mcphub/mcp: hub_call_tool {"server":"open-meteo-mcp","tool":"…","arguments":{…}} Ключ не нужен, но сервер N2J ограничивает частоту анонимных вызовов.

https://open-meteo.caseyjhand.com/mcp

Полевое исследование ИИ-агентом

Алмаз каталога

Воркер-агент подключается к открытому серверу, проверяет схемы и безопасность и выполняет пробный вызов инструментов. Проверено 24.10.2026 22:36

Оценка практической пользы

92 / 100

Оценка безопасности

93 / 100

Вердикт исследователя

Алмаз каталога

Сервер Open-Meteo MCP является полноценным источником достоверных метеорологических данных для ИИ-агентов, предоставляя доступ к прогнозам, историческим архивам и климатическим моделям без необходимости в API-ключе. Живой тест подтвердил работоспособность геокодирования и получения координат, что позволяет агенту точно привязывать запросы пользователя к реальным местоположениям для последующего анализа погоды или рисков наводнений.

Реальное применение для агентов

  • Автоматическая генерация точных погодных прогнозов для конкретных городов или координат, где агент сначала использует геокодирование для получения широты и долготы, исключая ошибки от абстрактных названий мест.
  • Проведение ретроспективного анализа климатических условий за прошлые периоды (например, оценка последствий урагана или засухи) на основе реальных исторических данных Open-Meteo вместо выдуманных фактов LLM.
  • Оценка рисков природных катаклизмов в реальном времени, включая прогноз волн, качества воздуха и паводков, с возможностью выполнения SQL-запросов для фильтрации массивных наборов данных по нужным параметрам.
  • Интеграция долгосрочных климатических проекций до 2050 года в аналитические отчеты для стратегического планирования, обеспечивая агент актуальными научными данными без ручного поиска источников.

Безопасность

Сервер полностью безопасен: все инструменты имеют корректные JSON-схемы, отсутствуют уязвимости к prompt-injection и скрытые требования к аутентификации. Единственный инструмент с возможностью записи (historical) изолирован от основных операций чтения прогнозов.

Наблюдения полевого агента

Живой вызов инструмента геокодирования успешно вернул структурированные данные о координатах, часовых поясах и населении для нескольких локаций за 1565 мс. Инструменты работы с таблицами данных (describe) требуют корректного ID канваса от предыдущего запроса, что подтверждает необходимость последовательности в работе агента.

Пробные вызовы инструментов (tools/call)

openmeteo_search_locations OK · 1565 мс

Geocoding results for search Blukbuk (ID) — Indonesia, West Java — -6.10528, 106.41833 12m id: 1959830 timezone: Asia/Jakarta feature: PPL Testa (SE) — Sweden, Uppsala County, Uppsala Municipality — 59.83333, 17.28333 37m id: 2669164 timezone: Europe/Stockholm feature: PPL Testa (SE) — Sweden, Örebr

openmeteo_dataframe_describe ошибка · 890 мс

Error: Input validation error: Invalid arguments for tool openmeteo dataframe describe: canvas id: Expected a canvas ID exactly as an earlier response on this server returned it: 10 characters of letters, digits, hyphens, and underscores. A table name is not a canvas ID. (reason invalid arguments ·

Инструменты

11 схем · ≈ 9 090 условных токенов

openmeteo_search_locations

Resolve a place name to ranked coordinate matches with country, region, elevation, timezone, and population. Required prerequisite for name-based queries — all weather tools take latitude/longitude, not place names. Search by a bare place name (city, region, or landmark); never fold a qualifier into it — pass "Baoding", not "Baoding Hebei", and "Paris", not "Paris, France". To disambiguate places that share a name, set the country input (ISO 3166-1 alpha-2, e.g. "US") and/or read the admin1 and country fields on each ranked result — admin1 is a result field for choosing among matches, not a se

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "name"
    ],
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 100,
            "minLength": 1,
            "description": "Place name to search — a bare city, region, or landmark (\"Seattle\", \"Mount Rainier\"). Do not fold in a region or country qualifier (\"Baoding\", not \"Baoding Hebei\"); use the country input to disambiguate. A one- or two-character native-script name (\"서울\", \"大阪\") needs the full administrative name (\"서울특별시\", \"大阪市\") or the romanized name (\"Seoul\", \"Osaka\") — see the language field. Weather tools require coordinates — use the lat/lon from this result."
        },
        "count": {
            "type": "integer",
            "default": 5,
            "maximum": 10,
            "minimum": 1,
            "description": "Max results to return (1–10). Default 5. Return more when disambiguating common names like \"Springfield\" or \"Portland\"."
        },
        "country": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "ISO 3166-1 alpha-2 country code (e.g. \"US\", \"FR\") to disambiguate places that share a name. Omit for a global search."
        },
        "language": {
            "type": "string",
            "default": "en",
            "description": "Language for matching and returning place names (ISO 639-1, e.g., \"en\", \"de\", \"zh\"). The API matches name against the localized index for this language, so set it to match the script of name — e.g. language \"zh\" for \"上海\", \"ru\" for \"Москва\". This resolves a native-script name of three or more characters, which is matched by normalized prefix; a one- or two-character name must equal an index entry exactly, so setting language alone will not find \"서울\" or \"大阪\" — retry those with the full administrative name (\"서울특별시\", \"大阪市\") or the romanized name (\"Seoul\", \"Osaka\"). Default \"en\"; a query in a recognized non-Latin script (CJK, Hangul, Cyrillic, Arabic, Greek, Hebrew, Thai, Devanagari) that misses under \"en\" is retried once with the language inferred from its script, and effective_language on the response names that language when the retry supplied the results."
        }
    },
    "additionalProperties": false
}

openmeteo_get_elevation

Terrain elevation from the Copernicus Digital Elevation Model (~90m resolution) for one or more coordinate pairs. Accepts up to 100 pairs per call. Useful for geographic context, elevation-adjusted weather interpretation, or route planning. A point the DEM has no value for (latitude 90) returns elevation m null; the other points in the call are unaffected.

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitudes",
        "longitudes"
    ],
    "properties": {
        "latitudes": {
            "type": "array",
            "items": {
                "type": "number",
                "maximum": 90,
                "minimum": -90
            },
            "maxItems": 100,
            "minItems": 1,
            "description": "Array of latitudes in decimal degrees (up to 100). Must be same length as longitudes."
        },
        "longitudes": {
            "type": "array",
            "items": {
                "type": "number",
                "maximum": 180,
                "minimum": -180
            },
            "maxItems": 100,
            "minItems": 1,
            "description": "Array of longitudes in decimal degrees (up to 100). Must be same length as latitudes."
        }
    },
    "additionalProperties": false
}

openmeteo_get_forecast

Weather forecast for coordinates: hourly and/or daily variables for up to 16 days ahead, with optional past days (up to 92) for recent history. Use past days instead of openmeteo get historical for dates within the last 1–5 days, since the archive’s ERA5 components lag by up to ~5 days. Returns per-timestamp records — each hourly entry contains a "time" field (ISO 8601) plus one key per requested variable; each daily entry contains a "time" field (YYYY-MM-DD) plus requested variables. Common hourly variables: temperature 2m, precipitation, wind speed 10m, relative humidity 2m, cloud cover, uv

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude"
    ],
    "properties": {
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees (e.g., 47.6062 for Seattle). Use openmeteo_search_locations to resolve a place name to coordinates."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone (e.g., \"America/Los_Angeles\") or \"auto\" to use the location's local timezone. Default \"auto\". The timezone from openmeteo_search_locations is ideal to pass here."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for wide past_days or multi-variable queries. When a result is too large to return inline — driven by total payload size, so a wide multi-variable pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees (e.g., -122.3321 for Seattle)."
        },
        "past_days": {
            "type": "integer",
            "default": 0,
            "maximum": 92,
            "minimum": 0,
            "description": "Include this many days of past data before today (0–92). Use for recent history — the archive’s ERA5 components lag by up to ~5 days. Default 0."
        },
        "forecast_days": {
            "type": "integer",
            "default": 7,
            "maximum": 16,
            "minimum": 1,
            "description": "Number of forecast days (1–16). Default 7."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Daily summary variables (e.g., [\"temperature_2m_max\", \"temperature_2m_min\", \"precipitation_sum\", \"wind_speed_10m_max\", \"sunrise\", \"sunset\", \"uv_index_max\"]). Daily names only — an hourly name such as cloud_cover or temperature_2m belongs in hourly_variables and is rejected here; for a daily summary of an hourly variable use its published aggregate (cloud_cover_max, cloud_cover_mean, cloud_cover_min). At least one of current_variables, hourly_variables, or daily_variables is required."
        },
        "wind_speed_unit": {
            "enum": [
                "kmh",
                "mph",
                "ms",
                "kn"
            ],
            "type": "string",
            "default": "kmh",
            "description": "Wind speed unit: \"kmh\" (km/h), \"mph\", \"ms\" (m/s), or \"kn\" (knots). Default \"kmh\"."
        },
        "hourly_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Hourly variables to fetch (e.g., [\"temperature_2m\", \"precipitation\", \"wind_speed_10m\", \"relative_humidity_2m\", \"cloud_cover\", \"uv_index\", \"apparent_temperature\"]). Hourly names only — a daily aggregate such as temperature_2m_max or precipitation_sum belongs in daily_variables and is rejected here. At least one of current_variables, hourly_variables, or daily_variables is required."
        },
        "temperature_unit": {
            "enum": [
                "celsius",
                "fahrenheit"
            ],
            "type": "string",
            "default": "celsius",
            "description": "Temperature unit. Default \"celsius\"."
        },
        "current_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Variables to return for the current instant (e.g., [\"temperature_2m\", \"precipitation\", \"wind_speed_10m\", \"weather_code\"]). Uses Open-Meteo's 15-minute current-conditions data, so it answers \"what is it doing right now?\" without requesting an hourly series and picking a row. Takes the hourly variable names; a daily-only name such as temperature_2m_max comes back null with the unit \"undefined\" and is reported in the notice. Satisfies the variable requirement on its own."
        },
        "precipitation_unit": {
            "enum": [
                "mm",
                "inch"
            ],
            "type": "string",
            "default": "mm",
            "description": "Precipitation unit: \"mm\" or \"inch\". Default \"mm\"."
        }
    },
    "additionalProperties": false
}

openmeteo_get_historical

Historical weather from the Open-Meteo reanalysis archive (1940–present). Requires start date and end date (ISO 8601 date, e.g., "2024-07-01"). With models omitted the archive answers from Best Match, which blends IFS HRES, ERA5, and ERA5-Land seamlessly — so the source varies by date and no single update lag describes the response. Set models to pin a consistent source for a multi-decade series: the ERA5 family updates daily with about a 5-day delay, while IFS HRES has none, so for the last few days either request models: ["ecmwf ifs"] or use openmeteo get forecast with past days. Available m

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude",
        "start_date",
        "end_date"
    ],
    "properties": {
        "models": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 8,
            "description": "Archive models to read from: best_match (default, blends IFS HRES + ERA5 + ERA5-Land), ecmwf_ifs (global 9 km, updated every 6 hours, no delay), ecmwf_ifs_analysis_long_window (global 9 km, daily, 2 days delay), era5_seamless (ERA5 and ERA5-Land combined), era5 (global 0.25° (~25 km), daily, 5 days delay), era5_land (global 0.1° (~11 km), daily, 5 days delay), era5_ensemble (global 0.5° (~55 km), daily, 5 days delay), cerra (Europe only, 5 km, no real-time updates). Omit to use Open-Meteo's Best Match default, which blends IFS HRES, ERA5, and ERA5-Land — pin a model instead when a consistent source matters across the range. With 2+ models each variable column is suffixed with the model name. cerra covers Europe only and is rejected as a coverage gap elsewhere. A name outside this list is sent upstream rather than rejected here."
        },
        "end_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "End date (YYYY-MM-DD, inclusive). Must be on or after start_date. For the last few days, either request models: [\"ecmwf_ifs\"] or use openmeteo_get_forecast with past_days."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees. Use openmeteo_search_locations to resolve a place name to coordinates."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone or \"auto\". Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for multi-year or multi-variable queries. When a result is too large to return inline — driven by total payload size, so a wide multi-variable pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees."
        },
        "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Start date (YYYY-MM-DD, e.g., \"2024-07-01\"). The archive covers from 1940-01-01; how close to today it reaches depends on the model — the ERA5 family runs about 5 days behind, IFS HRES is current."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Daily summary variables (e.g., [\"temperature_2m_max\", \"temperature_2m_min\", \"precipitation_sum\", \"wind_speed_10m_max\"]). Daily names only — an hourly name such as cloud_cover or temperature_2m belongs in hourly_variables and is rejected here; for a daily summary of an hourly variable use its published aggregate (cloud_cover_max, cloud_cover_mean, cloud_cover_min). At least one of hourly_variables or daily_variables required."
        },
        "wind_speed_unit": {
            "enum": [
                "kmh",
                "mph",
                "ms",
                "kn"
            ],
            "type": "string",
            "default": "kmh",
            "description": "Wind speed unit. Default \"kmh\"."
        },
        "hourly_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Hourly archive variables (e.g., [\"temperature_2m\", \"precipitation\", \"wind_speed_10m\", \"relative_humidity_2m\", \"cloud_cover\", \"soil_moisture_0_to_7cm\"]). Hourly names only — a daily aggregate such as temperature_2m_max or precipitation_sum belongs in daily_variables and is rejected here. At least one of hourly_variables or daily_variables required."
        },
        "temperature_unit": {
            "enum": [
                "celsius",
                "fahrenheit"
            ],
            "type": "string",
            "default": "celsius",
            "description": "Temperature unit. Default \"celsius\"."
        },
        "precipitation_unit": {
            "enum": [
                "mm",
                "inch"
            ],
            "type": "string",
            "default": "mm",
            "description": "Precipitation unit. Default \"mm\"."
        }
    },
    "additionalProperties": false
}

openmeteo_get_marine

Marine wave and ocean conditions for a coastal or ocean coordinate: wave height, wave period, wave direction, wind-wave height, swell height, sea-surface temperature. Forecast horizon up to 8 days, with optional past days (up to 92) for recent history — or start date and end date together for an archive range, which returns real wave values back to at least 2022. One window per call: a date range is mutually exclusive with forecast days and past days, and needs both ends — a lone start date or end date is rejected. Returns per-timestamp records — each entry contains a "time" field plus one key

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude"
    ],
    "properties": {
        "end_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "End date for the archive range (YYYY-MM-DD, inclusive). Must be on or after start_date. Requires start_date — the pair must be sent together, and neither combines with forecast_days or past_days."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude of a coastal or ocean point. Use openmeteo_search_locations to resolve a place name. Sheltered water returns near-zero wave values; a land point returns null values, which the notice reports."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone or \"auto\". Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for wide past_days, archive-range, or multi-variable queries. When a result is too large to return inline — driven by total payload size, so a wide multi-variable pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees."
        },
        "past_days": {
            "type": "integer",
            "default": 0,
            "maximum": 92,
            "minimum": 0,
            "description": "Include this many days of past data before today (0–92). Use for recent history instead of a start_date/end_date range. Default 0. Must stay 0 when start_date/end_date are used."
        },
        "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Start date for the archive range (YYYY-MM-DD, e.g., \"2024-07-01\"). Real wave values go back to at least 2022. Requires end_date — the pair must be sent together, and neither combines with forecast_days or past_days."
        },
        "forecast_days": {
            "type": "integer",
            "maximum": 8,
            "minimum": 1,
            "description": "Forecast horizon in days (1–8). Omit for the upstream default of 7. Mutually exclusive with start_date/end_date — omit it entirely when pulling an archive range."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Daily marine summary variables (e.g., [\"wave_height_max\", \"wave_direction_dominant\", \"wave_period_max\"]). Daily names only — an hourly name such as wave_height belongs in hourly_variables and is rejected here; for a daily summary use its published aggregate (wave_height_max). At least one of hourly_variables or daily_variables required."
        },
        "hourly_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Hourly marine variables (e.g., [\"wave_height\", \"wave_direction\", \"wave_period\", \"wind_wave_height\", \"swell_wave_height\"]). Hourly names only — a daily aggregate such as wave_height_max or wave_direction_dominant belongs in daily_variables and is rejected here. At least one of hourly_variables or daily_variables required."
        }
    },
    "additionalProperties": false
}

openmeteo_get_air_quality

Modeled CAMS (Copernicus Atmosphere Monitoring Service) air quality: PM2.5, PM10, nitrogen dioxide, sulphur dioxide, ozone, carbon monoxide, dust, pollen, and European/US AQI indices. This is modeled grid data, not measured station readings — for measured data, use openaq-mcp-server. Forecast horizon up to 7 days, with optional past days (up to 92) for recent history — or start date and end date together for an archive range; the CAMS global archive begins in August 2022, and earlier dates return rows of nulls. One window per call: a date range is mutually exclusive with forecast days and past

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude"
    ],
    "properties": {
        "end_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "End date for the archive range (YYYY-MM-DD, inclusive). Must be on or after start_date. Requires start_date — the pair must be sent together, and neither combines with forecast_days or past_days."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees. Use openmeteo_search_locations to resolve a place name."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone or \"auto\". Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for wide past_days, archive-range, or multi-variable queries. When a result is too large to return inline — driven by total payload size, so a wide multi-variable pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees."
        },
        "past_days": {
            "type": "integer",
            "default": 0,
            "maximum": 92,
            "minimum": 0,
            "description": "Include this many days of past data before today (0–92). Use for recent history instead of a start_date/end_date range. Default 0. Must stay 0 when start_date/end_date are used."
        },
        "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Start date for the archive range (YYYY-MM-DD, e.g., \"2024-07-01\"). The CAMS global archive begins in August 2022; earlier dates return rows of nulls, and us_aqi starts a day later than the pollutant series (european_aqi starts with it). Requires end_date — the pair must be sent together, and neither combines with forecast_days or past_days."
        },
        "forecast_days": {
            "type": "integer",
            "maximum": 7,
            "minimum": 1,
            "description": "Forecast horizon in days (1–7). Omit for the upstream default of 5. Mutually exclusive with start_date/end_date — omit it entirely when pulling an archive range."
        },
        "hourly_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Hourly air quality variables (e.g., [\"pm2_5\", \"pm10\", \"ozone\", \"nitrogen_dioxide\", \"european_aqi\", \"us_aqi\"]). At least one of current_variables or hourly_variables is required."
        },
        "current_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Air quality variables to return for the current instant (e.g., [\"pm2_5\", \"pm10\", \"european_aqi\", \"us_aqi\"]). Uses Open-Meteo's current-conditions data, so it answers \"what is the AQI now?\" without requesting an hourly series and picking a row; the returned interval is the block's aggregation interval, 3600 seconds on this endpoint. Satisfies the variable requirement on its own."
        }
    },
    "additionalProperties": false
}

openmeteo_get_ensemble

Probabilistic ensemble weather forecast — up to 64 ensemble members, up to 35 days ahead with optional past days (0–92). Most models end within 16 days; a model's columns are null past its horizon, and the response notice names where its data ends. Each member's values appear as separate columns named with a member suffix (e.g. temperature 2m member01, temperature 2m member02). Use the spread across members to compute exceedance probabilities, quantify forecast uncertainty, and build decision thresholds. Available models: ecmwf ifs025 ensemble (51 members, global 0.25°), ecmwf aifs025 ensemble

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude"
    ],
    "properties": {
        "models": {
            "type": "string",
            "description": "Ensemble model to use, one name: ecmwf_ifs025_ensemble (51 members, global 0.25°), ecmwf_aifs025_ensemble (51, global 0.25°), ecmwf_ifs_europe_ensemble (51, Europe 9 km), ecmwf_aifs_europe_ensemble (51, Europe 31 km), google_weathernext2_ensemble (64, global 0.25°), ncep_gefs_seamless (31, global blend), ncep_gefs025 (31, global 0.25°), ncep_gefs05 (31, global 50 km, 35 days), ncep_aigefs025 (31, global 0.25°), icon_seamless_eps (20–40, global/Europe blend), icon_global_eps (40, global 26 km), icon_eu_eps (40, Europe 13 km), icon_d2_eps (20, Central Europe 2 km), gem_global_ensemble (21, global 0.25°), bom_access_global_ensemble (18, global 40 km), ukmo_global_ensemble_20km (18, global 20 km), ukmo_uk_ensemble_2km (3, UK 2 km), meteoswiss_icon_ch1_ensemble (11, Central Europe 1 km), meteoswiss_icon_ch2_ensemble (21, Central Europe 2 km). Member counts include the control run. Omit or leave blank to use ecmwf_ifs025_ensemble. A name outside this list is sent upstream rather than rejected here, so a model Open-Meteo adds later still works."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees. Use openmeteo_search_locations to resolve a place name to coordinates."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone (e.g., \"America/Los_Angeles\") or \"auto\" to use the location's local timezone. Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for large multi-member queries. When a result is too large to return inline — driven by total payload size, so a wide member fan-out can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its per-member columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees."
        },
        "past_days": {
            "type": "integer",
            "default": 0,
            "maximum": 92,
            "minimum": 0,
            "description": "Include this many days of past ensemble data before today (0–92). Default 0."
        },
        "forecast_days": {
            "type": "integer",
            "default": 7,
            "maximum": 35,
            "minimum": 1,
            "description": "Forecast horizon in days (1–35). Default 7. Most ensemble models end within 16 days; past a model's horizon its columns come back null and the response notice names where its data ends."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Daily variables to fetch across all ensemble members (e.g., [\"temperature_2m_max\", \"temperature_2m_min\", \"precipitation_sum\"]). Each variable appears as temperature_2m_max_member01, … Daily names only — an hourly name such as precipitation or temperature_2m belongs in hourly_variables and is rejected here; for a daily summary use its published aggregate (precipitation_sum, temperature_2m_max). At least one of hourly_variables or daily_variables required."
        },
        "wind_speed_unit": {
            "enum": [
                "kmh",
                "mph",
                "ms",
                "kn"
            ],
            "type": "string",
            "default": "kmh",
            "description": "Wind speed unit. Default \"kmh\"."
        },
        "hourly_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Hourly variables to fetch across all ensemble members (e.g., [\"temperature_2m\", \"precipitation\", \"wind_speed_10m\"]). Each variable appears as temperature_2m_member01, temperature_2m_member02, … in the output. Hourly names only — a daily-only aggregate such as precipitation_sum or wind_speed_10m_max belongs in daily_variables and is rejected here; temperature_2m_max and temperature_2m_min are an exception, published here as 3-hourly aggregations as well as daily. At least one of hourly_variables or daily_variables required."
        },
        "temperature_unit": {
            "enum": [
                "celsius",
                "fahrenheit"
            ],
            "type": "string",
            "default": "celsius",
            "description": "Temperature unit. Default \"celsius\"."
        },
        "precipitation_unit": {
            "enum": [
                "mm",
                "inch"
            ],
            "type": "string",
            "default": "mm",
            "description": "Precipitation unit. Default \"mm\"."
        }
    },
    "additionalProperties": false
}

openmeteo_get_flood

GloFAS (Global Flood Awareness System) river discharge forecast and historical reanalysis. Returns daily river discharge (m³/s) for the largest modeled river within 5 km of the given coordinates — no river ID needed. That river is not always the closest one: at 5 km resolution a point near a confluence or a pair of parallel channels can resolve to an unintended reach. When the returned discharge looks unrepresentative for the intended river, Open-Meteo suggests varying the coordinate by about 0.1° and comparing the values. Forecast horizon up to 210 days ahead; reanalysis history back to 1984-

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude"
    ],
    "properties": {
        "end_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "End date for historical reanalysis (YYYY-MM-DD, inclusive). Must be on or after start_date. Requires start_date — the pair must be sent together, and neither combines with forecast_days."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees. Discharge is returned for the largest modeled river within 5 km of this point — no river ID required, and not necessarily the closest river. Vary the coordinate by about 0.1° and compare when the result looks unrepresentative. Use openmeteo_search_locations to resolve a place name."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone or \"auto\". Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for wide reanalysis queries. When a result is too large to return inline — driven by total payload size, so a multi-variable pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees. With latitude it selects the largest modeled river within 5 km, which is not necessarily the closest one."
        },
        "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Start date for historical reanalysis (YYYY-MM-DD, e.g., \"2023-01-01\"). GloFAS reanalysis covers from 1984-01-01. Requires end_date — the pair must be sent together, and neither combines with forecast_days."
        },
        "forecast_days": {
            "type": "integer",
            "maximum": 210,
            "minimum": 1,
            "description": "Number of forecast days ahead (1–210). Mutually exclusive with start_date/end_date — omit it entirely when pulling a historical range."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 20,
            "description": "Daily discharge variables to fetch (e.g., [\"river_discharge\", \"river_discharge_p25\", \"river_discharge_p75\", \"river_discharge_min\", \"river_discharge_max\"]). Required. river_discharge is the daily discharge value; the _mean, _median, _min, _max, _p25, and _p75 statistics span the ensemble members in forecast mode only — in reanalysis mode they repeat river_discharge and are not uncertainty estimates."
        }
    },
    "additionalProperties": false
}

openmeteo_get_climate

Long-range climate projections from bias-corrected daily CMIP6 models, covering 1950-01-01 to 2050-12-31 at any coordinate. Answers "what will conditions look like through 2050?" — the future-projection counterpart to openmeteo get historical (the observed archive, what happened). Daily resolution only. Available models: CMCC CM2 VHR4, FGOALS f3 H, HiRAM SIT HR, MRI AGCM3 2 S, EC Earth3P HR, MPI ESM1 2 XR, NICAM16 8S. A model name outside that list is sent upstream rather than rejected here, so a model Open-Meteo adds later still works; if upstream rejects the request, the error names the offe

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "latitude",
        "longitude",
        "start_date",
        "end_date"
    ],
    "properties": {
        "models": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 7,
            "description": "CMIP6 models to include: CMCC_CM2_VHR4, FGOALS_f3_H, HiRAM_SIT_HR, MRI_AGCM3_2_S, EC_Earth3P_HR, MPI_ESM1_2_XR, NICAM16_8S. With 2+ models each variable column is suffixed with the model name (e.g. temperature_2m_max_MRI_AGCM3_2_S). Omit to use the API default (a single model, unsuffixed columns). A name outside this list is sent upstream rather than rejected here."
        },
        "end_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "End date (YYYY-MM-DD, inclusive, max 2050-12-31). Must be on or after start_date."
        },
        "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90,
            "description": "Latitude in decimal degrees. Use openmeteo_search_locations to resolve a place name to coordinates."
        },
        "timezone": {
            "type": "string",
            "default": "auto",
            "description": "IANA timezone or \"auto\". Default \"auto\"."
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "DataCanvas token for multi-decade or multi-model queries. When a result is too large to return inline — driven by total payload size, so a wide multi-model pull can spill at any row count — it spills to this canvas: pass the returned token to openmeteo_dataframe_describe to list the staged table and its per-model columns, then to openmeteo_dataframe_query to run SQL against it. Omit to create a fresh canvas."
        },
        "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180,
            "description": "Longitude in decimal degrees."
        },
        "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Start date (YYYY-MM-DD, e.g., \"2049-01-01\"). CMIP6 projections cover 1950-01-01 to 2050-12-31."
        },
        "daily_variables": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "description": "Daily climate variables to fetch (e.g., [\"temperature_2m_max\", \"temperature_2m_min\", \"precipitation_sum\", \"wind_speed_10m_mean\", \"shortwave_radiation_sum\"]). Required — the Climate API is daily-only."
        },
        "wind_speed_unit": {
            "enum": [
                "kmh",
                "mph",
                "ms",
                "kn"
            ],
            "type": "string",
            "default": "kmh",
            "description": "Wind speed unit. Default \"kmh\"."
        },
        "temperature_unit": {
            "enum": [
                "celsius",
                "fahrenheit"
            ],
            "type": "string",
            "default": "celsius",
            "description": "Temperature unit. Default \"celsius\"."
        },
        "precipitation_unit": {
            "enum": [
                "mm",
                "inch"
            ],
            "type": "string",
            "default": "mm",
            "description": "Precipitation unit. Default \"mm\"."
        }
    },
    "additionalProperties": false
}

openmeteo_dataframe_query

Run a read-only SQL SELECT against tables staged on a DataCanvas by openmeteo get forecast, openmeteo get historical, openmeteo get marine, openmeteo get air quality, openmeteo get ensemble, openmeteo get flood, or openmeteo get climate. Pass the canvas id returned when any of those tools spills (truncated: true), and reference the exact table name those tools return alongside it. Call openmeteo dataframe describe to list staged tables and their columns when you need to discover names. Returns up to 100 leading rows — fewer when wide rows would pass the 80,000-character inline ceiling — plus r

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "canvas_id",
        "sql"
    ],
    "properties": {
        "sql": {
            "type": "string",
            "description": "Read-only SELECT statement. Reference table names from openmeteo_dataframe_describe. Example: SELECT AVG(temperature_2m) AS avg_temp, strftime(time, '%Y-%m') AS month FROM spilled_abc123 GROUP BY month ORDER BY month"
        },
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "Canvas ID returned by openmeteo_get_forecast, openmeteo_get_historical, openmeteo_get_marine, openmeteo_get_air_quality, openmeteo_get_ensemble, openmeteo_get_flood, or openmeteo_get_climate when truncated: true."
        }
    },
    "additionalProperties": false
}

openmeteo_dataframe_describe

List the tables and their columns on a DataCanvas staged by openmeteo get forecast, openmeteo get historical, openmeteo get marine, openmeteo get air quality, openmeteo get ensemble, openmeteo get flood, or openmeteo get climate. Call this first to discover table names before querying with openmeteo dataframe query.

Показать схему аргументов
{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "canvas_id"
    ],
    "properties": {
        "canvas_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{10}$",
            "description": "Canvas ID returned by openmeteo_get_forecast, openmeteo_get_historical, openmeteo_get_marine, openmeteo_get_air_quality, openmeteo_get_ensemble, openmeteo_get_flood, or openmeteo_get_climate when truncated: true."
        }
    },
    "additionalProperties": false
}