Aemet MCP

Name: Aemet MCP
Author: jocarrd

jocarrd/aemet-client

1 repo stars
Updated August 2, 2026
jocarrd/aemet-client

AEMET MCP is a MCP server that exposes Spanish weather forecasts, CAP warnings, and station observations from AEMET OpenData.

About

AEMET MCP connects coding agents to Spain’s national meteorology OpenData: municipal forecasts, CAP-format warnings, and station observations. Developers shipping Spain-focused travel apps, logistics tools, or internal ops dashboards reach for it during Build integrations instead of hand-parsing AEMET REST responses. Run aemet-mcp over stdio with npx after obtaining a free AEMET_API_KEY from opendata.aemet.es. Claude Code, Cursor, Codex, and generic MCP clients can then query weather context while implementing features or drafting user-facing copy. Scope is geographic (Spain/AEMET); it is a data MCP server, not a global forecast aggregator. Version 0.1.2 lives in the aemet-client monorepo under packages/aemet-mcp.

Forecasts from Spain’s AEMET agency via MCP tools
CAP weather warnings for alert-aware automations
Station observation data for hyperlocal checks
Free AEMET_API_KEY from opendata.aemet.es registration
npm package aemet-mcp v0.1.2; monorepo jocarrd/aemet-client

Aemet MCP by the numbers

Data as of Aug 10, 2026 (Skillselion catalog sync)

terminal

claude mcp add --env AEMET_API_KEY=YOUR_AEMET_API_KEY aemet-mcp -- npx -y aemet-mcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.jocarrd/aemet-mcp.svg)](https://skillselion.com/mcp/tool/io.github.jocarrd/aemet-mcp)

repo stars	★ 1
Package	aemet-mcp
Transport	STDIO
Auth	Required
Last updated	August 2, 2026
Repository	jocarrd/aemet-client ↗

What it does

Pull Spanish AEMET forecasts, CAP warnings, and station observations into agent workflows through a stdio MCP server.

Who is it for?

Best when you're building Spain-specific products or automations that need official AEMET data inside the agent loop.

Skip if: Global-only apps that require worldwide providers without AEMET coverage or teams avoiding third-party government API keys.

What you get

Your agent reads AEMET-backed forecast, warning, and observation tools through one stdio MCP server and API key.

stdio MCP server linked to AEMET OpenData
Agent tools for forecasts, warnings, and observations
AEMET_API_KEY configured as required secret env

By the numbers

Package aemet-mcp version 0.1.1 in readme snippet shows 0.1.2 in registry entry; transport stdio
Required secret env: AEMET_API_KEY (free AEMET OpenData registration)
Repository: github.com/jocarrd/aemet-client subfolder packages/aemet-mcp

README.md

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-client is released by pushing a tag v<x.y.z> or aemet-client-v<x.y.z>. The release workflow checks the tag matches packages/aemet-client/package.json before publishing to npm via Trusted Publishing (OIDC, no token).
aemet-mcp is released by pushing a tag aemet-mcp-v<x.y.z> using the same Trusted Publishing setup. pnpm publish rewrites the workspace:^ dependency on aemet-client to a real semver range.