Content
# AEMET MCP Server
MCP server for [AEMET OpenData](https://opendata.aemet.es) — the Spanish Meteorological Agency's weather API.
36 tools for forecasts, observations, alerts, climate data, radar, maritime, and more.
[](https://aemet-mcp.hgboronat.com)
```
🤖 MCP Client ◄──streamable-http──► ⛅ AEMET MCP Server ◄──► 🌤️ AEMET OpenData API
```
## Quick start
1. Go to **[aemet-mcp.hgboronat.com](https://aemet-mcp.hgboronat.com)** and enter your email
2. Copy the config shown on screen
3. Paste it into your MCP client settings
That's it. Your assistant now has access to all 36 weather tools.
> Available Monday–Friday, 9:00–18:00 CET. Token expires in 24 hours — request a new one anytime.
## Connection options
### Option A — Streamable HTTP (recommended)
For clients that support `streamable-http` with custom headers (Claude Desktop, Cursor, Kiro, VS Code…):
```json
{
"mcpServers": {
"aemet": {
"type": "streamable-http",
"url": "https://aemet.hgboronat.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
```
### Option B — STDIO bridge
For clients that only support STDIO transport. Requires [Node.js](https://nodejs.org).
```json
{
"mcpServers": {
"aemet": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://aemet.hgboronat.com/mcp",
"--header",
"Authorization:${AUTH_TOKEN}"
],
"env": {
"AUTH_TOKEN": "Bearer YOUR_TOKEN"
}
}
}
}
```
## Available tools (36)
### Forecasts
| Tool | Description |
|------|-------------|
| `get_hourly_forecast` | Hourly forecast (48h) for a municipality |
| `get_daily_forecast` | Daily forecast (7 days) for a municipality |
| `get_national_forecast` | National text weather forecast |
| `get_ccaa_forecast` | Forecast for an autonomous community |
| `get_province_forecast` | Provincial/insular text forecast |
| `get_beach_forecast` | Beach weather (waves, water temp, UV) |
| `get_mountain_forecast` | Mountain area weather forecast |
| `get_uv_index` | UV radiation index (0–4 days ahead) |
### Observations
| Tool | Description |
|------|-------------|
| `get_current_observations` | Real-time data from a specific station |
| `get_all_observations` | Real-time data from all stations |
### Alerts
| Tool | Description |
|------|-------------|
| `get_weather_alerts` | Current severe weather alerts by region |
| `get_alerts_archive` | Archived alerts for a date range (since 2018) |
### Climate data
| Tool | Description |
|------|-------------|
| `get_daily_climate_data` | Historical daily values for a station |
| `get_monthly_annual_climate` | Monthly/annual data over a year range |
| `get_climate_normals` | 30-year averages (1991–2020) |
| `get_extreme_values` | Extreme temperature, precipitation, or wind |
| `get_monthly_climate_summary` | National monthly summary document |
| `get_water_balance` | National water balance report |
### Maritime
| Tool | Description |
|------|-------------|
| `get_coastal_forecast` | Coastal maritime forecast |
| `get_high_seas_forecast` | High seas maritime forecast |
| `get_satellite_sst` | Sea surface temperature (satellite) |
### Radar & maps
| Tool | Description |
|------|-------------|
| `get_national_radar` | National radar composite image |
| `get_regional_radar` | Regional radar for a specific station |
| `get_lightning_map` | Latest lightning strike map |
| `get_analysis_maps` | Weather analysis maps |
| `get_fire_risk` | Current forest fire risk map |
| `get_fire_risk_forecast` | Forecast fire risk (1–7 days) |
### Environment
| Tool | Description |
|------|-------------|
| `get_radiation_data` | Solar radiation (global, direct, diffuse) |
| `get_ozone_data` | Total ozone content |
| `get_vegetation_index` | NDVI from satellite |
| `get_background_pollution` | Background air pollution |
| `get_snow_conditions` | Snow/avalanche conditions |
### Reference
| Tool | Description |
|------|-------------|
| `list_stations` | Full inventory of AEMET stations |
| `list_municipalities` | All Spanish municipality codes |
| `get_municipality_info` | Details for a specific municipality |
### Other
| Tool | Description |
|------|-------------|
| `get_antarctica_data` | Weather data from Antarctic stations |
## Example prompts
Once connected, try asking your assistant:
- *"What's the weather forecast for Madrid tomorrow?"*
- *"Are there any active weather alerts in Spain?"*
- *"What's the water temperature at Playa de la Concha?"*
- *"Show me Barcelona's climate data for last month"*
- *"Is there a forest fire risk in Andalucía?"*
- *"What's the UV index for today?"*
## License
MIT