---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/weather-forecast
---
# Weather Forecast

Comprehensive weather data for any city or coordinates: current conditions, multi-day forecasts, UV index, air quality, pollen counts, and pollutant breakdowns. For travel planning, outdoor events, health apps, and agriculture.

- **Version:** 0.05
- **Categories:** data

## Skills (3)

### Current Weather (`current_weather`)

Current conditions in one call: temperature, wind, humidity, precipitation, snowfall, UV index, AQI (US + EU), pollen, visibility, dew point, and more. Accepts city name or coordinates.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | City name or lat,lon coordinates (e.g. "London" or "51.5,-0.12") |
| `units` | string | No | Unit system for temperature and wind speed ("metric" or "imperial") (metric, imperial) [default: "metric"] |

**Returns:** Comprehensive current conditions with UV index, air quality (US + EU AQI), pollen counts, visibility, dew point, snowfall, and daylight duration

**Examples:**

*Current weather in London:*

```json
{
  "location": "London"
}
```

### Weather Forecast (`forecast`)

Get a multi-day weather forecast for any location. Returns daily high/low temperatures, rain/snowfall breakdown, precipitation hours and probability, wind with compass direction, UV index with category, sunshine/daylight duration, solar radiation, and sunrise/sunset for up to 16 days.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | City name or lat,lon coordinates (e.g. "Tokyo" or "35.68,139.69") |
| `days` | number | No | Number of forecast days (1-16, default 7) [default: 7] |
| `units` | string | No | Unit system for temperature and wind speed ("metric" or "imperial") (metric, imperial) [default: "metric"] |

**Returns:** Daily forecast with temperatures, rain/snowfall, precipitation hours, wind direction, UV index, sunshine duration, solar radiation, and sunrise/sunset

**Examples:**

*5-day forecast for Tokyo:*

```json
{
  "location": "Tokyo",
  "days": 5
}
```

### Air Quality (`air_quality`)

Get detailed air quality, pollen, and UV data for any location. Returns US and European AQI, PM2.5, PM10, gas concentrations (ozone, NO2, SO2, CO), dust, aerosol depth, UV index, and pollen counts for 6 species with severity.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | City name or lat,lon coordinates (e.g. "Beijing" or "39.9,116.4") |

**Returns:** Air quality indices (US + EU), pollutants, dust, aerosol depth, UV index, and pollen counts for 6 species with severity categories

**Examples:**

*Air quality in Beijing:*

```json
{
  "location": "Beijing"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call weather-forecast current_weather --location London

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"weather-forecast","skill":"current_weather","input":{"location":"London"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I use coordinates instead of city names?

Yes. It works with both city names and latitude and longitude coordinates.

### Does it include health and outdoor planning signals?

Yes. UV index, air quality, pollen counts, and pollutant breakdowns are included.

### How far ahead can I plan?

It provides current conditions plus multi-day forecasts.

### Can I set a default location?

Yes. Latitude and longitude can be stored as defaults for repeated weather checks.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs