AEMET MCP Server

MCP server for AEMET OpenData — the Spanish Meteorological Agency's weather API.

36 tools for forecasts, observations, alerts, climate data, radar, maritime, and more.

🤖 MCP Client  ◄──streamable-http──►  ⛅ AEMET MCP Server  ◄──►  🌤️ AEMET OpenData API

Quick start

1. Go to 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…):

{
  "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.

{
  "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