Meteoprog API MCP Server Full Reference | Tools and Methods

This is the complete method reference for the Meteoprog API MCP Server. Use the short guide for setup and practical examples; use this page when an MCP client needs to choose a specific tool or understand the complete server surface.

Smart tools

Connection and authentication

MCP endpoint: https://api.meteoprog.com/mcp. An API key is required. The client must send it as a Bearer token when establishing the remote MCP connection; never put the key in a prompt or tool arguments.

[mcp_servers.meteoprog]
url = "https://api.meteoprog.com/mcp/"
bearer_token_env_var = "METEOPROG_API_KEY"

Developer Access can be used for testing. It provides 5,000 requests per day, 5 RPS, and a fixed showcase of Brisbane, Malaga, Oujda, Santiago, Amarillo, Cuttack, Espoo, Himeji, Samut Prakan, and Aktobe. Production plans provide broader coverage and higher limits.

Smart tools — recommended entry point

Smart tools resolve locations, select the appropriate upstream operation, reduce large responses to useful summaries, and expose data availability and usage information.

Tool	Purpose
`get_weather`	Current weather and forecasts with automatic location and range routing.
`compare_weather`	Compare 2–10 locations using the same date, hour, or time period.
`resolve_location`	Resolve a city name, URL slug, or coordinates to a canonical Meteoprog city and ID.
`get_weather_alerts`	Compact active alerts by city, coordinates, country, alert ID, or global risk summary.
`explain_weather_alert`	Explain why an active alert may differ from current conditions or the hourly forecast.
`get_air_quality`	Five-day AQI and pollutant summary with the worst period.
`get_astronomy`	Sunrise, sunset, daylight, Moon rise/set, illumination, and phase.
`get_climate_history`	Historical extremes and climate summaries by day, month, or complete year history.
`get_geomagnetic_activity`	Current, short-term, and daily Kp/G-index observations and forecasts.
`get_water_temperature`	Filtered water-temperature search by city, resort, region, or country.
`get_supported_languages`	Supported locales, ISO codes, language names, and aliases.
`get_service_status`	Current Meteoprog service availability and component status.
`get_mcp_info`	Connected server version, capabilities, policies, and usage metadata.

Weather forecast methods — 18 tools

By Meteoprog city ID

Tool	Purpose
`getForecastCurrentByCityId`	Current conditions for a city ID.
`getForecastTodayByCityId`	Today's forecast for a city ID.
`getForecastYesterdayByCityId`	Yesterday's weather for a city ID.
`getForecastWeekByCityId`	Seven-day forecast for a city ID.
`getForecastTwoWeekByCityId`	Two-week forecast for a city ID.

By city name

Tool	Purpose
`getForecastCurrentByCityName`	Current conditions for a city name.
`getForecastTodayByCityName`	Today's forecast for a city name.
`getForecastYesterdayByCityName`	Yesterday's weather for a city name.
`getForecastWeekByCityName`	Seven-day forecast for a city name.
`getForecastTwoWeekByCityName`	Two-week forecast for a city name.

By coordinates

Tool	Purpose
`getForecastCurrentByCoordinates`	Current conditions for longitude and latitude.
`getForecastTodayByCoordinates`	Today's forecast for coordinates.
`getForecastYesterdayByCoordinates`	Yesterday's weather for coordinates.
`getForecastWeekByCoordinates`	Seven-day forecast for coordinates.
`getForecastTwoWeekByCoordinates`	Two-week forecast for coordinates.

Monthly models

Tool	Purpose
`getForecastCalendarByCityId`	Rolling 30-day calendar forecast.
`getForecastCalendarMonthByCityIdMonth`	Calendar view for a selected month.
`getForecastMonthByCityIdMonth`	Monthly model for a city and month.

Monthly model values are daily summaries, not exact hourly forecasts for every day of the month.

Astronomy and air quality

Astronomy — 6 tools

Tool	Purpose
`getAstronomyByCityAndDate`	Astronomy data for an exact date.
`getAstronomyDateIntervalByCityId`	Astronomy data for a custom date interval.
`getAstronomyTodayByCityId`	Today's astronomy data.
`getAstronomyYesterdayByCityId`	Yesterday's astronomy data.
`getAstronomyWeekByCityId`	Seven-day astronomy data.
`getAstronomyTwoWeekByCityId`	Two-week astronomy data.

Air quality — 1 tool

Tool	Purpose
`getAqiByCityId`	AQI and pollutant data for a Meteoprog city ID.

Climate history and geomagnetic activity

Climate archive and statistics — 5 tools

Tool	Purpose
`getArchiveDataByCityIdMonth`	Daily historical data for a city and month across different years.
`getArchiveDataByCityIdDayMonth`	Historical data for a specific day and month.
`getArchiveStatisticsByCityIdMonth`	Monthly historical extremes for a city.
`getArchiveStatisticsByCityIdDayMonth`	Historical extremes for a specific day and month.
`getArchiveStatisticsWorldByDayMonth`	Global historical extremes for a calendar day.

Geomagnetic activity — 3 tools

Tool	Purpose
`getKIndexCurrent`	Current and recent K-index values and forecast.
`getKIndexForecast`	Detailed short-term K-index forecast and history.
`getKIndexForecastDaily`	Longer-range daily K-index forecast.

Geographic reference and water temperature

Geographic reference and city search — 12 tools

Tool	Purpose
`getLocales`	List API locales.
`getTimezones`	List time zones and database version.
`getContinents`	List continents.
`getCountries`	List countries.
`getCountriesByContinentId`	List countries within a continent.
`getRegionsByCountryId`	List regions within a country.
`getCitiesByCountryIdPage`	Paginated list of cities in a country.
`getCitiesByRegionIdPage`	Paginated list of cities in a region.
`searchCityByName`	Search populated places by name.
`searchCityByUrl`	Search for a city by URL slug.
`searchCityByCoordinates`	Search for populated places near coordinates.
`searchCityByCoordinatesWithDistance`	Search near coordinates within a custom radius.

Water temperature — 1 tool

Tool	Purpose
`getWaterCurrentByPage`	Retrieve a full paginated list of current water temperatures.

Weather alerts — 6 tools

Use get_weather_alerts for normal alert questions. These lower-level tools are for geometry, complete source data, historical lookup, and raw CAP payloads.

Tool	Purpose
`get_active_weather_alert_countries`	Active alert counts and aggregate risk by country.
`get_active_weather_alerts_by_country`	All active alerts for an ISO alpha-2 country, including available geometry.
`get_active_weather_alerts_by_city`	Active alerts affecting a Meteoprog city ID.
`get_active_weather_alerts_by_coordinates`	Active alerts covering a longitude/latitude point.
`get_weather_alert_by_id`	Retrieve an active or historical alert by ID.
`get_raw_weather_alert_by_id`	Retrieve the original CAP alert as JSON.

Which method should an MCP client choose?

Use get_weather for current weather, a date, an hour, a time period, a week, two weeks, or a month.
Use resolve_location when the city name is ambiguous or a canonical city ID is needed for repeated calls.
Use compare_weather for 2–10 locations with comparable parameters.
Use get_weather_alerts for compact active warnings; use the alert methods above only when geometry or raw CAP is explicitly required.
Use smart tools for normal user questions and low-level methods for exact endpoints, complete raw responses, debugging, historical archives, or advanced integrations.

Each upstream request is accounted for separately. The server does not cache weather responses. Operations that may require more than 100 upstream API requests require user confirmation.

Meteoprog API MCP Server Full Reference: Tools and Methods