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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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. 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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
AEMET_API_KEY*secretAEMET OpenData API key. Free at https://opendata.aemet.es/centrodedescargas/altaUsuario