weatherapi-mcp

Official MCP (Model Context Protocol) server for WeatherAPI.com. Gives AI agents like Claude direct access to real-time weather, forecasts, historical data, astronomy, marine weather, air quality, and more.

Quick Start

# Run directly with npx (no install needed)
WEATHERAPI_KEY=your_api_key npx weatherapi-mcp

Get a free API key at weatherapi.com/signup.aspx

Setup in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "weatherapi": {
      "command": "npx",
      "args": ["-y", "weatherapi-mcp"],
      "env": {
        "WEATHERAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after editing.

Setup in Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "weatherapi": {
      "command": "npx",
      "args": ["-y", "weatherapi-mcp"],
      "env": {
        "WEATHERAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Tool	Description
`get_current_weather`	Real-time conditions — temp, wind, humidity, UV, pressure, AQI
`get_forecast`	Up to 14-day forecast with hourly breakdown and alerts
`get_history`	Historical weather from 1 Jan 2010 onwards
`get_future_weather`	Long-range forecast 14–300 days ahead (Pro+ plan)
`get_marine_weather`	Wave height, swell, tide data for coastal/ocean points
`get_astronomy`	Sunrise, sunset, moonrise, moon phase, illumination
`get_timezone`	IANA timezone and local time for any location
`search_locations`	Autocomplete city/town search with coordinates
`ip_lookup`	Geolocate an IP address or auto-detect caller's location
`get_alerts`	Government weather warnings (USA, UK, Europe, worldwide)
`get_sports`	Upcoming football, cricket, and golf events