English Français العربية

io.github.jocarrd/aemet-mcp

Official registry Other

MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package aemet-mcp
Claude Code 
claude mcp add aemet-mcp -e 'AEMET_API_KEY=<your aemet_api_key>' -- npx -y aemet-mcp@0.3.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aemet-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "aemet-mcp@0.3.3"
            ],
            "env": {
                "AEMET_API_KEY": "<your aemet_api_key>"
            }
        }
    }
}

Environment variables

  • AEMET_API_KEY required secret AEMET OpenData API key. Free at https://opendata.aemet.es/centrodedescargas/altaUsuario

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. aemet-client monorepo
  2. Quick links
  3. Develop
  4. Release
  5. License

aemet-client monorepo

Tools for working with AEMET OpenData, the public API of Spain's State Meteorological Agency.

PackageDescriptionnpm
aemet-clientTyped TypeScript SDK + CLI for AEMET OpenData. Used in production at snowy.es.
aemet-mcpModel 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.

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.

See CONTRIBUTING.md for development guidelines.

License

MIT © Jorge Carrera

Frequently asked questions

What is io.github.jocarrd/aemet-mcp?

MCP server for AEMET: Spain's official forecasts, warnings, observations and climate data.

How do I install io.github.jocarrd/aemet-mcp?

It runs on your machine. In Claude Code: claude mcp add aemet-mcp -e 'AEMET_API_KEY=<your aemet_api_key>' -- npx -y aemet-mcp@0.3.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.jocarrd/aemet-mcp need an API key?

Yes. It expects AEMET_API_KEY, which you set in its configuration.

Is io.github.jocarrd/aemet-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.jocarrd/aemet-mcp?

It is published by jocarrd. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.