io.github.jocarrdPublished by GitHub account jocarrdv0.3.3Updated Oct 29, 2026
MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.
Local MCP server that gives an assistant Spain's official AEMET weather forecasts, warnings, observations, climate history, beach, mountain, maritime and…
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
A Model Context Protocol server that lets LLM clients — Claude Desktop, Cursor, Windsurf, Zed, custom agents — answer questions about Spain's weather using real data from AEMET, the State Meteorological Agency.
Versión en español · Servidor MCP con ocho herramientas sobre los datos abiertos de AEMET. Requiere Node.js 20.19 o superior.
Built on top of aemet-client,
the same TypeScript SDK that powers snowy.es.
Runs locally over stdio — no hosted infrastructure, no shared API key. Every user supplies their own free AEMET key.
Free, takes about a minute:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS
or %APPDATA%\Claude\claude_desktop_config.json on Windows and add:
Restart Claude Desktop and ask: "What's the weather forecast for Madrid this week?", "Are there any active weather warnings in Catalonia right now?", "How much did it rain in Logroño last August?" or "What's the water temperature at La Concha?".
Same config object — every MCP-capable client accepts the
{ command, args, env } shape. See their docs for where the config file lives.
get_forecastAEMET's official forecast for any of Spain's 8000+ municipalities.
get_warningsActive CAP (Common Alerting Protocol) warnings for an autonomous community or the whole country.
get_nearest_observationLatest real-time observation (temperature, humidity, wind, precipitation, pressure, visibility) from the AEMET station closest to a location.
get_climate_historyHistorical climate data from the AEMET station closest to a location: either daily records over a date range or the station's long-term monthly normals.
AEMET caps daily climate queries at 186 days per request, so longer ranges are rejected with a message explaining it. Ranges over a month come back aggregated by month (mean max/min, extremes, total precipitation, rain days) instead of one line per day.
get_beach_forecastThree-day forecast for any of the 591 beaches AEMET covers during the bathing season: sky, wind and waves split into morning and afternoon, plus maximum temperature, water temperature, thermal sensation and UV index.
Names resolve without accents and tolerate how people actually write them
("la kontxa", "playa de la concha, suances"). When a name matches more than
one beach, the server answers with the candidates and their codes. Outside the
bathing season AEMET stops publishing and the tool says so.
get_mountain_forecastAEMET's mountain bulletin for the nine areas it covers: the forecast by section, freezing-level altitudes, free-atmosphere winds, and temperatures at named refuges and passes with their altitude. Also serves the last 24 hours.
Common aliases work: "Guadarrama", "Moncayo", "Urbión", "Peñibética",
"Val d'Aran", "Gredos".
get_maritime_forecastAEMET's marine bulletins: coastal waters (8 areas) and high seas (3 areas), with warnings, the synoptic situation, the forecast per zone and the trend for the following day.
AEMET writes wind, sea state and visibility as a single text per zone, so the tool passes that text through rather than splitting it with guesswork.
get_air_qualityBackground pollution from AEMET's rural EMEP/VAG/CAMP reference network: regional background air, not urban air quality.
Measurements carry AEMET's validation codes, and values flagged as invalid are labelled so a model does not quote them as real readings.
AEMET rate-limits its API and some responses are heavy: the station inventory alone is 926 entries, and the server reads it on every climate query. Responses are therefore cached in memory for 10 minutes by default, per endpoint.
Set AEMET_CACHE_TTL in the same env block as the API key to change it, in
seconds, or to 0 to turn caching off:
The cache lives in the server process, so it disappears when your MCP client
closes it. Pass your own cache adapter through clientConfig if you need
something shared or persistent.
If you're building your own MCP integration, the server is also exposed as a library:
You can pass an existing AemetClient (for example one wired to a Redis cache)
instead of an API key:
location accepts free-form names because the package embeds the full INE
municipality dataset (8000+ entries) shipped by aemet-client. Searching for
"logrono", "Logroño" or "26089" all resolve to the same place. Decimal
coordinates resolve to the nearest municipality.
For autonomous communities, common aliases work: "Cataluña", "catalunya",
"Catalonia", "Euskadi", "País Vasco", "Comunitat Valenciana", etc.
MIT © Jorge Carrera
Source: packages/aemet-mcp/README.md at commit 279faac
Weather forecast for a Spanish municipality
Returns the AEMET forecast for any of Spain's 8000+ municipalities. Accepts a name (with or without accents) or INE code. Daily granularity returns temperature min/max, sky state, precipitation probability and wind for each day. Hourly returns the next ~40h.
dayslocationrequiredgranularityActive CAP weather warnings for a Spanish region
Returns the most recent CAP (Common Alerting Protocol) weather warnings issued by AEMET for the given autonomous community, or for the whole country ('esp'). Severity follows the CAP standard: Minor, Moderate, Severe, Extreme.
arearequiredlanguageminSeverityLatest real-time observation from the nearest AEMET weather station
Finds the AEMET weather station closest to the requested location and returns its most recent reading (temperature, humidity, wind, precipitation, pressure). Useful for 'what's the weather right now' style questions.
locationrequiredHistorical climate records from the nearest AEMET climatological station
Finds the AEMET climatological station closest to the requested location and returns its measured history. mode='range' returns daily records (temperature, precipitation, wind, humidity, sunshine) between two dates; AEMET serves at most 6 months (186 days) per call, so longer histories need several calls. Ranges longer than 31 days are condensed into one line per month (mean max/min, total precipitation, rainy days, extremes) instead of one line per day. mode='normals' returns the station's long-term monthly averages. Use this for past weather and climate questions, not for forecasts.
tofrommodelocationrequiredBeach forecast for a Spanish beach
Returns the AEMET beach forecast for the next three days: sky, wind and waves for morning and afternoon, plus maximum temperature, water temperature, thermal sensation and maximum UV index. Covers the 591 beaches AEMET forecasts during the bathing season. Accepts a beach name (accents optional), optionally narrowed by municipality, or the 7-digit AEMET beach code.
dayslocationrequiredmunicipalityMountain bulletin for a Spanish mountain area
Returns the AEMET mountain bulletin for one of Spain's nine mountain areas (Picos de Europa, the three Pyrenean areas, the two Iberian System areas, Guadarrama and Somosierra, Sierra de Gredos, Sierra Nevada). Written for mountaineers and skiers: sky state, precipitation, storms, temperature and wind as forecaster prose, plus the freezing and -10 °C levels, free-atmosphere winds at 1500 and 3000 m, and minimum and maximum temperatures with thermal sensation at named refuges, passes and resorts. mode='forecast' covers today (day 0) to day 3; mode='past' summarises the last 24 hours. These bulletins are year-round and cover the mountain range as a whole, so use them instead of get_forecast for anything above the valley floor.
dayarearequiredmodeMaritime forecast for Spanish coastal waters and high seas
Returns the AEMET maritime bulletin for a sea area: sea state, wind, visibility, warnings and the validity period. Two products are covered: coastal waters (8 bulletins, one per stretch of the Spanish coast, each split into per-province zones and carrying the marine warnings) and high seas (3 bulletins covering the Atlantic north of 30N, the Atlantic south of 35N and the Mediterranean). Areas can be named the way people and the media name them, or given as AEMET codes.
arearequiredproductBackground air pollution at an AEMET EMEP/VAG rural station
Returns the latest reading of AEMET's background pollution network (EMEP/VAG/CAMP): 13 rural reference stations that measure the regional baseline of O3, NO, NO2, SO2 and PM10, plus temperature, humidity, pressure, wind, radiation and precipitation. This is BACKGROUND pollution, measured far from towns and roads on purpose. It does NOT answer 'how is the air in Madrid/Barcelona today': urban air quality is measured by the city and regional networks, not by AEMET, and this tool must not be used as a proxy for it.
stationlocation90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
{ "mcpServers": { "aemet": { "command": "npx", "args": ["-y", "aemet-mcp"], "env": { "AEMET_API_KEY": "paste-your-key-here" } } }}"env": { "AEMET_API_KEY": "paste-your-key-here", "AEMET_CACHE_TTL": "1800"}import { createServer } from "aemet-mcp";import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const { server } = createServer({ apiKey: process.env.AEMET_API_KEY });await server.connect(new StdioServerTransport());import { AemetClient } from "aemet-client";import { createServer } from "aemet-mcp";
const client = new AemetClient({ apiKey, cache: { adapter: redisAdapter } });const { server } = createServer({ client });