openapi-mcp-server/docs/weather.md
Tom Foster 6db4ea8e96
All checks were successful
CI / Build and push Docker image (push) Successful in 1m29s
Initial commit
2025-06-16 19:17:09 +01:00

1.9 KiB

Weather Tool

A weather information tool that provides real-time weather data and forecasts using the Open-Meteo API.

Overview

The Weather tool provides weather information services within the OpenAPI MCP Server framework. It offers current weather conditions and hourly forecasts based on geographic coordinates using the reliable Open-Meteo weather API.

Endpoints

Method Endpoint Description
GET /weather/forecast Get current weather conditions and hourly forecast by coordinates. Requires latitude and longitude parameters. Temperature unit (Celsius/Fahrenheit) is automatically determined based on location.

Key Features

  • Real-time Weather: Current temperature and wind speed conditions
  • Hourly Forecasts: Detailed hourly weather data including temperature, humidity, and wind speed
  • Smart Units: Automatic temperature unit selection (Fahrenheit for US/Liberia/Myanmar, Celsius elsewhere)
  • Geographic Accuracy: Location-based weather using precise latitude/longitude coordinates
  • Timezone Aware: Weather data includes proper timezone information
  • Reliable Source: Uses Open-Meteo API for accurate, up-to-date weather information

Data Structure

Weather responses include:

  • Current conditions: Real-time temperature and wind speed
  • Hourly forecasts: Temperature, relative humidity, and wind speed by hour
  • Location metadata: Coordinates, timezone, and regional information
  • Units: Clear indication of temperature and measurement units

Usage

The Weather tool is automatically loaded by the OpenAPI MCP Server framework. The forecast endpoint is available at /weather/forecast and requires latitude and longitude query parameters. Visit /docs for interactive API documentation.

Data Source

Powered by the Open-Meteo API (https://open-meteo.com), providing reliable and free weather data without requiring API keys.