# world-weather-online-mcp

World Weather Online MCP Server gives AI agents direct access to one of the world's most comprehensive weather APIs — trusted by 300,000+ developers and used by major airlines and airports worldwide.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add info-iywv/world-weather-online-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list info-iywv/world-weather-online-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get info-iywv/world-weather-online-mcp get_weather

# Call a tool
npx -y @smithery/cli@latest tool call info-iywv/world-weather-online-mcp get_weather '{}'
```

## Direct MCP Connection

Endpoint: `https://world-weather-online-mcp--info-iywv.run.tools`

**Required config:**
- `key` (query) — Requires a free World Weather Online API key. Sign up at worldweatheronline.com/weather-api/

## Tools (8)

- `get_weather` — Get current weather and up to 14-day forecast for any location. Includes temperature, wind, precipitation, humidity, UV…
- `get_historical_weather` — Get historical weather for any location from July 2008 onwards. Up to 30-day date ranges with hourly breakdowns.
- `get_marine_weather` — Get 7-day marine forecasts: swell height, direction, period, water temperature, and tides.
- `get_ski_weather` — Get ski resort forecasts with top, mid, and base elevation breakdowns.
- `search_location` — Autocomplete and search location names. Returns coordinates, country, and region.
- `get_astronomy` — Get sunrise, sunset, moonrise, moonset, moon phase, and moon illumination for any location and date.
- `get_timezone` — Get local time, timezone name, and UTC offset for any location worldwide.
- `get_climate_averages` — Get monthly climate averages (12-year average): min/max temperatures, rainfall, snow days, fog days, UV index. Ideal fo…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get info-iywv/world-weather-online-mcp <tool-name>
```