Summary
Plugs AEMET OpenData, the public API from Spain's State Meteorological Agency, directly into Claude or any MCP client over stdio. Exposes forecasts, CAP weather warnings, and live station observations from Spain's official weather network. Built on a production TypeScript SDK already running at snowy.es, so the underlying client is battle tested. Requires an AEMET API key. Reach for this when you need Spanish weather data in conversational tools or want to query conditions, alerts, or forecasts for Spanish locations without writing API integration code yourself. The monorepo includes both the MCP server and the standalone client library if you need programmatic access outside the MCP context.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →aemet-client monorepo
Tools for working with AEMET OpenData, the public API of Spain's State Meteorological Agency.
| Package | Description | npm |
|---|---|---|
aemet-client | Typed TypeScript SDK + CLI for AEMET OpenData. Used in production at snowy.es. |  |
aemet-mcp | Model Context Protocol server: plug AEMET into Claude Desktop, Cursor, Windsurf or any MCP client. Forecasts, warnings, live observations, climate history and beach forecasts. Runs locally over stdio. |  |
Quick links
- Just want to use AEMET from code? →
packages/aemet-client/README.md - Want your LLM to answer Spanish weather questions? →
packages/aemet-mcp/README.md - Spanish docs →
packages/aemet-client/README.es.md
Develop
Requires Node.js ≥ 20.18 and pnpm ≥ 10.
pnpm install
pnpm -r build
pnpm -r test
pnpm -r typecheck
pnpm lint
To work on a single package:
pnpm --filter aemet-client test
pnpm --filter aemet-mcp dev
The E2E suite (pnpm --filter aemet-client test:e2e) hits the real AEMET
API and is skipped unless AEMET_API_KEY is set. CI runs it behind a
repository secret.
Release
aemet-clientis released by pushing a tagv<x.y.z>oraemet-client-v<x.y.z>. The release workflow checks the tag matchespackages/aemet-client/package.jsonbefore publishing to npm via Trusted Publishing (OIDC, no token).aemet-mcpis released by pushing a tagaemet-mcp-v<x.y.z>using the same Trusted Publishing setup.pnpm publishrewrites theworkspace:^dependency onaemet-clientto a real semver range.
See CONTRIBUTING.md for development guidelines.
License
MIT © Jorge Carrera
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Configuration
AEMET_API_KEY*secretAEMET OpenData API key. Free at https://opendata.aemet.es/centrodedescargas/altaUsuario